| # CLI 命令系统 |
|
|
| ## 架构概述 |
|
|
| ### 入口 |
|
|
| CLI 入口由 **Commander.js** 解析命令行参数，随后启动 **REPL**（交互式循环）。REPL 负责接收用户输入、解析斜杠命令、调用对应的处理函数。 |
|
|
| ### 命令注册 |
|
|
| 命令通过 **6 种来源** 注册到系统： |
|
|
| | 来源 | 说明 | 注册位置 | |
| |------|------|----------| |
| | **内置命令** | `COMMANDS()` 函数返回的核心命令列表 | `src/commands.ts:261-354` | |
| | **内置技能** | 随 CLI 打包的 Markdown 技能文件 | `getBundledSkills()` | |
| | **内置插件** | 内置插件导出的技能命令 | `getBuiltinPluginSkillCommands()` | |
| | **用户技能目录** | 用户自定义的 Markdown 技能文件 | `getSkillDirCommands()` | |
| | **工作流** | 多步骤脚本工作流 | `getWorkflowCommands()` | |
| | **市场插件** | 从插件市场安装的外部插件 | `getPluginCommands()`, `getPluginSkills()` | |
|
|
| ### 命令过滤 |
|
|
| `getCommands()` 是命令的最终汇聚函数，执行以下过滤： |
|
|
| 1. **availability 检查**：`meetsAvailabilityRequirement()` — 验证当前用户是否有权限（如 claude.ai 订阅者、Console API 用户） |
| 2. **isEnabled 检查**：`isCommandEnabled()` — feature flag 控制是否启用 |
| 3. **去重**：内置命令与动态技能（`getDynamicSkills()`）间去重，内置命令优先 |
| 4. **动态技能插入**：在插件命令之后、内置命令之前插入 |
|
|
| ### 远程模式过滤 |
|
|
| `REMOTE_SAFE_COMMANDS` 集合定义了可在 `--remote` 模式下安全使用的命令（仅影响本地 TUI 状态）。 |
|
|
| `BRIDGE_SAFE_COMMANDS` 和 `isBridgeSafeCommand()` 定义了可通过 Remote Control bridge（移动端/web 客户端）执行的命令。 |
|
|
| --- |
|
|
| ## 内置命令详表 |
|
|
| 以下为 `COMMANDS()` 中注册的所有内置命令，按功能分组： |
|
|
| ### 导航与信息 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/help` | - | 显示帮助信息，列出所有可用命令 | |
| | `/clear` | - | 清屏，重置终端显示 | |
| | `/exit` | - | 退出 CLI | |
| | `/init` | - | 在项目中初始化 Claude Code 配置文件 | |
| | `/resume` | - | 恢复之前的会话 | |
| | `/status` | - | 显示当前会话状态 | |
| | `/stats` | - | 统计信息和指标 | |
|
|
| ### 配置管理 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/config` | - | 系统设置管理（theme, model, permissions 等） | |
| | `/model` | - | 切换 AI 模型 | |
| | `/theme` | - | 切换终端主题 | |
| | `/color` | - | 更改 AI 回复颜色 | |
| | `/permissions` | - | 权限模式管理 | |
| | `/privacySettings` | - | 隐私设置 | |
| | `/outputStyle` | - | 输出风格切换 | |
| | `/statusline` | - | 状态行开关 | |
| | `/effort` | - | 设置思考/推理投入度 | |
| | `/fast` | - | 快速模式切换 | |
| | `/env` | ant 内部 | 环境变量管理 | |
| | `/remoteEnv` | - | 远程环境变量管理 | |
| | `/passes` | - | 管理预设的 always-allow/always-deny 规则 | |
|
|
| ### 会话管理 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/session` | - | 会话管理（分享、导出、查看记录） | |
| | `/cost` | - | 显示当前会话费用 | |
| | `/usage` | - | 显示 API 用量 | |
| | `/compact` | - | 压缩上下文，减少 token 消耗 | |
| | `/copy` | - | 复制最后一条消息 | |
| | `/rename` | - | 重命名当前会话 | |
| | `/tag` | - | 为会话添加标签 | |
| | `/btw` | - | 快速记笔记，补充上下文 | |
| | `/rewind` | - | 回滚到之前的对话状态 | |
|
|
| ### 工具与技能 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/skills` | - | 管理技能（列出、启用、禁用） | |
| | `/mcp` | - | MCP 服务器管理（添加、连接、查看） | |
| | `/plugin` | - | 插件管理 | |
| | `/reloadPlugins` | - | 重新加载所有插件 | |
| | `/hooks` | - | 钩子系统管理 | |
| | `/keys` / `/keybindings` | - | 快捷键管理 | |
| | `/add-dir` | - | 添加技能目录 | |
| | `/terminalSetup` | - | 终端设置工具 | |
|
|
| ### 语音与 Friend |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/voice` | feature 控制 | 语音听写模式 | |
| | `/friend` | - | Friend 虚拟宠物管理 | |
| | `/thinkback` | - | Thinkback 回放 | |
| | `/thinkbackPlay` | - | Thinkback 播放控制 | |
|
|
| ### Goal 与规划 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/goal` / `/goals` | - | 目标管理（创建、查看、更新） | |
| | `/plan` | - | 规划模式切换 | |
| | `/ultraplan` | feature 控制 | 高级规划模式 | |
| | `/agent` / `/agents` | - | 代理管理（列出、配置） | |
| | `/tasks` | - | 后台任务管理 | |
|
|
| ### Git 与文件 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/diff` | - | 显示 Git diff | |
| | `/branch` | - | 分支管理 | |
| | `/files` | - | 显示会话中跟踪的文件 | |
| | `/commit` | ant 内部 | 创建 Git 提交 | |
| | `/commit-push-pr` | ant 内部 | 提交、推送、创建 PR | |
| | `/fork` | feature 控制 | Fork 子代理 | |
| | `/buddy` | feature 控制 | 协作编程伙伴 | |
|
|
| ### 集成与外部服务 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/login` | - | 登录（非 3P 用户） | |
| | `/logout` | - | 登出 | |
| | `/feishu` | - | 飞书集成 | |
| | `/telegram` | - | Telegram 集成 | |
| | `/desktop` | - | 桌面应用模式 | |
| | `/mobile` | - | 移动端二维码 | |
| | `/install-github-app` | - | 安装 GitHub App | |
| | `/install-slack-app` | - | 安装 Slack App | |
| | `/bridge` | feature 控制 | 桥接模式 | |
| | `/peers` | feature 控制 | UDS 对等节点管理 | |
| | `/subscribe-pr` | feature 控制 | 订阅 PR 通知 | |
|
|
| ### 诊断与开发 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/doctor` | - | 系统诊断，检查配置和依赖 | |
| | `/upgrade` | - | 升级 CLI 版本 | |
| | `/version` | ant 内部 | 显示版本信息 | |
| | `/heapdump` | - | 堆转储（调试用） | |
| | `/sandbox-toggle` | - | 沙箱模式开关 | |
| | `/debug-tool-call` | ant 内部 | 调试工具调用 | |
| | `/perf-issue` | ant 内部 | 性能问题报告 | |
| | `/ant-trace` | ant 内部 | Ant 追踪 | |
| | `/oauth-refresh` | ant 内部 | OAuth token 刷新 | |
| | `/color` | - | 更改 AI 颜色 | |
| | `/stickers` | - | 贴纸管理 | |
|
|
| ### 反馈与分析 |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/feedback` | - | 发送反馈 | |
| | `/review` | - | 代码审查 | |
| | `/ultrareview` | - | 深度代码审查 | |
| | `/security-review` | - | 安全审查 | |
| | `/insights` | - | 会话分析报告 | |
| | `/extra-usage` | - | 额外用量显示 | |
| | `/rate-limit-options` | - | 速率限制选项 | |
| | `/summary` | ant 内部 | 会话摘要生成 | |
| | `/share` | ant 内部 | 分享会话 | |
| | `/release-notes` | - | 版本发布说明 | |
| | `/cost` | - | 会话费用 | |
| | `/usage` | - | 使用情况 | |
|
|
| ### 实验性 & Feature-gated |
|
|
| | 命令 | 别名 | 描述 | |
| |------|------|------| |
| | `/proactive` | feature 控制 | 主动模式 | |
| | `/brief` | feature 控制 | 简报模式 | |
| | `/assistant` | feature 控制 | 助手模式 | |
| | `/torch` | feature 控制 | Torch 调试工具 | |
| | `/web` / `/remote-setup` | feature 控制 | 远程设置 | |
| | `/workflows` | feature 控制 | 工作流管理 | |
| | `/force-snip` | feature 控制 | 强制截断上下文 | |
| | `/remoteControlServer` | feature 控制 | 远程控制服务器 | |
| | `/buddy` | feature 控制 | 编程伙伴 | |
| | `/agents-platform` | ant 内部 | 代理平台管理 | |
| | `/bughunter` | ant 内部 | Bug 猎人工具 | |
| | `/autofix-pr` | ant 内部 | 自动修复 PR | |
| | `/backfill-sessions` | ant 内部 | 回填会话数据 | |
| | `/issue` | ant 内部 | 问题管理 | |
| | `/onboarding` | ant 内部 | 引导流程 | |
| | `/teleport` | ant 内部 | 远程会话跳转 | |
| | `/good-claude` | ant 内部 | 内部工具 | |
| | `/ctx_viz` | ant 内部 | 上下文可视化 | |
| | `/mock-limits` | ant 内部 | Mock 限制测试 | |
| | `/bridge-kick` | ant 内部 | 桥接踢出 | |
| | `/reset-limits` | ant 内部 | 重置限制 | |
|
|
| --- |
|
|
| ## Skill 系统 |
|
|
| 技能（Skills）是以 Markdown 文件形式定义的提示词模板，可被 LLM 或用户调用。技能系统分为： |
|
|
| - **打包技能（Bundled Skills）**：随 CLI 发布的内置 `.md` 文件 |
| - **用户技能目录（Skill Dir Commands）**：用户在工作区 `./claude/skills/` 或全局 `~/.claude/skills/` 中定义的技能 |
| - **插件技能（Plugin Skills）**：从插件加载的技能 |
| - **MCP 技能**：通过 MCP 协议提供的技能（`getMcpSkillCommands()`） |
|
|
| 技能文件的 YAML frontmatter 定义 `name`、`description`、`model` 等属性，正文为发送给 LLM 的提示词。 |
|
|
| ### 技能相关工具 |
|
|
| - `SkillTool`：AI 可调用的技能执行工具 |
| - `getSkillToolCommands()`：获取所有可被模型调用的 prompt 类型命令 |
| - `getSlashCommandToolSkills()`：获取斜杠命令可用的技能列表 |
|
|
| --- |
|
|
| ## 工作流系统 |
|
|
| 工作流（Workflows）是通过 `WorkflowTool` 实现的多步骤脚本，支持： |
|
|
| - 顺序执行多个步骤 |
| - 条件分支 |
| - 变量传递 |
| - 用户确认点 |
|
|
| 当 `WORKFLOW_SCRIPTS` feature flag 启用时，工作流命令通过 `createWorkflowCommand()` 注册。 |
|
|
| --- |
|
|
| ## 命令类型 |
|
|
| `Command` 类型包括三种变体： |
|
|
| | 类型 | 说明 | |
| |------|------| |
| | `prompt` | 扩展为提示词发送给模型（技能、工作流） | |
| | `local` | 本地执行，输出纯文本 | |
| | `local-jsx` | 本地执行，渲染 Ink UI 组件 | |
|
|
| --- |
|
|
| ## 配置管理 |
|
|
| `/config` 命令管理系统设置。配置值存储在： |
|
|
| - **用户设置**：`~/.claude/settings.json` |
| - **项目设置**：`.claude/settings.json`（项目级覆盖） |
| - **会话设置**：仅当前会话有效 |
|
|
| 支持的配置项包括 theme、model、permissions（权限模式）、音效、通知等。 |
|
|
| 相关文件： |
| - `/home/yuki/Code/Agent/Codev/src/commands.ts` — 命令注册与过滤核心 |
| - `/home/yuki/Code/Agent/Codev/src/types/command.ts` — Command 类型定义 |
| - `/home/yuki/Code/Agent/Codev/src/skills/loadSkillsDir.ts` — 技能目录加载 |
| - `/home/yuki/Code/Agent/Codev/src/tools/WorkflowTool/` — 工作流工具实现 |
|
|
