From 64915d730218363acba49e5454dc01c31e3986b1 Mon Sep 17 00:00:00 2001
From: oboard <oboard@outlook.com>
Date: Tue, 31 Mar 2026 20:40:42 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E4=B8=AD=E6=96=87?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E=E5=92=8C=E8=BF=90=E8=A1=8C=E6=96=B9=E5=BC=8F?=
 =?UTF-8?q?=E5=88=B0=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/README.md b/README.md
index 9ec6fea..4dfcb59 100644
--- a/README.md
+++ b/README.md
@@ -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
+  ```