docs: 添加中文说明和运行方式到 README

This commit is contained in:
oboard 2026-03-31 20:40:42 +08:00
parent e68bf2201a
commit 64915d7302

View File

@ -52,11 +52,82 @@
```bash
bun install
```
Run the restored CLI:
```bash
bun run dev
```
Print the restored version:
```bash
bun run version
```
## 中文说明
# 还原后的 Claude Code 源码
![Preview](preview.png)
这个仓库是一个主要通过 source map 逆向还原、再补齐缺失模块后得到的 Claude Code 源码树。
它并不是上游仓库的原始状态。部分文件无法仅凭 source map 恢复,因此目前仍包含兼容 shim 或降级实现,以便项目可以重新安装并运行。
### 当前状态
- 该源码树已经可以在本地开发流程中恢复并运行。
- `bun install` 可以成功执行。
- `bun run version` 可以成功执行。
- `bun run dev` 现在会通过还原后的真实 CLI bootstrap 启动,而不是临时的 `dev-entry`
- `bun run dev --help` 可以显示还原后的完整命令树。
- 仍有部分模块保留恢复期 fallback因此行为可能与原始 Claude Code 实现不同。
### 已恢复内容
最近一轮恢复工作已经补回了最初 source-map 导入之外的几个关键部分:
- 默认 Bun 脚本现在会走真实的 CLI bootstrap 路径
- `claude-api``verify` 的 bundled skill 内容已经从占位文件恢复为可用参考文档
- Chrome MCP 和 Computer Use MCP 的兼容层现在会暴露更接近真实的工具目录,并返回结构化的降级响应,而不是空 stub
- 一些显式占位资源已经替换为可用的 planning 与 permission-classifier fallback prompt
当前剩余缺口主要集中在私有或原生集成部分,这些实现无法仅凭 source map 完整恢复,因此这些区域仍依赖 shim 或降级行为。
### 为什么会有这个仓库
source map 本身并不能包含完整的原始仓库:
- 类型专用文件经常缺失
- 构建时生成的文件可能不存在
- 私有包包装层和原生绑定可能无法恢复
- 动态导入和资源文件经常不完整
这个仓库的目标是把这些缺口补到“可用、可运行”的程度,形成一个可继续修复的恢复工作区。
### 运行方式
环境要求:
- Bun 1.3.5 或更高版本
- Node.js 24 或更高版本
安装依赖:
```bash
bun install
```
运行恢复后的 CLI
```bash
bun run dev
```
输出恢复后的版本号:
```bash
bun run version
```