Newer
Older
cortex-hub / CaudeCodeSourceCode / cc-recovered-main / README.zh-CN.md

Claude Code 2.1.88 Recovered

English | 简体中文

这是一个从 cli.js.map 逆向恢复出来,并重新整理为标准 npm 项目的 Claude Code 2.1.88 工程。当前它已经可以安装依赖、完成构建,并启动 CLI 基础入口。

项目概述

这个仓库的目标,是把 reverse-sourcemap 生成的恢复结果整理成一个更适合继续开发和维护的工程,以便:

  • 通过 npm 安装依赖
  • 在本地完成构建
  • 直接运行 CLI
  • 持续修复和补全缺失能力

当前已经验证通过:

  • npm install
  • npm run build
  • node dist/cli.js --help
  • node dist/cli.js --version

重要说明

这个仓库不是官方上游源码仓库,而是从 sourcemap 恢复结果重建出来的项目。

由于 reverse-sourcemap 的恢复并不完整,当前构建链中包含一部分兼容层、自动生成的 shim 和 stub,用来保证项目能够安装、构建并完成基础启动。因此这意味着:

  • 它适合用来做源码研究、调试和继续修复
  • 它不保证与官方发布 bundle 的行为完全一致
  • 某些私有集成、原生能力或高级功能仍然可能需要继续补全

环境要求

  • Node.js >= 18
  • npm >= 9

建议先确认环境版本:

node -v
npm -v

快速开始

npm install
npm run build
node dist/cli.js --help

安装依赖

在项目根目录执行:

npm install

这一步会根据 package.jsonpackage-lock.json 安装依赖。

编译项目

执行:

npm run build

构建完成后,输出会写入:

  • dist/cli.js
  • dist/src/**
  • dist/vendor/**

当前构建流程定义在 scripts/build.mjs,主要负责:

  • src/vendor/ 转译成 Node.js 可运行的 ESM 输出
  • bun:* 相关导入改写成 npm/Node 可兼容的 shim
  • 处理 src/* 别名导入
  • 为未完整恢复的模块生成兼容 stub
  • 注入 CLI 启动依赖的构建期常量

运行方式

直接运行构建产物:

node dist/cli.js --help

查看版本:

node dist/cli.js --version

也可以通过 npm script 启动:

npm start -- --help

安装为本地命令行工具

如果你想把这个项目安装成全局命令,可以在构建完成后执行:

npm install -g .

安装后可运行:

claude-recovered --help

如果你更偏向本地开发联调,也可以使用:

npm link

常用命令

npm install
npm run build
npm run clean
npm start -- --help
node dist/cli.js --version

项目结构

.
├── package.json
├── package-lock.json
├── scripts/
│   └── build.mjs
├── src/
├── vendor/
└── dist/

说明:

  • src/:恢复出的主要源码
  • vendor/:用于替代不可用私有依赖或原生模块的本地兼容实现
  • scripts/build.mjs:自定义 npm 构建流程
  • dist/:构建生成的运行产物

已知限制

  • 某些原始依赖并不存在于 npm,目前通过本地 shim 替代
  • 某些模块无法从 sourcemap 中完整恢复,目前会在构建时自动生成 stub
  • “能够启动”不等于“与官方 bundle 完全等价”
  • 与私有服务、私有协议或原生平台路径相关的能力,后续仍可能需要继续补全

问题排查

如果你遇到构建或运行问题,建议按下面顺序排查:

  1. 确认 Node.js 版本不低于 18
  2. 清理旧构建产物
  3. 重新安装依赖
  4. 重新构建
  5. 验证 CLI 基础入口是否正常

常用排查命令:

npm run clean
npm install
npm run build
node dist/cli.js --help

后续开发建议

如果你准备继续完善这个恢复工程,优先级最高的工作通常是:

  • 修复启动阶段的运行时报错
  • 把自动生成的 stub 逐步替换成真实实现
  • 为缺失的私有依赖补上兼容逻辑
  • 对照原始 bundle 校验高价值子命令行为

许可证与来源说明

该仓库包含从 sourcemap 恢复整理出的代码。在继续分发或公开发布之前,请自行确认原始项目的许可证、版权和使用条款。