后端:
- server: 实现完整的 HTTP 会话管理(CRUD)+ SSE 事件流推送,
支持双通道架构(POST 发消息 + GET SSE 接收流式响应)
- runtime: ContentBlock 新增 Thinking / RedactedThinking 变体,
支持思考过程和已编辑思考的序列化/反序列化
- api: 注册 GLM 系列模型(glm-4/5 等)到模型注册表,
扩展 XAI/OpenAI 兼容提供商的请求构建逻辑
前端:
- 基于 Ant Design X 构建完整聊天界面:Bubble.List 消息列表、
Sender 输入框、Conversations 会话管理、Think 思考过程折叠、
ThoughtChain 工具调用链展示
- XMarkdown 集成:代码高亮、Mermaid 图表、LaTeX 公式、
自定义脚注、流式渲染(incomplete 占位符)
- SSE Hook 对接服务端事件流,手动管理 AssistantBuffer 累积 delta
- 深色/浅色主题切换,会话侧边栏(新建/切换/删除)
|
||
|---|---|---|
| .. | ||
| src | ||
| Cargo.toml | ||
| README.md | ||
Claw CLI 模块 (claw-cli)
本模块实现了 Claw 应用程序的主要命令行界面 (CLI)。它提供了交互式的 REPL 环境和非交互式的命令执行功能。
概览
claw-cli 模块是整个项目的“胶水”,负责编排 runtime、api、tools 和 plugins 模块之间的交互。它捕获用户输入,管理应用程序状态,并以用户友好的格式渲染 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: 处理项目级初始化和仓库设置。
交互循环流程
- CLI 初始化
ConversationRuntime并加载项目上下文。 - 使用
rustyline进入捕获用户输入的循环。 - 检查用户输入是否为“斜杠命令”(如
/compact、/model)。 - 普通 Prompt 通过
runtime发送给 AI。 - AI 事件(文本增量、工具调用)逐步渲染到终端。
- 会话定期保存,以便将来可以恢复。
使用方法
主二进制程序名为 claw。
# 启动交互式 REPL
claw
# 运行单次 Prompt
claw prompt "解释一下这个项目的架构"
# 登录服务
claw login