后端:
- 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 | ||
兼容性测试套件模块 (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.ts、tools.ts和cli.tsx的逻辑。extract_commands&extract_tools: 使用字符串解析技术,识别 TypeScript 的import和赋值操作,提取符号名称。extract_bootstrap_plan: 搜索特定的标志性字符串(如--version或daemon-worker),从而推断出上游程序的启动流程。
工作流程
- 模块根据预设路径或环境变量寻找上游
claude-code仓库。 - 读取关键的
.ts或.tsx文件内容。 - 执行正则表达式风格的行解析,提取出所有定义的命令和工具名称。
- 将提取结果组织成
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());
}