claudecode/crates/compat-harness
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: Rust port of Claude Code CLI 2026-03-31 17:43:09 +00:00
README.md feat: 添加 Web 前端及服务端 SSE 流式支持,扩展多模型兼容 2026-04-10 16:29:27 +08:00

兼容性测试套件模块 (compat-harness)

本模块提供了一套工具,专门用于分析和提取上游引用实现(如原始的 claude-code TypeScript 源码)中的元数据,以确保 Rust 版本的实现与其保持功能兼容。

概览

compat-harness 的主要职责是:

  • 定位上游仓库的源码路径。
  • 从 TypeScript 源码文件中提取命令 (commands)、工具 (tools) 和启动阶段 (bootstrap phases) 的定义。
  • 自动生成功能清单 (ExtractedManifest),供运行时或测试使用,以验证 Rust 版本的覆盖率。

关键特性

  • 上游路径解析 (UpstreamPaths):能够自动识别多种常见的上游仓库目录结构,并支持通过环境变量 CLAUDE_CODE_UPSTREAM 进行覆盖。
  • 静态代码分析:通过解析 TypeScript 源码,识别特定的代码模式(如 export const INTERNAL_ONLY_COMMANDS 或基于 feature() 的功能开关)。
  • 清单提取 (Manifest Extraction)
    • 命令提取:识别内置命令、仅限内部使用的命令以及受功能开关控制的命令。
    • 工具提取:识别基础工具和条件加载的工具。
    • 启动计划提取:分析 CLI 入口文件,重建启动时的各个阶段(如 FastPathVersion, MainRuntime 等)。

实现逻辑

核心模块

  • lib.rs: 包含了核心的提取逻辑。
    • UpstreamPaths 结构体: 封装了寻找 commands.tstools.tscli.tsx 的逻辑。
    • extract_commands & extract_tools: 使用字符串解析技术,识别 TypeScript 的 import 和赋值操作,提取符号名称。
    • extract_bootstrap_plan: 搜索特定的标志性字符串(如 --versiondaemon-worker),从而推断出上游程序的启动流程。

工作流程

  1. 模块根据预设路径或环境变量寻找上游 claude-code 仓库。
  2. 读取关键的 .ts.tsx 文件内容。
  3. 执行正则表达式风格的行解析,提取出所有定义的命令和工具名称。
  4. 将提取结果组织成 ExtractedManifest 对象。

使用示例 (内部测试)

use compat_harness::{UpstreamPaths, extract_manifest};

// 指定工作区目录,自动寻找上游路径
let paths = UpstreamPaths::from_workspace_dir("path/to/workspace");
// 提取功能清单
if let Ok(manifest) = extract_manifest(&paths) {
    println!("上游发现 {} 个工具", manifest.tools.entries().len());
}