将 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 补充序列化支持
|
||
|---|---|---|
| .. | ||
| src | ||
| Cargo.toml | ||
| README.md | ||
命令模块 (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等。
- 核心 (Core):
- 模糊匹配与建议:当用户输入错误的命令时,系统会自动推荐最接近的合法命令。
- 插件集成:
/plugins命令允许用户动态安装、启用、禁用或卸载插件,并能通知运行时重新加载环境。
实现逻辑
核心模块
lib.rs: 包含了绝大部分逻辑。SlashCommand枚举: 定义了所有命令的强类型表示。SlashCommandSpec结构体: 存储命令的静态配置信息。handle_plugins_slash_command: 处理复杂的插件管理工作流。suggest_slash_commands: 实现基于 Levenshtein 距离的建议算法。
工作流程
- 用户在 REPL 中输入以
/开头的字符串。 claw-cli调用SlashCommand::parse进行解析。- 解析后的命令被分发到相应的处理器。
- 处理结果(通常包含要显示给用户的消息,以及可选的会话更新或运行时重新加载请求)返回给 CLI。
使用示例 (内部)
use commands::{SlashCommand, suggest_slash_commands};
// 解析命令
if let Some(cmd) = SlashCommand::parse("/model sonnet") {
// 处理模型切换逻辑
}
// 获取建议
let suggestions = suggest_slash_commands("hpel", 3);
// 返回 ["/help"]