claudecode/crates/claw-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
Cargo.toml feat: 添加 Web 前端及服务端 SSE 流式支持,扩展多模型兼容 2026-04-10 16:29:27 +08:00
README.md feat: 添加 Web 前端及服务端 SSE 流式支持,扩展多模型兼容 2026-04-10 16:29:27 +08:00

Claw CLI 模块 (claw-cli)

本模块实现了 Claw 应用程序的主要命令行界面 (CLI)。它提供了交互式的 REPL 环境和非交互式的命令执行功能。

概览

claw-cli 模块是整个项目的“胶水”,负责编排 runtimeapitoolsplugins 模块之间的交互。它捕获用户输入,管理应用程序状态,并以用户友好的格式渲染 AI 响应。

关键特性

  • 交互式 REPL:一个功能齐全的 Read-Eval-Print Loop用于与 AI 对话,支持:
    • 通过 rustyline 实现多行输入和命令历史。
    • 实时的 Markdown 流式显示和代码语法高亮。
    • 为耗时的工具调用显示动态的加载动画 (Spinner) 和进度指示器。
  • 子命令
    • prompt:运行单次 Prompt 并退出(单次模式)。
    • login/logout:处理与 Claw 平台的 OAuth 身份验证。
    • init:初始化新项目/仓库以配合 Claw 使用。
    • resume:恢复并继续之前的对话会话。
    • agents/skills:管理并发现可用的智能体和技能。
  • 权限管理:对工具执行权限的细粒度控制:
    • read-only:安全的分析模式。
    • workspace-write:允许在当前工作区内进行修改。
    • danger-full-access:高级任务的无限制访问。
  • OAuth 流程:集成了本地 HTTP 服务器,无缝处理用户机器上的 OAuth 回调重定向。

实现逻辑

核心模块

  • main.rs: 主要入口点。负责解析命令行参数、初始化环境并调度到适当的操作REPL 或子命令)。
  • render/: 包含 TerminalRenderer 和 Markdown 流渲染逻辑。使用 syntect 进行语法高亮,并使用 crossterm 进行终端操作。
  • input/: 处理用户输入捕获,包括对多行 Prompt 和斜杠命令 (Slash Command) 的特殊处理。
  • init.rs: 处理项目级初始化和仓库设置。

交互循环流程

  1. CLI 初始化 ConversationRuntime 并加载项目上下文。
  2. 使用 rustyline 进入捕获用户输入的循环。
  3. 检查用户输入是否为“斜杠命令”(如 /compact/model)。
  4. 普通 Prompt 通过 runtime 发送给 AI。
  5. AI 事件(文本增量、工具调用)逐步渲染到终端。
  6. 会话定期保存,以便将来可以恢复。

使用方法

主二进制程序名为 claw

# 启动交互式 REPL
claw

# 运行单次 Prompt
claw prompt "解释一下这个项目的架构"

# 登录服务
claw login