diff --git a/RECORD.md b/RECORD.md index 06bc328..90f4d18 100644 --- a/RECORD.md +++ b/RECORD.md @@ -6,34 +6,11 @@ --- -## 零、项目目标 +## 一、项目目标 **将 claude-code 项目运行起来，必要时可以删减次级能力。** -这是一个 Anthropic 官方的 Claude Code CLI 工具的源码反编译/逆向还原项目。项目的核心目标是： - -1. **使项目能够成功构建和运行** — 优先解决 `bun run build` 和 `bun run dev` 的阻塞问题 -2. **删减次级能力以降低复杂度** — 对于依赖私有 npm 包（如 `@ant/*`）的功能，可以用 stub 替代或直接移除 -3. **保留核心 CLI 交互能力** — 保留与 Anthropic API 通信、工具调用、REPL 交互等核心功能 - -### 可删减的次级能力 - -| 模块 | 说明 | 处理方式 | -|------|------|----------| -| Computer Use | `@ant/computer-use-*` 私有包 | stub 或移除 | -| Claude for Chrome | `@ant/claude-for-chrome-mcp` | stub 或移除 | -| Magic Docs | 私有文档处理 | 移除 | -| Voice Mode | 语音模式 | 移除 | -| LSP Server | `vscode-languageserver-*` | 移除 | -| Analytics/Telemetry | 数据上报 | 空实现 | -| GrowthBook | A/B 实验 | 空实现 | -| Plugins/Marketplace | 插件市场 | 移除 | -| Desktop Upsell | 桌面端推销 | 移除 | -| Ultraplan | 私有功能 | 移除 | -| Tungsten | 私有功能 | 移除 | -| Sentry | 错误上报 | 移除 | -| Auto Dream | 自动后台任务 | 移除 | -| MCP OAuth/IDP | 企业级认证 | 简化 | +这是 Anthropic 官方 Claude Code CLI 工具的源码反编译/逆向还原项目。 ### 核心保留能力 @@ -44,221 +21,85 @@ - 权限系统（基础） - Agent/子代理系统 ---- +### 已删减的次级能力 -## 一、整体进度 - -| 阶段 | 错误数 | 说明 | -|------|--------|------| -| 初始状态 | ~1800 | 仅缺少 npm 依赖的 TS2307 错误 | -| 补全依赖后 | ~1800 | npm 包已安装，开始处理类型 | -| 第一轮 stub 生成 | ~2163 | 自动 stub 生成但质量问题多（全用 `export type`） | -| **第二轮修复后** | **~1341** | 修复了默认导出、补充命名导出、泛型类型 | - -### 当前错误分布（第二轮修复后） - -| 错误码 | 数量 | 含义 | 性质 | -|--------|------|------|------| -| TS2339 | 701 | 属性不存在 | **主要是源码级问题**（unknown 344, never 121, {} 52） | -| TS2322 | 210 | 类型不匹配 | 源码级 | -| TS2345 | 134 | 参数类型不匹配 | 源码级 | -| TS2367 | 106 | 比较类型无交集 | 源码级（编译时死代码） | -| TS2307 | 29 | 缺失模块 | 可修但收益小 | -| TS2693 | 13 | type 当值用 | 少量残留 | -| TS2300 | 10 | 重复标识符 | 小问题 | -| 其他 | ~138 | TS2365/TS2554/TS2578/TS2538/TS2698 等 | 混合 | - -### 关键发现 - -剩余 1341 个错误中，**绝大多数（~1200+）是源码级别的类型问题**，不是 stub 缺失导致的： - -- `unknown` 类型访问属性 (344) — 反编译产生的 `unknown` 需要断言 -- `never` 类型 (121) — 联合类型穷尽后的死路径 -- `{}` 空对象 (52) — 空 stub 模块的残留影响 -- ComputerUseAPI/ComputerUseInputAPI (42) — 私有包声明不够详细 - -**继续逐个修复类型错误的投入产出比很低。应该改变方向，尝试直接构建运行。** +| 模块 | 处理方式 | +|------|----------| +| Computer Use (`@ant/computer-use-*`) | stub | +| Claude for Chrome (`@ant/claude-for-chrome-mcp`) | stub | +| Magic Docs / Voice Mode / LSP Server | 移除 | +| Analytics / GrowthBook / Sentry | 空实现 | +| Plugins/Marketplace / Desktop Upsell | 移除 | +| Ultraplan / Tungsten / Auto Dream | 移除 | +| MCP OAuth/IDP | 简化 | +| DAEMON / BRIDGE / BG_SESSIONS / TEMPLATES 等 | feature flag 关闭 | --- -## 二、已完成的工作 - -### 2.1 全局变量声明 (`src/types/global.d.ts`) - -声明了编译时宏和内部标识符： - -- **MACRO / MACRO.VERSION** — Bun 编译时宏，通过 `bun:bundle` 提供 -- **MACRO.BUILD_TIME / FEEDBACK_CHANNEL / ISSUES_EXPLAINER** 等编译时常量 -- **resolveAntModel / getAntModels / getAntModelOverrideConfig** — 内部模型解析 -- **fireCompanionObserver** — Companion 观察器 -- **apiMetricsRef / computeTtftText** — 指标计算 -- **Gates / GateOverridesWarning / ExperimentEnrollmentNotice** — 功能门控 -- **HOOK_TIMING_DISPLAY_THRESHOLD_MS** — Hook 时间阈值 -- **UltraplanChoiceDialog / UltraplanLaunchDialog / launchUltraplan** — Ultraplan 功能 -- **TungstenPill** — Tungsten 功能 -- **T** — React compiler 输出泄露的泛型参数 - -### 2.2 内部包声明 (`src/types/internal-modules.d.ts`) - -为 Anthropic 私有包提供了详细的类型导出： - -- `@ant/claude-for-chrome-mcp` — BROWSER_TOOLS, ClaudeForChromeContext, Logger 等 -- `@ant/computer-use-mcp` — ComputerExecutor, ScreenshotResult, buildComputerUseTools 等 -- `@ant/computer-use-mcp/types` — ComputerUseHostAdapter, CoordinateMode 等 -- `@ant/computer-use-mcp/sentinelApps` — getSentinelCategory -- `@ant/computer-use-input` — ComputerUseInput, ComputerUseInputAPI -- `@ant/computer-use-swift` — ComputerUseAPI -- `@anthropic-ai/mcpb` — McpbManifest, McpbUserConfigurationOption -- `color-diff-napi` — ColorDiff, SyntaxTheme, getSyntaxTheme -- `audio-capture-napi / image-processor-napi / url-handler-napi` -- `bun:bundle / bun:ffi` - -### 2.3 SDK 模块补全 (`src/entrypoints/sdk/`) - -为缺失的 SDK 子模块创建了 stub 文件： - -| 文件 | 说明 | -|------|------| -| `controlTypes.ts` | 控制协议类型（SDKControlRequest/Response） | -| `runtimeTypes.ts` | 运行时类型（SDKSession, Query, Options, SdkMcpToolDefinition 等） | -| `coreTypes.generated.ts` | 从 Zod schema 生成的类型（ModelUsage, HookInput 系列, SDK 消息类型等） | -| `settingsTypes.generated.ts` | Settings 类型 | -| `toolTypes.ts` | 工具类型 | -| `sdkUtilityTypes.ts` | NonNullableUsage 等工具类型 | - -### 2.4 自动化 stub 生成 (`scripts/create-type-stubs.mjs`) - -编写了自动分析脚本，通过解析 `tsc` 错误和源码 `import` 语句，自动创建缺失模块的 stub 文件： - -- 扫描 TS2305/TS2614/TS2724 获取缺失导出 -- 扫描源码 import 语句获取命名导入 -- 自动创建 `export type X = any` stub -- 已生成 **1206 个 stub 文件，覆盖 2067 个命名导出** - -### 2.5 第二轮修复 — 默认导出 & 缺失导出 (本次会话) - -#### `scripts/fix-default-stubs.mjs` — 修复 120 个 `export default {} as any` 的 stub 文件 - -- 扫描源码中所有 import 语句，区分 `import type {}` vs `import {}` -- 将纯类型导出为 `export type X = any`，值导出为 `export const X: any = (() => {}) as any` -- **效果**: TS2614 从 632 → 0 (完全消除) - -#### `scripts/fix-missing-exports.mjs` — 补全空模块的导出成员 - -- 解析 TS2339 中 `typeof import("...")` 的错误，给 81 个模块添加了 147 个缺失导出 -- 解析 TS2305 添加了 10 个缺失导出 -- 解析 TS2724 添加了 4 个命名不匹配的导出 -- 创建了 2 个新 stub 文件修复 TS2307 - -#### 泛型类型修复 - -将以下类型从非泛型改为泛型（修复 86 个 TS2315）： - -- `DeepImmutable`, `Permutations` (`src/types/utils.ts`) -- `AttachmentMessage`, `ProgressMessage`, `NormalizedAssistantMessage` (`src/types/message.ts` 及其多个副本) -- `WizardContextValue` (`src/components/wizard/types.ts`) - -#### 语法修复 - -修复 4 个 `export const default` 非法语法（buddy/fork/peers/workflows 的 index.ts） - ---- - -## 三、当前问题分析 - -### 3.1 剩余错误已触达 "源码级" 地板 - -剩余 ~1341 个错误绝大多数不是 stub 缺失问题，而是源码本身的类型问题： - -- **unknown (344)**: 反编译代码中大量 `unknown` 类型变量直接访问属性 -- **never (121)**: 联合类型穷尽后的 never 路径（通常是 switch/if-else 的 exhaustive check） -- **{} (52)**: 空对象类型 -- **类型比较 (106 TS2367)**: 编译时死代码如 `"external" === "ant"` -- **类型不匹配 (210 TS2322 + 134 TS2345)**: stub 类型不够精确 - -### 3.2 继续修类型错误的问题 - -1. **投入产出比极低** — 每个 TS2339/TS2322 都需要理解具体上下文 -2. **Bun bundler 不强制要求零 TS 错误** — Bun 可以在有类型错误的情况下成功构建 -3. **大部分是运行时无影响的类型问题** — `unknown as any` 等模式不影响实际执行 - ---- - -## 四、后续方向建议 - -### 方向 A: 直接尝试 `bun build` 构建 ⭐ 推荐 - -Bun bundler 对类型错误比 tsc 宽容得多。应该直接尝试构建： +## 二、当前状态：Dev 模式已可运行 ```bash -bun build src/entrypoints/cli.tsx --target=node --outdir=dist +# dev 运行 +bun run dev +# 直接运行 +bun run src/entrypoints/cli.tsx +# 测试 -p 模式 +echo "say hello" | bun run src/entrypoints/cli.tsx -p +# 构建 +bun run build ``` -遇到的构建错误才是真正需要修的问题（缺失模块、语法错误等），而非类型错误。 +| 测试 | 结果 | +|------|------| +| `--version` | `2.1.87 (Claude Code)` | +| `--help` | 完整帮助信息输出 | +| `-p` 模式 | 成功调用 API 返回响应 | -### 方向 B: 在 tsconfig 中进一步放宽 +### TS 类型错误说明 -```json -{ - "compilerOptions": { - "strict": false, - "noImplicitAny": false, - "strictNullChecks": false - } -} -``` - -已经是 `strict: false`，但可以进一步添加 `"skipLibCheck": true`（已有）。 - -### 方向 C: 批量 `// @ts-nocheck` - -对有大量源码级类型错误的文件加 `// @ts-nocheck`，快速消除错误。 +仍有 ~1341 个 tsc 错误，绝大多数是反编译产生的源码级类型问题（unknown/never/{}），**不影响 Bun 运行时**。不再逐个修复。 --- -## 五、关键文件清单 +## 三、关键修复记录 + +### 3.1 自动化 stub 生成 + +通过 3 个脚本自动处理了缺失模块问题： +- `scripts/create-type-stubs.mjs` — 生成 1206 个 stub 文件 +- `scripts/fix-default-stubs.mjs` — 修复 120 个默认导出 stub +- `scripts/fix-missing-exports.mjs` — 补全 81 个模块的 161 个缺失导出 + +### 3.2 手动类型修复 + +- `src/types/global.d.ts` — MACRO 宏、内部函数声明 +- `src/types/internal-modules.d.ts` — `@ant/*` 等私有包类型声明 +- `src/entrypoints/sdk/` — 6 个 SDK 子模块 stub +- 泛型类型修复（DeepImmutable、AttachmentMessage 等） +- 4 个 `export const default` 非法语法修复 + +### 3.3 运行时修复 + +**Commander 非法短标志**：`-d2e, --debug-to-stderr` → `--debug-to-stderr`（反编译错误） + +**`bun:bundle` 运行时 Polyfill**（`src/entrypoints/cli.tsx` 顶部）： +```typescript +const feature = (_name: string) => false; // 所有 feature flag 分支被跳过 +(globalThis as any).MACRO = { VERSION: "2.1.87", ... }; // 绕过版本检查 +``` + +--- + +## 四、关键文件清单 | 文件 | 用途 | |------|------| +| `src/entrypoints/cli.tsx` | 入口文件（含 MACRO/feature polyfill） | +| `src/main.tsx` | 主 CLI 逻辑（Commander 定义） | | `src/types/global.d.ts` | 全局变量/宏声明 | | `src/types/internal-modules.d.ts` | 内部 npm 包类型声明 | -| `src/types/react-compiler-runtime.d.ts` | React compiler runtime | -| `src/types/sdk-stubs.d.ts` | SDK 通配符类型（备用） | -| `src/types/message.ts` | Message 系列类型 stub (39 types) | -| `src/types/tools.ts` | 工具进度类型 stub | -| `src/types/utils.ts` | DeepImmutable / Permutations 泛型 | -| `src/entrypoints/sdk/controlTypes.ts` | SDK 控制类型 stub | -| `src/entrypoints/sdk/runtimeTypes.ts` | SDK 运行时类型 stub | -| `src/entrypoints/sdk/coreTypes.generated.ts` | SDK 核心类型 stub | -| `src/entrypoints/sdk/settingsTypes.generated.ts` | SDK 设置类型 stub | -| `src/entrypoints/sdk/toolTypes.ts` | SDK 工具类型 stub | -| `src/entrypoints/sdk/sdkUtilityTypes.ts` | SDK 工具类型 | +| `src/entrypoints/sdk/*.ts` | SDK 类型 stub | +| `src/types/message.ts` | Message 系列类型 stub | | `scripts/create-type-stubs.mjs` | 自动 stub 生成脚本 | -| `scripts/fix-default-stubs.mjs` | 修复 `export default` stub 为命名导出 | -| `scripts/fix-missing-exports.mjs` | 补全空模块缺失的导出成员 | -| `tsconfig.json` | TypeScript 配置 | -| `package.json` | 依赖配置 | - ---- - -## 六、运行命令 - -```bash -# 检查当前错误数 -cd /Users/konghayao/code/ai/claude-code && npx tsc --noEmit 2>&1 | grep "error TS" | wc -l - -# 错误分类统计 -npx tsc --noEmit 2>&1 | grep "error TS" | sed 's/.*error //' | sed 's/:.*//' | sort | uniq -c | sort -rn - -# 重新生成 stub（修复脚本后） -node scripts/create-type-stubs.mjs - -# 修复默认导出 stub -node scripts/fix-default-stubs.mjs - -# 补全缺失导出 -node scripts/fix-missing-exports.mjs - -# 尝试构建（下一步） -bun build src/entrypoints/cli.tsx --target=node --outdir=dist -``` +| `scripts/fix-default-stubs.mjs` | 修复默认导出 stub | +| `scripts/fix-missing-exports.mjs` | 补全缺失导出 | diff --git a/src/entrypoints/cli.tsx b/src/entrypoints/cli.tsx index 795f4f2..f506dbc 100644 --- a/src/entrypoints/cli.tsx +++ b/src/entrypoints/cli.tsx @@ -1,4 +1,16 @@ -import { feature } from "bun:bundle"; +// Runtime polyfill for bun:bundle (build-time macros) +const feature = (_name: string) => false; +if (typeof globalThis.MACRO === "undefined") { + (globalThis as any).MACRO = { + VERSION: "2.1.87", + BUILD_TIME: new Date().toISOString(), + FEEDBACK_CHANNEL: "", + ISSUES_EXPLAINER: "", + NATIVE_PACKAGE_URL: "", + PACKAGE_URL: "", + VERSION_CHANGELOG: "", + }; +} // Bugfix for corepack auto-pinning, which adds yarnpkg to peoples' package.jsons // eslint-disable-next-line custom-rules/no-top-level-side-effects diff --git a/src/main.tsx b/src/main.tsx index ea51d90..718e94d 100644 --- a/src/main.tsx +++ b/src/main.tsx @@ -973,7 +973,7 @@ async function run(): Promise { // If not provided but flag is present, value will be true // The actual filtering is handled in debug.ts by parsing process.argv return true; - }).addOption(new Option('-d2e, --debug-to-stderr', 'Enable debug mode (to stderr)').argParser(Boolean).hideHelp()).option('--debug-file ', 'Write debug logs to a specific file path (implicitly enables debug mode)', () => true).option('--verbose', 'Override verbose mode setting from config', () => true).option('-p, --print', 'Print response and exit (useful for pipes). Note: The workspace trust dialog is skipped when Claude is run with the -p mode. Only use this flag in directories you trust.', () => true).option('--bare', 'Minimal mode: skip hooks, LSP, plugin sync, attribution, auto-memory, background prefetches, keychain reads, and CLAUDE.md auto-discovery. Sets CLAUDE_CODE_SIMPLE=1. Anthropic auth is strictly ANTHROPIC_API_KEY or apiKeyHelper via --settings (OAuth and keychain are never read). 3P providers (Bedrock/Vertex/Foundry) use their own credentials. Skills still resolve via /skill-name. Explicitly provide context via: --system-prompt[-file], --append-system-prompt[-file], --add-dir (CLAUDE.md dirs), --mcp-config, --settings, --agents, --plugin-dir.', () => true).addOption(new Option('--init', 'Run Setup hooks with init trigger, then continue').hideHelp()).addOption(new Option('--init-only', 'Run Setup and SessionStart:startup hooks, then exit').hideHelp()).addOption(new Option('--maintenance', 'Run Setup hooks with maintenance trigger, then continue').hideHelp()).addOption(new Option('--output-format ', 'Output format (only works with --print): "text" (default), "json" (single result), or "stream-json" (realtime streaming)').choices(['text', 'json', 'stream-json'])).addOption(new Option('--json-schema ', 'JSON Schema for structured output validation. ' + 'Example: {"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}').argParser(String)).option('--include-hook-events', 'Include all hook lifecycle events in the output stream (only works with --output-format=stream-json)', () => true).option('--include-partial-messages', 'Include partial message chunks as they arrive (only works with --print and --output-format=stream-json)', () => true).addOption(new Option('--input-format ', 'Input format (only works with --print): "text" (default), or "stream-json" (realtime streaming input)').choices(['text', 'stream-json'])).option('--mcp-debug', '[DEPRECATED. Use --debug instead] Enable MCP debug mode (shows MCP server errors)', () => true).option('--dangerously-skip-permissions', 'Bypass all permission checks. Recommended only for sandboxes with no internet access.', () => true).option('--allow-dangerously-skip-permissions', 'Enable bypassing all permission checks as an option, without it being enabled by default. Recommended only for sandboxes with no internet access.', () => true).addOption(new Option('--thinking ', 'Thinking mode: enabled (equivalent to adaptive), disabled').choices(['enabled', 'adaptive', 'disabled']).hideHelp()).addOption(new Option('--max-thinking-tokens ', '[DEPRECATED. Use --thinking instead for newer models] Maximum number of thinking tokens (only works with --print)').argParser(Number).hideHelp()).addOption(new Option('--max-turns ', 'Maximum number of agentic turns in non-interactive mode. This will early exit the conversation after the specified number of turns. (only works with --print)').argParser(Number).hideHelp()).addOption(new Option('--max-budget-usd ', 'Maximum dollar amount to spend on API calls (only works with --print)').argParser(value => { + }).addOption(new Option('--debug-to-stderr', 'Enable debug mode (to stderr)').argParser(Boolean).hideHelp()).option('--debug-file ', 'Write debug logs to a specific file path (implicitly enables debug mode)', () => true).option('--verbose', 'Override verbose mode setting from config', () => true).option('-p, --print', 'Print response and exit (useful for pipes). Note: The workspace trust dialog is skipped when Claude is run with the -p mode. Only use this flag in directories you trust.', () => true).option('--bare', 'Minimal mode: skip hooks, LSP, plugin sync, attribution, auto-memory, background prefetches, keychain reads, and CLAUDE.md auto-discovery. Sets CLAUDE_CODE_SIMPLE=1. Anthropic auth is strictly ANTHROPIC_API_KEY or apiKeyHelper via --settings (OAuth and keychain are never read). 3P providers (Bedrock/Vertex/Foundry) use their own credentials. Skills still resolve via /skill-name. Explicitly provide context via: --system-prompt[-file], --append-system-prompt[-file], --add-dir (CLAUDE.md dirs), --mcp-config, --settings, --agents, --plugin-dir.', () => true).addOption(new Option('--init', 'Run Setup hooks with init trigger, then continue').hideHelp()).addOption(new Option('--init-only', 'Run Setup and SessionStart:startup hooks, then exit').hideHelp()).addOption(new Option('--maintenance', 'Run Setup hooks with maintenance trigger, then continue').hideHelp()).addOption(new Option('--output-format ', 'Output format (only works with --print): "text" (default), "json" (single result), or "stream-json" (realtime streaming)').choices(['text', 'json', 'stream-json'])).addOption(new Option('--json-schema ', 'JSON Schema for structured output validation. ' + 'Example: {"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}').argParser(String)).option('--include-hook-events', 'Include all hook lifecycle events in the output stream (only works with --output-format=stream-json)', () => true).option('--include-partial-messages', 'Include partial message chunks as they arrive (only works with --print and --output-format=stream-json)', () => true).addOption(new Option('--input-format ', 'Input format (only works with --print): "text" (default), or "stream-json" (realtime streaming input)').choices(['text', 'stream-json'])).option('--mcp-debug', '[DEPRECATED. Use --debug instead] Enable MCP debug mode (shows MCP server errors)', () => true).option('--dangerously-skip-permissions', 'Bypass all permission checks. Recommended only for sandboxes with no internet access.', () => true).option('--allow-dangerously-skip-permissions', 'Enable bypassing all permission checks as an option, without it being enabled by default. Recommended only for sandboxes with no internet access.', () => true).addOption(new Option('--thinking ', 'Thinking mode: enabled (equivalent to adaptive), disabled').choices(['enabled', 'adaptive', 'disabled']).hideHelp()).addOption(new Option('--max-thinking-tokens ', '[DEPRECATED. Use --thinking instead for newer models] Maximum number of thinking tokens (only works with --print)').argParser(Number).hideHelp()).addOption(new Option('--max-turns ', 'Maximum number of agentic turns in non-interactive mode. This will early exit the conversation after the specified number of turns. (only works with --print)').argParser(Number).hideHelp()).addOption(new Option('--max-budget-usd ', 'Maximum dollar amount to spend on API calls (only works with --print)').argParser(value => { const amount = Number(value); if (isNaN(amount) || amount <= 0) { throw new Error('--max-budget-usd must be a positive number greater than 0');