Claude Code 2.1.88 恢复工程说明 banner
Ta0ing Ta0ing

Claude Code 2.1.88 恢复工程说明

Development community intermediate

Description

本仓库是基于已发布包中的 `cli.js` 与 `cli.js.map` 反推恢复出来的 Claude Code 源码树。当前目标不是“完全还原官方开发仓库历史”,而是提供一个可以继续编译、启动、调试、补模块和二次开发的可维护工程。 当前验证状态: - 可以执行 `npm_config_cache=.npm-cache npm run build` - 可以执行 `npm run cli:stat

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Claude Code 2.1.88 恢复工程说明

本仓库是基于已发布包中的 `cli.js` 与 `cli.js.map` 反推恢复出来的 Claude Code 源码树。当前目标不是“完全还原官方开发仓库历史”,而是提供一个可以继续编译、启动、调试、补模块和二次开发的可维护工程。

当前验证状态:

  • 可以执行 npm_config_cache=.npm-cache npm run build
  • 可以执行 npm run cli:status
  • 可以执行 npm run cli:run -- -p "Reply with exactly: OK"
  • 可以执行 npm run cli:run 进入交互界面

相关手册:

友链:

快速开始

npm install
npm_config_cache=.npm-cache npm run build
npm run cli:status
npm run cli:run

如果你希望运行时继承全局 `~/.claude/settings.json` 中的代理和认证环境,直接使用上面的 `npm run cli:run` 即可。 如果你希望用项目内隔离配置启动,可以使用:

CLAUDE_RECOVERY_SKIP_GLOBAL_ENV=1 npm run cli:run

项目结构

根目录

路径 功能
package.json 包元数据、依赖和常用脚本入口。
package-lock.json 依赖锁文件。
tsconfig.json TypeScript 检查配置,本项目主要依赖 esbuild 打包,不直接用 tsc 产物。
scripts/ 构建、缺失模块审计、恢复启动器和若干 shim。
src/ 恢复后的主源码目录。
dist/ esbuild 产物目录,包含 cli.jscli.js.map
types/ 顶层类型补丁与声明文件。
vendor/ 第三方或外部搬运代码。
.claude-recovery/ 项目级运行配置与会话数据目录。
.npm-cache/ 当前工程本地 npm 缓存目录。
image-processor.node 恢复阶段保留的原生模块占位文件。

scripts 模块

路径 功能
scripts/build.mjs esbuild 打包脚本,负责宏替换、缺失模块回退、文本资源 loader、原生模块 TS 替代映射。
scripts/audit-missing.mjs 缺失源码/文本/type-only 模块审计工具。
scripts/run-recovered-cli.mjs 恢复版 CLI 启动器,负责项目级配置目录和全局环境继承/隔离。
scripts/shims/empty-module.js 空模块 shim,用于无内容依赖的兜底。
scripts/shims/missing-module.cjs 缺失运行时代码时的通用降级模块。
scripts/shims/missing-text.cjs 缺失文本资源时的通用降级模块。
scripts/shims/bun-bundle.js bun:bundle 的兼容 shim。
scripts/shims/bun-ffi.js bun:ffi 的兼容 shim。

架构分层

启动与入口层

路径 功能
src/entrypoints CLI/SDK 入口,负责启动分流和轻量 fast-path。
src/entrypoints/sdk SDK 入口 schema 与 SDK 模式支持。
src/bootstrap 运行时全局状态、会话上下文和初始化阶段共享状态。
src/main.tsx 主 CLI 入口,实现参数解析、初始化、插件/技能/工具装配与 REPL 拉起。
src/commands.ts 内建命令注册表,聚合所有 slash/CLI 命令。

交互与呈现层

路径 功能
src/components Ink/React 交互组件总目录。
src/ink Ink 渲染适配、自定义布局、事件和终端能力封装。
src/screens 完整屏幕级交互视图。
src/outputStyles 输出风格与展示模式。
src/vim Vim 风格输入和编辑支持。
src/voice 语音交互相关模块。

能力与业务层

路径 功能
src/services API、OAuth、MCP、LSP、分析、策略、记忆等业务服务。
src/tools 暴露给模型或运行时的工具实现。
src/tasks 本地/远端/工作流/子代理任务执行单元。
src/plugins 插件系统和内置插件装配。
src/skills 技能系统与打包技能资源。
src/remote 远程会话、同步和传输管理。
src/bridge 远程控制/桥接模式支持。
src/server 本地服务端能力和直连会话创建。

基础设施层

路径 功能
src/utils 工程内最庞大的基础设施层,包含配置、认证、模型、文件、权限、插件、shell、sandbox 等通用能力。
src/constants 常量、产品文案、模型配置、OAuth 配置等静态定义。
src/context 会话上下