feat: 问就是封包

Author: claude-code-best

README.md

@@ -2,27 +2,254 @@
 
 Anthropic 官方 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 工具的源码反编译/逆向还原项目。目标是将 Claude Code 核心功能跑通，必要时删减次级能力。
 
-## 核心能力
-
-- API 通信（Anthropic SDK / Bedrock / Vertex）
-- Bash / FileRead / FileWrite / FileEdit 等核心工具
-- REPL 交互界面（ink 终端渲染）
-- 对话历史与会话管理
-- 权限系统
-- Agent / 子代理系统
-
-## 已删减模块
-
-| 模块 | 处理方式 |
-|------|----------|
-| Computer Use (`@ant/computer-use-*`) | stub |
-| 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 关闭 |
+## 能力清单
+
+> ✅ = 已实现  ⚠️ = 部分实现 / 条件启用  ❌ = stub / 移除 / feature flag 关闭
+
+### 核心系统
+
+| 能力 | 状态 | 说明 |
+|------|------|------|
+| REPL 交互界面（Ink 终端渲染） | ✅ | 主屏幕 5000+ 行，完整交互 |
+| API 通信 — Anthropic Direct | ✅ | 支持 API Key + OAuth |
+| API 通信 — AWS Bedrock | ✅ | 支持凭据刷新、Bearer Token |
+| API 通信 — Google Vertex | ✅ | 支持 GCP 凭据刷新 |
+| API 通信 — Azure Foundry | ✅ | 支持 API Key + Azure AD |
+| 流式对话与工具调用循环 (`query.ts`) | ✅ | 1700+ 行，含自动压缩、token 追踪 |
+| 会话引擎 (`QueryEngine.ts`) | ✅ | 1300+ 行，管理对话状态与归因 |
+| 上下文构建（git status / CLAUDE.md / memory） | ✅ | `context.ts` 完整实现 |
+| 权限系统（plan/auto/manual 模式） | ✅ | 6300+ 行，含 YOLO 分类器、路径验证、规则匹配 |
+| Hook 系统（pre/post tool use） | ✅ | 支持 settings.json 配置 |
+| 会话恢复 (`/resume`) | ✅ | 独立 ResumeConversation 屏幕 |
+| Doctor 诊断 (`/doctor`) | ✅ | 版本、API、插件、沙箱检查 |
+| 自动压缩 (compaction) | ✅ | auto-compact / micro-compact / API compact |
+
+### 工具 — 始终可用
+
+| 工具 | 状态 | 说明 |
+|------|------|------|
+| BashTool | ✅ | Shell 执行，沙箱，权限检查 |
+| FileReadTool | ✅ | 文件 / PDF / 图片 / Notebook 读取 |
+| FileEditTool | ✅ | 字符串替换式编辑 + diff 追踪 |
+| FileWriteTool | ✅ | 文件创建 / 覆写 + diff 生成 |
+| NotebookEditTool | ✅ | Jupyter Notebook 单元格编辑 |
+| AgentTool | ✅ | 子代理派生（fork / async / background / remote） |
+| WebFetchTool | ✅ | URL 抓取 → Markdown → AI 摘要 |
+| WebSearchTool | ✅ | 网页搜索 + 域名过滤 |
+| AskUserQuestionTool | ✅ | 多问题交互提示 + 预览 |
+| SendMessageTool | ✅ | 消息发送（peers / teammates / mailbox） |
+| SkillTool | ✅ | 斜杠命令 / Skill 调用 |
+| EnterPlanModeTool | ✅ | 进入计划模式 |
+| ExitPlanModeTool (V2) | ✅ | 退出计划模式 |
+| TodoWriteTool | ✅ | Todo 列表 v1 |
+| BriefTool | ✅ | 简短消息 + 附件发送 |
+| TaskOutputTool | ✅ | 后台任务输出读取 |
+| TaskStopTool | ✅ | 后台任务停止 |
+| ListMcpResourcesTool | ✅ | MCP 资源列表 |
+| ReadMcpResourceTool | ✅ | MCP 资源读取 |
+| SyntheticOutputTool | ✅ | 非交互会话结构化输出 |
+
+### 工具 — 条件启用
+
+| 工具 | 状态 | 启用条件 |
+|------|------|----------|
+| GlobTool | ✅ | 未嵌入 bfs/ugrep 时启用（默认启用） |
+| GrepTool | ✅ | 同上 |
+| TaskCreateTool | ⚠️ | `isTodoV2Enabled()` 为 true 时 |
+| TaskGetTool | ⚠️ | 同上 |
+| TaskUpdateTool | ⚠️ | 同上 |
+| TaskListTool | ⚠️ | 同上 |
+| EnterWorktreeTool | ⚠️ | `isWorktreeModeEnabled()` |
+| ExitWorktreeTool | ⚠️ | 同上 |
+| TeamCreateTool | ⚠️ | `isAgentSwarmsEnabled()` |
+| TeamDeleteTool | ⚠️ | 同上 |
+| ToolSearchTool | ⚠️ | `isToolSearchEnabledOptimistic()` |
+| PowerShellTool | ⚠️ | Windows 平台检测 |
+| LSPTool | ⚠️ | `ENABLE_LSP_TOOL` 环境变量 |
+| ConfigTool | ❌ | `USER_TYPE === 'ant'`（永远为 false） |
+
+### 工具 — Feature Flag 关闭（全部不可用）
+
+| 工具 | Feature Flag |
+|------|-------------|
+| SleepTool | `PROACTIVE` / `KAIROS` |
+| CronCreate/Delete/ListTool | `AGENT_TRIGGERS` |
+| RemoteTriggerTool | `AGENT_TRIGGERS_REMOTE` |
+| MonitorTool | `MONITOR_TOOL` |
+| SendUserFileTool | `KAIROS` |
+| OverflowTestTool | `OVERFLOW_TEST_TOOL` |
+| TerminalCaptureTool | `TERMINAL_PANEL` |
+| WebBrowserTool | `WEB_BROWSER_TOOL` |
+| SnipTool | `HISTORY_SNIP` |
+| WorkflowTool | `WORKFLOW_SCRIPTS` |
+| PushNotificationTool | `KAIROS` |
+| SubscribePRTool | `KAIROS_GITHUB_WEBHOOKS` |
+| ListPeersTool | `UDS_INBOX` |
+| CtxInspectTool | `CONTEXT_COLLAPSE` |
+
+### 工具 — Stub / 不可用
+
+| 工具 | 说明 |
+|------|------|
+| TungstenTool | ANT-ONLY stub |
+| REPLTool | ANT-ONLY，`isEnabled: () => false` |
+| SuggestBackgroundPRTool | ANT-ONLY，`isEnabled: () => false` |
+| VerifyPlanExecutionTool | 需 `CLAUDE_CODE_VERIFY_PLAN=true` 环境变量，且为 stub |
+| ReviewArtifactTool | stub，未注册到 tools.ts |
+| DiscoverSkillsTool | stub，未注册到 tools.ts |
+
+### 斜杠命令 — 可用
+
+| 命令 | 状态 | 说明 |
+|------|------|------|
+| `/add-dir` | ✅ | 添加目录 |
+| `/advisor` | ✅ | Advisor 配置 |
+| `/agents` | ✅ | 代理列表/管理 |
+| `/branch` | ✅ | 分支管理 |
+| `/btw` | ✅ | 快速备注 |
+| `/chrome` | ✅ | Chrome 集成 |
+| `/clear` | ✅ | 清屏 |
+| `/color` | ✅ | Agent 颜色 |
+| `/compact` | ✅ | 压缩对话 |
+| `/config` (`/settings`) | ✅ | 配置管理 |
+| `/context` | ✅ | 上下文信息 |
+| `/copy` | ✅ | 复制最后消息 |
+| `/cost` | ✅ | 会话费用 |
+| `/desktop` | ✅ | Claude Desktop 集成 |
+| `/diff` | ✅ | 显示 diff |
+| `/doctor` | ✅ | 健康检查 |
+| `/effort` | ✅ | 设置 effort 等级 |
+| `/exit` | ✅ | 退出 |
+| `/export` | ✅ | 导出对话 |
+| `/extra-usage` | ✅ | 额外用量信息 |
+| `/fast` | ✅ | 切换 fast 模式 |
+| `/feedback` | ✅ | 反馈 |
+| `/files` | ✅ | 已跟踪文件 |
+| `/heapdump` | ✅ | Heap dump（调试） |
+| `/help` | ✅ | 帮助 |
+| `/hooks` | ✅ | Hook 管理 |
+| `/ide` | ✅ | IDE 连接 |
+| `/init` | ✅ | 初始化项目 |
+| `/install-github-app` | ✅ | 安装 GitHub App |
+| `/install-slack-app` | ✅ | 安装 Slack App |
+| `/keybindings` | ✅ | 快捷键管理 |
+| `/login` / `/logout` | ✅ | 登录 / 登出 |
+| `/mcp` | ✅ | MCP 服务管理 |
+| `/memory` | ✅ | Memory / CLAUDE.md 管理 |
+| `/mobile` | ✅ | 移动端 QR 码 |
+| `/model` | ✅ | 模型选择 |
+| `/output-style` | ✅ | 输出风格 |
+| `/passes` | ✅ | 推荐码 |
+| `/permissions` | ✅ | 权限管理 |
+| `/plan` | ✅ | 计划模式 |
+| `/plugin` | ✅ | 插件管理 |
+| `/pr-comments` | ✅ | PR 评论 |
+| `/privacy-settings` | ✅ | 隐私设置 |
+| `/rate-limit-options` | ✅ | 限速选项 |
+| `/release-notes` | ✅ | 更新日志 |
+| `/reload-plugins` | ✅ | 重载插件 |
+| `/remote-env` | ✅ | 远程环境配置 |
+| `/rename` | ✅ | 重命名会话 |
+| `/resume` | ✅ | 恢复会话 |
+| `/review` | ✅ | 代码审查（本地） |
+| `/ultrareview` | ✅ | 云端审查 |
+| `/rewind` | ✅ | 回退对话 |
+| `/sandbox-toggle` | ✅ | 切换沙箱 |
+| `/security-review` | ✅ | 安全审查 |
+| `/session` | ✅ | 会话信息 |
+| `/skills` | ✅ | Skill 管理 |
+| `/stats` | ✅ | 会话统计 |
+| `/status` | ✅ | 状态信息 |
+| `/statusline` | ✅ | 状态栏 UI |
+| `/stickers` | ✅ | 贴纸 |
+| `/tasks` | ✅ | 任务管理 |
+| `/theme` | ✅ | 终端主题 |
+| `/think-back` | ✅ | 年度回顾 |
+| `/upgrade` | ✅ | 升级 CLI |
+| `/usage` | ✅ | 用量信息 |
+| `/insights` | ✅ | 使用分析报告 |
+| `/vim` | ✅ | Vim 模式 |
+
+### 斜杠命令 — Feature Flag 关闭
+
+| 命令 | Feature Flag |
+|------|-------------|
+| `/voice` | `VOICE_MODE` |
+| `/proactive` | `PROACTIVE` / `KAIROS` |
+| `/brief` | `KAIROS` / `KAIROS_BRIEF` |
+| `/assistant` | `KAIROS` |
+| `/bridge` | `BRIDGE_MODE` |
+| `/remote-control-server` | `DAEMON` + `BRIDGE_MODE` |
+| `/force-snip` | `HISTORY_SNIP` |
+| `/workflows` | `WORKFLOW_SCRIPTS` |
+| `/web-setup` | `CCR_REMOTE_SETUP` |
+| `/subscribe-pr` | `KAIROS_GITHUB_WEBHOOKS` |
+| `/ultraplan` | `ULTRAPLAN` |
+| `/torch` | `TORCH` |
+| `/peers` | `UDS_INBOX` |
+| `/fork` | `FORK_SUBAGENT` |
+| `/buddy` | `BUDDY` |
+
+### 斜杠命令 — ANT-ONLY（不可用）
+
+`/tag` `/backfill-sessions` `/break-cache` `/bughunter` `/commit` `/commit-push-pr` `/ctx_viz` `/good-claude` `/issue` `/init-verifiers` `/mock-limits` `/bridge-kick` `/version` `/reset-limits` `/onboarding` `/share` `/summary` `/teleport` `/ant-trace` `/perf-issue` `/env` `/oauth-refresh` `/debug-tool-call` `/agents-platform` `/autofix-pr`
+
+### CLI 子命令
+
+| 子命令 | 状态 | 说明 |
+|--------|------|------|
+| `claude`（默认） | ✅ | 主 REPL / 交互 / print 模式 |
+| `claude mcp serve/add/remove/list/get/...` | ✅ | MCP 服务管理（7 个子命令） |
+| `claude auth login/status/logout` | ✅ | 认证管理 |
+| `claude plugin validate/list/install/...` | ✅ | 插件管理（7 个子命令） |
+| `claude setup-token` | ✅ | 长效 Token 配置 |
+| `claude agents` | ✅ | 代理列表 |
+| `claude doctor` | ✅ | 健康检查 |
+| `claude update` / `upgrade` | ✅ | 自动更新 |
+| `claude install [target]` | ✅ | Native 安装 |
+| `claude server` | ❌ | `DIRECT_CONNECT` flag |
+| `claude ssh <host>` | ❌ | `SSH_REMOTE` flag |
+| `claude open <cc-url>` | ❌ | `DIRECT_CONNECT` flag |
+| `claude auto-mode` | ❌ | `TRANSCRIPT_CLASSIFIER` flag |
+| `claude remote-control` | ❌ | `BRIDGE_MODE` + `DAEMON` flag |
+| `claude assistant` | ❌ | `KAIROS` flag |
+| `claude up/rollback/log/error/export/task/completion` | ❌ | ANT-ONLY |
+
+### 服务层
+
+| 服务 | 状态 | 说明 |
+|------|------|------|
+| API 客户端 (`services/api/`) | ✅ | 3400+ 行，4 个 provider |
+| MCP (`services/mcp/`) | ✅ | 24 个文件，12000+ 行 |
+| OAuth (`services/oauth/`) | ✅ | 完整 OAuth 流程 |
+| 插件 (`services/plugins/`) | ✅ | 基础设施完整，无内置插件 |
+| LSP (`services/lsp/`) | ⚠️ | 实现存在，默认关闭 |
+| 压缩 (`services/compact/`) | ✅ | auto / micro / API 压缩 |
+| Hook 系统 (`services/tools/toolHooks.ts`) | ✅ | pre/post tool use hooks |
+| 会话记忆 (`services/SessionMemory/`) | ✅ | 会话记忆管理 |
+| 记忆提取 (`services/extractMemories/`) | ✅ | 自动记忆提取 |
+| Skill 搜索 (`services/skillSearch/`) | ✅ | 本地/远程 skill 搜索 |
+| 策略限制 (`services/policyLimits/`) | ✅ | 策略限制执行 |
+| 分析 / GrowthBook / Sentry | ⚠️ | 框架存在，实际 sink 为空 |
+| Voice (`services/voice.ts`) | ❌ | `VOICE_MODE` flag 关闭 |
+
+### 内部包 (`packages/`)
+
+| 包 | 状态 | 说明 |
+|------|------|------|
+| `color-diff-napi` | ✅ | 997 行完整 TypeScript 实现（语法高亮 diff） |
+| `audio-capture-napi` | ❌ | stub，`isNativeAudioAvailable()` 返回 false |
+| `image-processor-napi` | ❌ | stub，`getNativeModule()` 返回 null |
+| `modifiers-napi` | ❌ | stub，`isModifierPressed()` 返回 false |
+| `url-handler-napi` | ❌ | stub，`waitForUrlEvent()` 返回 null |
+| `@ant/claude-for-chrome-mcp` | ❌ | stub，`createServer()` 返回 null |
+| `@ant/computer-use-mcp` | ❌ | stub，`buildTools()` 返回 [] |
+| `@ant/computer-use-input` | ❌ | stub，仅类型声明 |
+| `@ant/computer-use-swift` | ❌ | stub，仅类型声明 |
+
+### Feature Flags（30 个，全部返回 `false`）
+
+`ABLATION_BASELINE` `AGENT_MEMORY_SNAPSHOT` `BG_SESSIONS` `BRIDGE_MODE` `BUDDY` `CCR_MIRROR` `CCR_REMOTE_SETUP` `CHICAGO_MCP` `COORDINATOR_MODE` `DAEMON` `DIRECT_CONNECT` `EXPERIMENTAL_SKILL_SEARCH` `FORK_SUBAGENT` `HARD_FAIL` `HISTORY_SNIP` `KAIROS` `KAIROS_BRIEF` `KAIROS_CHANNELS` `KAIROS_GITHUB_WEBHOOKS` `LODESTONE` `MCP_SKILLS` `PROACTIVE` `SSH_REMOTE` `TORCH` `TRANSCRIPT_CLASSIFIER` `UDS_INBOX` `ULTRAPLAN` `UPLOAD_USER_SETTINGS` `VOICE_MODE` `WEB_BROWSER_TOOL` `WORKFLOW_SCRIPTS`
 
 ## 快速开始
 

