claudecode/crates/rusty-claude-cli
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
tests feat: 合并上游 Rust 实现,扩展 API/运行时/工具链能力 2026-04-13 14:39:17 +08:00
build.rs feat: 合并上游 Rust 实现,扩展 API/运行时/工具链能力 2026-04-13 14:39:17 +08:00
Cargo.toml feat: 合并上游 Rust 实现,扩展 API/运行时/工具链能力 2026-04-13 14:39:17 +08:00
README.md feat: 添加 Web 前端及服务端 SSE 流式支持,扩展多模型兼容 2026-04-10 16:29:27 +08:00

Rusty Claude CLI 模块 (rusty-claude-cli)

本模块提供了 Claw 命令行界面的另一个功能完整的实现。它集成了对话、工具执行、插件扩展以及身份验证等核心功能。

概览

rusty-claude-cli 是一个全功能的 CLI 应用程序,其主要职责包括:

  • 用户交互:提供交互式 REPL 和非交互式命令执行(prompt 子命令)。
  • 环境初始化:处理项目初始化 (init) 和配置加载。
  • 身份验证:通过本地回环服务器处理 OAuth 登录流程。
  • 状态渲染:实现丰富的终端 UI 效果,如 Markdown 渲染、语法高亮和动态加载动画 (Spinner)。
  • 会话管理:支持从保存的文件中恢复会话并执行追加的斜杠命令。

claw-cli 的关系

虽然 rusty-claude-cliclaw-cli 都生成名为 claw 的二进制文件,但 rusty-claude-cli 包含更复杂的集成逻辑:

  • 它直接引用了几乎所有的核心 crateruntime, api, tools, plugins, commands)。
  • 它的 main.rs 实现非常庞大,包含了大量的业务编排逻辑。
  • 它可以作为一个独立的、集成度极高的 CLI 参考实现。

关键特性

  • 多功能子命令
    • prompt:快速运行单次推理。
    • login/logoutOAuth 身份验证管理。
    • init:项目环境自举。
    • bootstrap-plan:查看系统的启动阶段。
    • dump-manifests:从上游源码中提取并显示功能清单。
  • 增强的 REPL
    • 支持多行输入和历史记录。
    • 集成了斜杠命令处理引擎。
    • 提供详细的消耗统计和权限模式切换报告。
  • 灵活的权限控制:支持通过命令行参数 --permission-mode 或环境变量动态调整权限级别。

实现逻辑

核心子模块

  • main.rs: 程序的入口,包含了复杂的参数解析逻辑和 REPL 循环。
  • render.rs: 封装了 TerminalRendererSpinner,负责所有的终端输出美化。
  • input.rs: 处理从标准输入读取数据及命令解析。
  • init.rs: 专注于仓库的初始化和 .claw.md 文件的生成。
  • app.rs: 可能包含应用程序级别的高层状态管理(取决于具体实现)。

工作流程

  1. 程序启动,解析命令行参数。
  2. 根据参数决定是执行单次任务还是进入 REPL 模式。
  3. 在 REPL 模式下,初始化 ConversationRuntime
  4. 进入循环:读取用户输入 -> 处理斜杠命令或发送给 AI -> 渲染响应 -> 执行工具 -> 循环。
  5. 会话数据根据需要保存或恢复。

使用示例

# 启动交互模式
cargo run -p rusty-claude-cli --bin claw

# 直接运行 Prompt
cargo run -p rusty-claude-cli --bin claw prompt "检查代码中的内存泄漏"

# 恢复之前的会话并执行压缩
cargo run -p rusty-claude-cli --bin claw --resume session.json /compact