将 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 | ||
| tests | ||
| Cargo.toml | ||
| README.md | ||
API 模块 (api)
本模块提供了与大型语言模型 (LLM) 服务提供商(主要是 Anthropic 的 Claude 和兼容 OpenAI 的服务)进行交互的高层抽象和客户端。
概览
api 模块负责以下职责:
- 标准化与不同 AI 提供商的通信。
- 通过服务器发送事件 (SSE) 处理流式响应。
- 管理身份验证源(API 密钥、OAuth 令牌)。
- 提供消息、工具和使用情况跟踪的共享数据结构。
关键特性
- 提供商抽象 (Provider Abstraction):支持多种 AI 后端,包括:
ClawApiClient: Claude 模型的主要提供商。OpenAiCompatClient: 支持兼容 OpenAI 的 API(如本地模型、专门的提供商)。
- 流式支持 (Streaming Support):健壮的 SSE 解析实现 (
SseParser),用于处理实时的内容生成。 - 工具集成 (Tool Integration):为
ToolDefinition、ToolChoice和ToolResultContentBlock提供强类型定义,支持智能代理 (Agentic) 工作流。 - 身份验证管理 (Auth Management):用于解析启动身份验证源和管理 OAuth 令牌的实用工具。
- 模型智能 (Model Intelligence):解析模型别名和计算最大标记 (Token) 限制的元数据及辅助函数。
实现逻辑
核心模块
client.rs: 定义了ProviderClient特性 (Trait) 和基础客户端逻辑。它使用reqwest处理 HTTP 请求,并管理消息流的生命周期。types.rs: 包含 API 的核心数据模型,如InputMessage、OutputContentBlock以及MessageRequest/MessageResponse。sse.rs: 实现了一个状态化的 SSE 解析器,能够处理分段的数据块并发出类型化的StreamEvent。providers/: 包含针对不同 LLM 端点的特定逻辑,将它们的独特格式映射到本模块使用的共享类型。
数据流
- 构建包含模型详情、消息和工具定义的
MessageRequest。 ApiClient将此请求转换为提供商特定的 HTTP 请求。- 如果启用了流式传输,客户端返回一个
MessageStream,该流使用SseParser来产生StreamEvent。 - 最终响应包含用于跟踪 Token 消耗的
Usage信息。
使用示例
use api::{ApiClient, MessageRequest, InputMessage};
// 示例初始化(已简化)
let client = ApiClient::new(auth_source);
let request = MessageRequest {
model: "claude-3-5-sonnet-20241022".to_string(),
messages: vec![InputMessage::user("你好,世界!")],
..Default::default()
};
let stream = client.create_message_stream(request).await?;