package.json

@@ -1,15 +1,18 @@
 {
-    "name": "claude-code",
+    "name": "claude-js",
     "version": "1.0.0",
-    "private": true,
     "type": "module",
     "workspaces": [
         "packages/*",
         "packages/@ant/*"
     ],
+    "files": [
+        "dist"
+    ],
     "scripts": {
         "build": "bun build src/entrypoints/cli.tsx --outdir dist --target bun",
-        "dev": "bun run src/entrypoints/cli.tsx"
+        "dev": "bun run src/entrypoints/cli.tsx",
+        "prepublishOnly": "bun run build"
     },
     "dependencies": {
         "@alcalzone/ansi-tokenize": "^0.3.0",

packages/color-diff-napi/src/index.ts

@@ -30,7 +30,7 @@ import { basename, extname } from 'path'
 // pushed later tests in the same shard into GC-pause territory and a
 // beforeEach/afterEach hook timeout (officialRegistry.test.ts, PR #24150).
 // Same lazy pattern the NAPI wrapper used for dlopen.
-type HLJSApi = typeof hljsNamespace
+type HLJSApi = typeof hljsNamespace.default
 let cachedHljs: HLJSApi | null = null
 function hljs(): HLJSApi {
   if (cachedHljs) return cachedHljs

src/bootstrap/state.ts

@@ -1755,4 +1755,4 @@ export function getPromptId(): string | null {
 export function setPromptId(id: string | null): void {
   STATE.promptId = id
 }
-export type isReplBridgeActive = any;
+export function isReplBridgeActive(): boolean { return false; }

src/cli/handlers/auth.ts

@@ -159,7 +159,7 @@ export async function authLogin({
 
       const orgResult = await validateForceLoginOrg()
       if (!orgResult.valid) {
-        process.stderr.write(orgResult.message + '\n')
+        process.stderr.write((orgResult as { valid: false; message: string }).message + '\n')
         process.exit(1)
       }
 
@@ -209,7 +209,7 @@ export async function authLogin({
 
     const orgResult = await validateForceLoginOrg()
     if (!orgResult.valid) {
-      process.stderr.write(orgResult.message + '\n')
+      process.stderr.write((orgResult as { valid: false; message: string }).message + '\n')
       process.exit(1)
     }
 

src/cli/handlers/mcp.tsx

@@ -178,9 +178,9 @@ export async function mcpListHandler(): Promise<void> {
         // biome-ignore lint/suspicious/noConsole:: intentional console output
         console.log(`${name}: ${server.url} - ${status}`);
       } else if (!server.type || server.type === 'stdio') {
-        const args = Array.isArray(server.args) ? server.args : [];
+        const args = Array.isArray((server as any).args) ? (server as any).args : [];
         // biome-ignore lint/suspicious/noConsole:: intentional console output
-        console.log(`${name}: ${server.command} ${args.join(' ')} - ${status}`);
+        console.log(`${name}: ${(server as any).command} ${args.join(' ')} - ${status}`);
       }
     }
   }

src/cli/print.ts

@@ -1243,7 +1243,7 @@ function runHeadlessStreaming(
           uuid: crumb.uuid,
           timestamp: crumb.timestamp,
           isReplay: true,
-        } satisfies SDKUserMessageReplay)
+        } as SDKUserMessageReplay)
       }
     }
   }
