一、 工程概览
本仓库是 Claude Code 类 harness 的洁净室重写/移植 :README 定位为以 Python 为核心实现面 的移植工作区,并附带 Rust 集成 CLI。
| 部分 | 路径 | 作用 |
|---|---|---|
| Python 移植工作区 | src/ |
约 66 个 .py:子系统包(assistant/、cli/、hooks/ 等)、models.py、commands.py、tools.py、runtime.py、main.py 等;src/reference_data/ 下为镜像快照 JSON |
| 校验与演示 CLI | python3 -m src.main ... |
summary、manifest、commands/tools、route、bootstrap、turn-loop、远程模式模拟等 |
| Rust 工作区 | rust/ |
Cargo workspace:rusty-claude-cli(主二进制)、api、runtime、tools、commands、compat-harness 等 crate(详见 rust/README.md) |
| 测试 | tests/ |
针对移植工作区与 CLI 行为的 unittest |
这不是单一「Web 服务」仓库:Python 侧主要是 命令行子命令 ;Rust 侧才是 可编译的交互式 REPL / prompt 工具(需配 API/OAuth 等)。
编译与运行(当前环境结果)
Python代码编译构建
- 无需单独编译 (解释执行)。常用入口:
python3 -m src.main summary--- 生成 Markdown 摘要python3 -m src.main manifest--- 打印清单python3 -m unittest discover -s tests -v--- 已在本地跑通,22 个测试全部通过
Rust代码编译构建
你本机安装 Rust 后,按 rust/README.md 即可编译与运行,例如:
bash
cd rust
cargo build --release -p rusty-claude-cli
cargo run -p rusty-claude-cli -- --help # 查看帮助
cargo run -p rusty-claude-cli -- # 进入 REPL(需配置密钥等)
安装方式可参考:https://rustup.rs/
二、源码分析
整体来看,src下,大量的python代码都没有完成复刻迁移,只是建了个空目录占位。估计是时间太短了,工具还没有把活干完。
仓库本身也写得很清楚:Python 侧是「移植工作区」+ 与归档对齐的元数据/占位包,并不是已经把原系统 逐文件、可运行地 全部迁完。
更细一点说:
已完成或较完整的部分:顶层子系统命名、reference_data 里的快照、命令/工具清单镜像、main.py 那套 CLI(summary、manifest、route、部分模拟路径等),以及测试所覆盖的行为。
明显未「完全迁移」的部分:大量子系统目录只有读 JSON 的 init .py,没有对应体量的业务逻辑;README 也写明 尚不能作为与原 TypeScript 系统完全等价的运行时替代品。
另一条线:rust/ 里的 rusty-claude-cli 是另一套 可编译、偏产品化 的实现,和 src/ 的 Python 移植进度也不是一回事。
所以:当前阶段更准确的表述是 结构化对齐 + 部分可跑切片 + 持续移植,而不是「整库已迁完」。