feat: 完成stub

Author: claude-code-best

RECORD.md

@@ -52,23 +52,32 @@
 |------|--------|------|
 | 初始状态 | ~1800 | 仅缺少 npm 依赖的 TS2307 错误 |
 | 补全依赖后 | ~1800 | npm 包已安装，开始处理类型 |
-| 当前状态 | **2123** | 类型 stub 已创建，但存在质量待修问题 |
-
-### 当前错误分布
-
-| 错误码 | 数量 | 含义 |
-|--------|------|------|
-| TS2693 | 727 | `export type X` 被当作值使用（应为 `export const/function`） |
-| TS2339 | 537 | 属性不存在（类型收窄、unknown 类型） |
-| TS2614 | 468 | 模块只有默认导出，但代码用命名导入 |
-| TS2322 | 128 | 类型不匹配 |
-| TS2345 | 57 | 参数类型不匹配 |
-| TS2300 | 34 | 重复标识符（stub 文件中 export 重复） |
-| TS2307 | 29 | 仍有缺失模块 |
-| TS2305 | 28 | 缺失导出成员 |
-| TS2724 | 21 | 导出名称不匹配（如 HookEvent vs HOOK_EVENTS） |
-| TS2367 | 17 | 比较类型无交集（`"external" === "ant"` 等） |
-| 其他 | ~100 | TS2578/TS2315/TS2365/TS2741 等 |
+| 第一轮 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) — 私有包声明不够详细
+
+**继续逐个修复类型错误的投入产出比很低。应该改变方向，尝试直接构建运行。**
 
 ---
 
@@ -126,111 +135,84 @@
 - 自动创建 `export type X = any` stub
 - 已生成 **1206 个 stub 文件，覆盖 2067 个命名导出**
 
----
-
-## 三、当前问题分析
-
-### 3.1 TS2693 (727 个) — `export type` 被当作值使用 ⚠️ 关键
-
-**原因**: `scripts/create-type-stubs.mjs` 统一使用 `export type X = any` 生成 stub，但代码中很多地方将导入的名称作为**值**使用（如调用函数、渲染 JSX 组件等）。
-
-**示例**:
-
-```typescript
-// stub 中: export type performLogout = any
-// 实际使用: performLogout()  // TS2693: only refers to a type, but is being used as a value
-```
-
-**修复方案**: 将 `export type X = any` 改为 `declare const X: any` 或 `export const X: any`。需要区分哪些是纯类型、哪些是值/函数/组件。
+### 2.5 第二轮修复 — 默认导出 & 缺失导出 (本次会话)
 
-### 3.2 TS2614 (468 个) — 模块只有默认导出
+#### `scripts/fix-default-stubs.mjs` — 修复 120 个 `export default {} as any` 的 stub 文件
 
-**原因**: 部分 stub 文件使用 `export default {} as any`（早期手动创建），但代码用命名导入 `import { Message } from ...`。
+- 扫描源码中所有 import 语句，区分 `import type {}` vs `import {}`
+- 将纯类型导出为 `export type X = any`，值导出为 `export const X: any = (() => {}) as any`
+- **效果**: TS2614 从 632 → 0 (完全消除)
 
-**示例**: `src/types/message.ts` 当前内容为 `export default {} as any`，但代码 `import type { Message } from '../types/message.js'`
+#### `scripts/fix-missing-exports.mjs` — 补全空模块的导出成员
 
-**修复方案**: 将默认导出改为命名导出。
+- 解析 TS2339 中 `typeof import("...")` 的错误，给 81 个模块添加了 147 个缺失导出
+- 解析 TS2305 添加了 10 个缺失导出
+- 解析 TS2724 添加了 4 个命名不匹配的导出
+- 创建了 2 个新 stub 文件修复 TS2307
 
-### 3.3 TS2300 (34 个) — 重复标识符
+#### 泛型类型修复
 
-**原因**: stub 文件中有 `export type X = any` 行，同时源文件中也存在同名定义，造成冲突。部分 stub 文件路径不正确（如 `src/components/CustomSelect/select.ts` 既有真实代码又有 stub 导出）。
+将以下类型从非泛型改为泛型（修复 86 个 TS2315）：
 
