claudecode/crates/commands
fengmengqi d8d77824f4 feat: 合并上游 Rust 实现,扩展 API/运行时/工具链能力
将 claw-code/rust/crates 的完整实现合并到主 workspace,涵盖
  9 个 crate 的更新与 2 个新 crate 的引入。

  API 层:
  - 用原生 Anthropic 客户端(anthropic.rs)替换 claw_provider,
    新增 prompt cache 减少重复请求开销
  - 新增 HTTP 客户端构建器统一代理配置,OpenAI 兼容端增加
    DashScope/Qwen 支持与抖动重试
  - MessageRequest 扩展 temperature/top_p 等模型调参字段
  - SSE 解析器增加 provider 上下文感知的错误信息

  运行时(~11,000 行新增):
  - 新增 bash 命令安全校验、分支锁碰撞检测、配置文件校验
  - 新增会话存储与控制面、MCP 生命周期状态机与服务端实现
  - 新增权限执行引擎、策略引擎、插件生命周期管理
  - 新增 worker 启动编排、任务/定时任务注册表、信任解析器
  - 保留 Windows cmd /C fallback

  命令/插件/工具:
  - commands 大幅重写,扩展 sandbox、doctor、plan 等 slash 命令
  - plugins 新增 PostToolUseFailure hook 与宽容加载机制
  - tools 新增 PDF 提取与 lane 补全工具

  新增 crate:mock-anthropic-service(测试)、telemetry(遥测)

  适配 claw-cli/server:ClawApiClient→AnthropicClient 重命名,
  SlashCommand::parse 返回 Result,移除 session 级 Thinking 变体,
  TokenUsage/ConversationMessage 补充序列化支持
2026-04-13 14:39:17 +08:00
..
src feat: 合并上游 Rust 实现,扩展 API/运行时/工具链能力 2026-04-13 14:39:17 +08:00
Cargo.toml feat: Claw Code 重命名及架构升级 2026-04-02 15:14:31 +08:00
README.md feat: 添加 Web 前端及服务端 SSE 流式支持,扩展多模型兼容 2026-04-10 16:29:27 +08:00

命令模块 (commands)

本模块负责定义和管理 Claw 交互界面中使用的“斜杠命令”(Slash Commands),并提供相关的解析和执行逻辑。

概览

commands 模块的主要职责包括:

  • 定义所有可用的斜杠命令及其元数据(别名、说明、类别等)。
  • 提供命令注册表 (CommandRegistry),用于在 CLI 中发现和分发命令。
  • 实现复杂的管理命令,如插件管理 (/plugins)、智能体查看 (/agents) 和技能查看 (/skills)。
  • 提供命令建议功能,支持基于编辑距离 (Levenshtein distance) 的模糊匹配。

关键特性

  • 斜杠命令规范 (SlashCommandSpec)每个命令都包含详尽的元数据包括所属类别核心、工作区、会话、Git、自动化以及是否支持在恢复会话时执行。
  • 命令分类
    • 核心 (Core)/help, /status, /model, /permissions, /cost 等。
    • 工作区 (Workspace)/config, /memory, /diff, /teleport 等。
    • 会话 (Session)/clear, /resume, /export, /session 等。
    • Git 交互/branch, /commit, /pr, /issue 等。
    • 自动化 (Automation)/plugins, /agents, /skills, /ultraplan 等。
  • 模糊匹配与建议:当用户输入错误的命令时,系统会自动推荐最接近的合法命令。
  • 插件集成/plugins 命令允许用户动态安装、启用、禁用或卸载插件,并能通知运行时重新加载环境。

实现逻辑

核心模块

  • lib.rs: 包含了绝大部分逻辑。
    • SlashCommand 枚举: 定义了所有命令的强类型表示。
    • SlashCommandSpec 结构体: 存储命令的静态配置信息。
    • handle_plugins_slash_command: 处理复杂的插件管理工作流。
    • suggest_slash_commands: 实现基于 Levenshtein 距离的建议算法。

工作流程

  1. 用户在 REPL 中输入以 / 开头的字符串。
  2. claw-cli 调用 SlashCommand::parse 进行解析。
  3. 解析后的命令被分发到相应的处理器。
  4. 处理结果(通常包含要显示给用户的消息,以及可选的会话更新或运行时重新加载请求)返回给 CLI。

使用示例 (内部)

use commands::{SlashCommand, suggest_slash_commands};

// 解析命令
if let Some(cmd) = SlashCommand::parse("/model sonnet") {
    // 处理模型切换逻辑
}

// 获取建议
let suggestions = suggest_slash_commands("hpel", 3);
// 返回 ["/help"]