@@ -1980,7 +1980,7 @@ function runHeadlessStreaming(
                   parent_tool_use_id: null,
                   uuid: c.uuid as string,
                   isReplay: true,
-                } satisfies SDKUserMessageReplay)
+                } as SDKUserMessageReplay)
               }
             }
           }
@@ -2265,8 +2265,8 @@ function runHeadlessStreaming(
                 output.enqueue({
                   type: 'system' as const,
                   subtype: 'files_persisted' as const,
-                  files: result.persistedFiles,
-                  failed: result.failedFiles,
+                  files: (result as any).persistedFiles,
+                  failed: (result as any).failedFiles,
                   processed_at: new Date().toISOString(),
                   uuid: randomUUID(),
                   session_id: getSessionId(),

src/cli/transports/ccrClient.ts

@@ -375,7 +375,7 @@ export class CCRClient {
         if (!result.ok) {
           throw new RetryableError(
             'client event POST failed',
-            result.retryAfterMs,
+            (result as any).retryAfterMs,
           )
         }
       },
@@ -398,7 +398,7 @@ export class CCRClient {
         if (!result.ok) {
           throw new RetryableError(
             'internal event POST failed',
-            result.retryAfterMs,
+            (result as any).retryAfterMs,
           )
         }
       },
@@ -427,7 +427,7 @@ export class CCRClient {
           'delivery batch',
         )
         if (!result.ok) {
-          throw new RetryableError('delivery POST failed', result.retryAfterMs)
+          throw new RetryableError('delivery POST failed', (result as any).retryAfterMs)
         }
       },
       baseDelayMs: 500,