-**修复方案**: 检查这些文件，如果真实文件存在则删除 stub 中的重复导出。
+- `DeepImmutable<T>`, `Permutations<T>` (`src/types/utils.ts`)
+- `AttachmentMessage<T>`, `ProgressMessage<T>`, `NormalizedAssistantMessage<T>` (`src/types/message.ts` 及其多个副本)
+- `WizardContextValue<T>` (`src/components/wizard/types.ts`)
 
-### 3.4 TS2339 (537 个) — 属性不存在
+#### 语法修复
 
-**原因**: `any` 类型的 stub 过于宽松时可以正常工作，但部分地方类型收窄后（如联合类型判别、`unknown` 类型）无法访问属性。
+修复 4 个 `export const default` 非法语法（buddy/fork/peers/workflows 的 index.ts）
 
-**分类**:
+---
 
-- 内部代码中 `unknown` 类型需要类型断言（源码问题）
-- `McpServerConfigForProcessTransport` 等类型定义过窄（stub 精度问题）
-- `{ ok: true } | { ok: false; error: string }` 联合类型访问 `.error`（源码惯用模式）
+## 三、当前问题分析
 
-**修复方案**: 调整相关 stub 类型定义使其更精确。
+### 3.1 剩余错误已触达 "源码级" 地板
 
-### 3.5 TS2307 (29 个) — 仍有缺失模块
+剩余 ~1341 个错误绝大多数不是 stub 缺失问题，而是源码本身的类型问题：
 
-主要是路径解析问题产生的重复 stub（如 `src/cli/src/` 下的文件已被删除）以及一些深度嵌套的相对路径。
+- **unknown (344)**: 反编译代码中大量 `unknown` 类型变量直接访问属性
+- **never (121)**: 联合类型穷尽后的 never 路径（通常是 switch/if-else 的 exhaustive check）
+- **{} (52)**: 空对象类型
+- **类型比较 (106 TS2367)**: 编译时死代码如 `"external" === "ant"`
+- **类型不匹配 (210 TS2322 + 134 TS2345)**: stub 类型不够精确
 
-### 3.6 路径问题
+### 3.2 继续修类型错误的问题
 
-部分 stub 文件被错误创建在 `src/cli/src/` 等嵌套路径下（因为 `import { X } from 'src/something'` 从 `src/cli/handlers/auth.ts` 解析时路径计算错误）。已手动删除部分重复文件，但可能仍有残留。
+1. **投入产出比极低** — 每个 TS2339/TS2322 都需要理解具体上下文
+2. **Bun bundler 不强制要求零 TS 错误** — Bun 可以在有类型错误的情况下成功构建
+3. **大部分是运行时无影响的类型问题** — `unknown as any` 等模式不影响实际执行
 
 ---
 
-## 四、后续处理方案
-
-### Phase 1: 修复脚本 — 区分类型导出 vs 值导出 (预计解决 ~1200 个错误)
-
-改进 `scripts/create-type-stubs.mjs`：
-
-1. **分析 import 语句上下文**：
-   - `import type { X }` → 纯类型，用 `export type X = any`
-   - `import { X }` (无 type) → 可能是值，用 `export const X: any = (() => {}) as any`
-   - JSX 组件（大写开头 + 在 JSX 中使用）→ `export const X: React.FC<any> = () => null`
-
-2. **分析使用上下文**：
-   - `X()` 调用 → 函数/值导出
-   - `<X />` → React 组件
-   - `X.property` → 对象/命名空间
-
-### Phase 2: 修复默认导出问题 (预计解决 ~468 个 TS2614)
+## 四、后续方向建议
 
-将所有 `export default {} as any` 的 stub 文件替换为带命名导出的版本：
+### 方向 A: 直接尝试 `bun build` 构建 ⭐ 推荐
 
-```typescript
-// 之前
-export default {} as any
+Bun bundler 对类型错误比 tsc 宽容得多。应该直接尝试构建：
 
-// 之后 — 根据导入需求
-export type Message = any
-export type NormalizedUserMessage = any
-// ... 等
+```bash
+bun build src/entrypoints/cli.tsx --target=node --outdir=dist
 ```
 
-### Phase 3: 清理冲突和路径问题 (预计解决 ~34 个 TS2300 + 29 个 TS2307)
-
-1. 检查所有带 `TS2300` 错误的文件，删除与真实代码冲突的 stub
-2. 清理 `src/cli/src/`、`src/components/*/src/` 等错误路径下的 stub 残留
-3. 修复 `tsconfig.json` 的 `paths` 配置，确保 `src/*` 映射正确
+遇到的构建错误才是真正需要修的问题（缺失模块、语法错误等），而非类型错误。
 
-### Phase 4: 精化关键类型定义 (预计解决 ~100+ 个 TS2322/TS2345)
+### 方向 B: 在 tsconfig 中进一步放宽
 
-对高频使用的类型提供更精确的定义：
-
-1. **SDK 消息类型** — 使 `type` 字段为字面量联合类型，而非 `string`
-2. **McpServerConfig** — 改为联合类型（stdio | sse | http | sse-ide）
-3. **HookInput** 系列 — 添加 `hook_event_name` 字面量类型
-4. **PermissionResult** — 改为判别联合 `allow | deny`
+```json
+{
+  "compilerOptions": {
+    "strict": false,
+    "noImplicitAny": false,
+    "strictNullChecks": false
+  }
+}
+```
 
-### Phase 5: 处理源码级别的类型问题 (需评估)
+已经是 `strict: false`，但可以进一步添加 `"skipLibCheck": true`（已有）。
 
-这些是源码本身的问题，不属于 stub 范畴：
+### 方向 C: 批量 `// @ts-nocheck`
 
-- `TS2367`: `"external" === "ant"` — 构建时消除的死代码
-- `TS2339`: 联合类型属性访问 — 需要类型收窄或断言
-- `TS2322`: 类型字面量不匹配（如 `"result"` vs `"result_success"`）
+对有大量源码级类型错误的文件加 `// @ts-nocheck`，快速消除错误。
 
 ---
 
@@ -242,13 +224,18 @@ export type NormalizedUserMessage = any
 | `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 工具类型 |
 | `scripts/create-type-stubs.mjs` | 自动 stub 生成脚本 |
+| `scripts/fix-default-stubs.mjs` | 修复 `export default` stub 为命名导出 |
+| `scripts/fix-missing-exports.mjs` | 补全空模块缺失的导出成员 |
 | `tsconfig.json` | TypeScript 配置 |
 | `package.json` | 依赖配置 |
 
@@ -265,4 +252,13 @@ npx tsc --noEmit 2>&1 | grep "error TS" | sed 's/.*error //' | sed 's/:.*//' | s
 
 # 重新生成 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
 ```

package.json

@@ -4,7 +4,7 @@
     "private": true,
     "type": "module",
     "scripts": {
-        "build": "bun build src/entrypoints/cli.ts --outdir dist --target bun",
+        "build": "bun build src/entrypoints/cli.tsx --outdir dist --target bun",
         "dev": "bun run --watch src/entrypoints/cli.tsx"
     },
     "dependencies": {

scripts/create-type-stubs.mjs

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * Analyzes TypeScript errors and creates stub modules with proper named exports.
+ * Run: node scripts/create-type-stubs.mjs
+ */
+import { execSync } from 'child_process';
+import { writeFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+
+const ROOT = '/Users/konghayao/code/ai/claude-code';
+
+// Run tsc and capture errors (tsc exits non-zero on type errors, that's expected)
+let errors;
+try {
+  errors = execSync('npx tsc --noEmit 2>&1', { encoding: 'utf-8', cwd: ROOT });
+} catch (e) {
+  errors = e.stdout || '';
+}
+
+// Map: resolved file path -> Set of needed named exports
+const stubExports = new Map();
+// Map: resolved file path -> Set of needed default export names
+const defaultExports = new Map();
+
+for (const line of errors.split('\n')) {
+  // TS2614: Module '"X"' has no exported member 'Y'. Did you mean to use 'import Y from "X"' instead?
+  let m = line.match(/error TS2614: Module '"(.+?)"' has no exported member '(.+?)'\. Did you mean to use 'import .* from/);
+  if (m) {
+    const [, mod, member] = m;
+    if (!defaultExports.has(mod)) defaultExports.set(mod, new Set());
+    defaultExports.get(mod).add(member);
+    continue;
+  }
+
+  // TS2305: Module '"X"' has no exported member 'Y'
+  m = line.match(/error TS2305: Module '"(.+?)"' has no exported member '(.+?)'/);
+  if (m) {
+    const [, mod, member] = m;
+    if (!stubExports.has(mod)) stubExports.set(mod, new Set());
+    stubExports.get(mod).add(member);
+  }
+
+  // TS2724: '"X"' has no exported member named 'Y'. Did you mean 'Z'?
+  m = line.match(/error TS2724: '"(.+?)"' has no exported member named '(.+?)'/);
+  if (m) {
+    const [, mod, member] = m;
+    if (!stubExports.has(mod)) stubExports.set(mod, new Set());
+    stubExports.get(mod).add(member);
+  }
+
+  // TS2306: File 'X' is not a module
+  m = line.match(/error TS2306: File '(.+?)' is not a module/);
+  if (m) {
+    const filePath = m[1];
+    if (!stubExports.has(filePath)) stubExports.set(filePath, new Set());
+  }
+
+  // TS2307: Cannot find module 'X'
+  m = line.match(/^(.+?)\(\d+,\d+\): error TS2307: Cannot find module '(.+?)'/);
+  if (m) {
+    const [srcFile, mod] = [m[1], m[2]];
+    if (mod.endsWith('.md')) continue;
+    if (!mod.startsWith('.') && !mod.startsWith('src/')) continue;
+    // Will be resolved below
+    const srcDir = dirname(srcFile);
+    const resolved = join(ROOT, srcDir, mod).replace(/\.js$/, '.ts');
+    if (resolved.startsWith(ROOT + '/') && !existsSync(resolved)) {
+      if (!stubExports.has(resolved)) stubExports.set(resolved, new Set());
+    }
+  }
+}
+
+// Also parse actual import statements from source files to find what's needed
+import { readFileSync } from 'fs';
+const allSourceFiles = execSync('find src -name "*.ts" -o -name "*.tsx"', { encoding: 'utf-8', cwd: ROOT }).trim().split('\n');
+
+for (const file of allSourceFiles) {
+  const content = readFileSync(join(ROOT, file), 'utf-8');
+  const srcDir = dirname(file);
+
+  // Find all import { X, Y } from 'module'
+  const importRegex = /import\s+(?:type\s+)?\{([^}]+)\}\s+from\s+['"](.+?)['"]/g;
+  let match;
+  while ((match = importRegex.exec(content)) !== null) {
+    const members = match[1].split(',').map(s => s.trim().split(/\s+as\s+/)[0].trim()).filter(Boolean);
+    let mod = match[2];
+    if (!mod.startsWith('.') && !mod.startsWith('src/')) continue;
+    
+    const resolved = join(ROOT, srcDir, mod).replace(/\.js$/, '.ts');
+    if (resolved.startsWith(ROOT + '/') && !existsSync(resolved)) {
+      if (!stubExports.has(resolved)) stubExports.set(resolved, new Set());
+      for (const member of members) {
+        stubExports.get(resolved).add(member);
+      }
+    }
+  }
+}
+
+// Now create/update all stub files
+let created = 0;
+for (const [filePath, exports] of stubExports) {
+  const relPath = filePath.replace(ROOT + '/', '');
+  const dir = dirname(filePath);
+  
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+
+  const lines = ['// Auto-generated type stub — replace with real implementation'];
+  
+  for (const exp of exports) {
+    lines.push(`export type ${exp} = any;`);
+  }
+  
+  // Check if there are default exports needed
+  for (const [mod, defs] of defaultExports) {
+    // Match the module path
+    const modNorm = mod.replace(/\.js$/, '').replace(/^src\//, '');
+    const filePathNorm = relPath.replace(/\.ts$/, '');
+    if (modNorm === filePathNorm || mod === relPath) {
+      for (const def of defs) {
+        lines.push(`export type ${def} = any;`);
+      }
+    }
+  }
+  
+  // Ensure at least export {}
+  if (exports.size === 0) {
+    lines.push('export {};');
+  }
+
+  writeFileSync(filePath, lines.join('\n') + '\n');
+  created++;
+}
+
+console.log(`Created/updated ${created} stub files`);
+console.log(`Total named exports resolved: ${[...stubExports.values()].reduce((a, b) => a + b.size, 0)}`);