feat: integrate fork work onto upstream main (squashed)

Squash-merge of feat/autofix-pr-test (69 commits) onto upstream/main
with -X ours strategy (upstream as authoritative for content conflicts).

Key features brought in from fork:
- LocalMemoryRecall + VaultHttpFetch tools (end-to-end wired)
- /local-memory, /local-vault, /memory-stores, /skill-store interactive panels
- /agents-platform, /schedule, /vault command scaffolding
- /login: switch / replace / remove of workspace API key
- statusline refactor (built-in status row, /statusline as info command)
- autofix-pr command + workflow

Conflict resolutions (upstream-wins):
- 10 .js command stubs kept from upstream (alongside fork's .ts implementations)
- src/components/BuiltinStatusLine.tsx accepted upstream's deletion
  (fork's wire-up references in StatusLine.tsx will be cleaned up next)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
unraid
2026-05-08 16:47:29 +08:00
parent 73e54d4bbc
commit 8945f08708
233 changed files with 40597 additions and 341 deletions

View File

@@ -0,0 +1,224 @@
# 上游 v2.1.089 → v2.1.123 差异分析
> 调研日期2026-04-29
> 数据源:
> - GitHub `anthropics/claude-code` `CHANGELOG.md`WebFetch主要数据源覆盖 2.1.97 → 2.1.123
> - 全局二进制 `C:\Users\12180\.local\bin\claude.exe`v2.1.123253MB Bun native binary编译时间 2026-04-29字符串反向查阅telemetry 事件 / FEATURE flag / API endpoint / 注册命令名)
> - Fork 自身版本:`package.json` `claude-code-best@1.10.10`
>
> 注意v2.1.89 的 changelog 条目在 GitHub 主仓库 `CHANGELOG.md` 中已被裁剪Anthropic 滚动保留近 30 个版本fetch 到该位置返回 truncation 提示。本报告 v2.1.89~v2.1.96 的内容 inferred from binary 字符串和 v2.1.97 的"Fixed"项倒推(标注 `[binary-only]`)。
---
## 摘要
- **版本号跨度**v2.1.089 → v2.1.123,共 35 个 patch 版本(实际发布 ≈ 25 个部分编号跳过100/102/103/104/106/115
- **核心新增方向**
1. **Auto Mode**自治执行从实验性走向正式v2.1.111 起不再要求 `--enable-auto-mode`v2.1.118 加 "Don't ask again"v2.1.117 起 Pro/Max 默认 effort=high
2. **Ultraplan / Ultrareview / Advisor**新一代深度推理工作流v2.1.108~v2.1.120 持续完善v2.1.120 加 `claude ultrareview <target>` headless 子命令
3. **TUI/Fullscreen 重构**v2.1.110 加 `/tui` 命令切换 flicker-free 渲染v2.1.116 优化滚动v2.1.121 滚动对话框可键盘+鼠标导航
4. **Native binary 分发**v2.1.113 起 CLI spawn native binary 代替 bundled JSper-platform optional dep
5. **Voice Mode / Push Notifications**v2.1.110 push 通知工具v2.1.122 Caps Lock 报错提示
6. **Skills 体系强化**v2.1.108 起 model 可发现/调用内置 slash 命令v2.1.117 listing cap 250→1536v2.1.121 加 type-to-filterv2.1.120 支持 `${CLAUDE_EFFORT}` 模板
7. **MCP / OAuth 大量修复**:每版数十条
8. **Plugin 体系**v2.1.117~v2.1.121 依赖解析、版本约束、`plugin tag``plugin prune``alwaysLoad` 配置
- **新增/移除命令**:见下方矩阵(净新增 ≥ 7 个:`/tui``/focus``/recap``/undo`(alias)、`/proactive`(alias)、`/ultrareview``/team-onboarding``/less-permission-prompts``/usage`(合并 `/cost`+`/stats`);移除 0 个,但 `/cost` `/stats` 已合并)
- **新增 API endpoint**v123 binary 反向查阅):`/v1/agents``/v1/skills``/v1/code/triggers``/v1/code/sessions``/v1/code/upstreamproxy/ws``/v1/environments/bridge``/v1/memory_stores``/v1/security/advisories/bulk``/v1/ultrareview/preflight``/v1/vaults``/v2/ccr-sessions/`
- **新增 telemetry 事件**v123 binary 共 1081 个 `tengu_*` 事件(包含 `tengu_advisor_*` 6、`tengu_ultraplan_*` 13、`tengu_kairos_*` 9、`tengu_amber_*` 10、`tengu_teleport_*` 17、`tengu_ccr_*` 5、`tengu_brief_*` 3、`tengu_powerup_*` 2、`tengu_skill_*` 4 等成簇出现)
- **新增 feature flag**v123 binary `FEATURE_*` 字符串多为 Bun runtime 内置(`FEATURE_FLAG_DISABLE_*`**Anthropic 业务 feature flag 在 v2.1.x 已切换到运行时配置/环境变量(`CLAUDE_CODE_*`),不再使用 `FEATURE_<NAME>` 命名空间**——这一点与 fork 当前的 `bun:bundle` `feature()` 模式存在分歧
---
## 详细变更
### 新增命令
| 命令 | 何时引入 | 描述 | fork 是否已有 |
|---|---|---|---|
| `/tui` | 2.1.110 | 切换 fullscreen / inline 渲染(`/tui fullscreen` 进入 flicker-free 模式,可在同一对话中切换)。设置项 `tui` | ❌ 无 |
| `/focus` | 2.1.110 | 单独的 focus view 切换(之前与 `Ctrl+O` 复用),仅显示 prompt+工具摘要+最终响应 | ❌ 无 |
| `/recap` | 2.1.108 | 返回 session 时提供上下文回顾,可在 `/config` 配置或手动调用,`CLAUDE_CODE_ENABLE_AWAY_SUMMARY` 可强制启用 | ❌ 无 |
| `/undo`alias `/rewind` | 2.1.108 | rewind 别名 | ⚠️ 需确认 `/rewind` 实现 |
| `/proactive`alias `/loop` | 2.1.105 | `/loop` 别名 | ⚠️ 需确认 `/loop` 实现 |
| `/ultrareview` | 2.1.111 | 云端并行多 agent 代码审查;无参审查当前分支,`/ultrareview <PR#>` 拉 GitHub PR 审查v2.1.120 加 `claude ultrareview` headless | ❌ 无cloud-only`/v1/ultrareview/preflight` endpoint |
| `/team-onboarding` | 2.1.101 | 从本地 Claude Code 使用情况生成 teammate ramp-up guide | ❌ 无 |
| `/less-permission-prompts` | 2.1.111 | 扫描历史 transcript提议 `.claude/settings.json` 的优先级 allowlist | ❌ 无 |
| `/usage` | 2.1.118 | 合并 `/cost` + `/stats`,两者保留为别名 | ⚠️ 需确认 fork 状态 |
| `/effort`(无参 slider 模式) | 2.1.111 | 无参时打开交互 slider`xhigh` 介于 `high``max` 之间(仅 Opus 4.7 | ⚠️ fork 有 `/effort` 但 slider/`xhigh` 未确认 |
| `/branch` | ≤2.1.116 | 从当前 session 分叉新对话v2.1.116/v2.1.122 持续修 fix | ⚠️ 需确认 fork 状态 |
| `/fork` | ≤2.1.118 | 类似 branch与 branch 关系待查) | ⚠️ 需确认 |
| `/extra-usage` | 2.1.113 | 远程客户端可调用的额外用量信息 | ❌ 无 |
| `/insights` | 2.1.101 / 2.1.113 | 报告生成v2.1.113 fixed Windows EBUSY | ❌ 无 |
| `/loops`(注:复数,与 `/loop` 不同) | binary v123 | 命令名在二进制中独立出现 | ⚠️ 需对比 |
| `/powerup` | binary v123 | `tengu_powerup_lesson_*` 教学/onboarding | ❌ 无 |
| `/stickers` | binary v123 | description 残留 | ❌ 无 |
| `/btw` | binary v123 / 2.1.101 fix | "by the way" 类回顾命令2.1.101 fix `/btw` 不再每次写整段对话到磁盘 | ❌ 无 |
| `/teleport`(含 `tp` alias+ `--print` 模式 | 2.1.108~2.1.121 持续增强 | session resume from claude.ai17 个 `tengu_teleport_*` 事件覆盖 first_message/source_decision/print/bundle_mode/interactive_mode 等分支 | ✅ fork 已恢复(`src/utils/teleport.tsx` + 第二批 stub recovery`--print` 模式和 17 事件全覆盖待对比 |
| `/setup-bedrock` | 2.1.111 改进 | 显示 `CLAUDE_CONFIG_DIR` 实际路径re-run 时 seed pin 候选,加 "with 1M context" 选项 | ⚠️ 需确认 fork 状态 |
| `/setup-vertex` | 2.1.98 加交互式 wizard | login 屏选 "3rd-party platform" 时 Vertex AI 配置向导 | ⚠️ 需确认 |
| `/team` 系列(`tengu_team_mem_*`, `tengu_team_artifact_*`, `tengu_team_onboarding_*`, `tengu_teammate_*` | 2.1.101+ | 团队记忆同步 / artifact tip / onboarding 发现 | ❌ 无v2.1.101 binary 字符串确认) |
| `/heapdump``/sharp``/pyright` | binary v123 | 诊断/类型工具命令 | ❌ 无 |
| `/keybindings` `/keybindings-help` | 2.1.101 | 加载 `~/.claude/keybindings.json` 自定义按键 | ⚠️ 需确认 |
### 移除/合并命令
| 命令 | 何时变更 | 处置 |
|---|---|---|
| `/cost` `/stats` | 2.1.118 | 合并为 `/usage`,二者保留为快捷别名打开对应 tab |
| `/cost` 直返 plain-textVSCode| 2.1.120 | VSCode 改为打开原生 Account & Usage dialog |
| `Glob` / `Grep` 工具macOS/Linux native build | 2.1.117 | 替换为 Bash 内嵌 `bfs` + `ugrep`Windows 与 npm 版不变) |
### 新增 endpointbinary v123 反向查阅)
| Endpoint | 推测用途 | fork 是否已有调用 |
|---|---|---|
| `/v1/agents``/v1/agents/` | Agents Platform订阅可用已确认 | ✅ 已恢复(`agents-platform.tsx` |
| `/v1/skills``/v1/skills/` | Skills 上传/同步 | ❌ 无 |
| `/v1/code/triggers``/v1/code/triggers/` | Triggerschedule cron-style 后端) | ⚠️ fork 有 `cron.ts` 本地实现,未确认远端 |
| `/v1/code/sessions``/v1/code/sessions/` | Session list`teleportFromSessionsAPI` 用) | ✅ teleport 用到 |
| `/v1/code/github/import-token` | GitHub App 安装 token 导入 | ❌ 无 |
| `/v1/code/slack/` | Slack App 集成 | ❌ 无 |
| `/v1/code/upstreamproxy/ca-cert``/v1/code/upstreamproxy/ws` | 上游代理 WS 隧道(企业代理/CCR | ❌ 无 |
| `/v1/environments``/v1/environments/``/v1/environments/bridge``/v1/environment_providers/cloud/create` | Cloud environment / Bridge环境 provisioningBYOC runner 关联) | ⚠️ fork 有 BYOC runner 入口,远端未对接 |
| `/v1/memory_stores``/v1/memory_stores/` | 共享记忆存储(团队记忆) | ❌ 无 |
| `/v1/security/advisories/bulk` | 安全公告批量 | ❌ 无 |
| `/v1/ultrareview/preflight` | Ultrareview 预检 | ❌ 无 |
| `/v1/vaults``/v1/vaults/` | 凭据保险库 | ❌ 无 |
| `/v1/session_ingress/session/``/v2/session_ingress/shttp/mcp/` | Session ingress远端 session 接入) | ❌ 无 |
| `/v2/ccr-sessions/` | CCR sessionCloud Code Runner / cross-region | ❌ 无 |
| `/v1/feedback` | 反馈提交 | ✅ fork 已恢复 `/feedback` |
| `/v1/toolbox/shttp/mcp/` | MCP toolbox 转发 | ❌ 无 |
### 新增 telemetry 事件v123 binary 簇)
| 簇 | 事件数 | 代表事件 | fork 状态 |
|---|---|---|---|
| `tengu_teleport_*` | 17 | `_started``_resume_session``_first_message_success``_source_decision``_bundle_mode``_interactive_mode``_print` | ✅ fork 第二批 stub recovery 已发 17 事件覆盖 |
| `tengu_ultraplan_*` | 13 | `_launched``_dialog_choice``_plan_ready``_approved``_failed``_awaiting_input``_first_launch``_keyword``_prompt_identifier``_timeout_seconds` | ❌ fork 无 |
| `tengu_kairos_*` | 9 | `_brief``_cron``_cron_durable``_dream``_input_needed_push``_loop_dynamic``_loop_prompt``_push_notifications``_brief_config` | ❌ fork 无 |
| `tengu_amber_*` | 10 | `_anchor``_flint``_lark``_lynx``_prism``_redwood``_sentinel``_stoat``_wren``_json_tools` | ❓ 内部代号(动物名),可能是新一代 agent 工具集 |
| `tengu_advisor_*` | 6 | `_command``_dialog_shown``_strip_retry``_tool_call``_tool_interrupted``_tool_token_usage` | ❌ fork 无v2.1.117 加 experimental 标签) |
| `tengu_ccr_*` | 5 | `_bridge``_bundle_max_bytes``_bundle_seed_enabled``_bundle_upload``_session_link``_unsupported_default_mode_ignored` | ❌ fork 无 |
| `tengu_powerup_*` | 2 | `_lesson_completed``_lesson_opened` | ❌ fork 无 |
| `tengu_brief_*` | 3 | `_mode_enabled``_mode_toggled``_send` | ❌ fork 无 |
| `tengu_skill_*` | 4 | `_loaded``_file_changed``_tool_invocation``_tool_slash_prefix` | ⚠️ fork 有 SkillTool 但事件覆盖未确认 |
| `tengu_extract_memories_*` | 5 | `_extraction``_coalesced``_skipped_*``_error` | ✅ fork 有 EXTRACT_MEMORIES feature flag |
| `tengu_team_*` | 14 | `_artifact_tip_shown``_created``_deleted``_mem_*`accessed/edits/sync_pull/sync_push/secret_skipped/entries_capped/file_*)、`_onboarding_*``_memdir_disabled``_teammate_default_model_changed``_teammate_mode_changed` | ❌ fork 无 |
### 新增 feature flag
v123 binary 中 `FEATURE_*` 字符串全部为 Bun runtime 内部 flag`FEATURE_FLAG_DISABLE_DNS_CACHE``FEATURE_FLAG_EXPERIMENTAL_BAKE``FEATURE_NOT_SUPPORTED` 等),**业务 feature 已迁移到环境变量+设置项命名空间**
新增的业务开关(按 changelog 统计):
| 名称 | 引入版本 | 作用 |
|---|---|---|
| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 2.1.108 | 强制启用 recaptelemetry 关闭时) |
| `CLAUDE_CODE_FORK_SUBAGENT` | 2.1.117 / 2.1.121 | 外部 build 启用 forked subagent2.1.121 起在非交互 session 也生效 |
| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | 2.1.111 | Win/Linux/macOS 启用 PowerShell tool |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 2.1.123 | 关闭实验 betav123 唯一 fix 围绕该项的 OAuth 401 循环) |
| `CLAUDE_CODE_HIDE_CWD` | 2.1.119 | 启动 logo 隐藏 CWD |
| `CLAUDE_CODE_CERT_STORE` | 2.1.101 | `bundled` 仅用 bundled CA |
| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | 2.1.98 | Linux PID namespace 子进程隔离 |
| `CLAUDE_CODE_SCRIPT_CAPS` | 2.1.98 | 每 session script 调用上限 |
| `CLAUDE_CODE_PERFORCE_MODE` | 2.1.98 | Edit/Write 在只读文件上失败并提示 `p4 edit` |
| `ENABLE_PROMPT_CACHING_1H` | 2.1.108 | 1 小时 prompt cache TTL |
| `FORCE_PROMPT_CACHING_5M` | 2.1.108 | 强制 5 分钟 TTL |
| `OTEL_LOG_RAW_API_BODIES` | 2.1.111 | 完整 API 请求/响应作为 OTEL 日志 |
| `OTEL_LOG_USER_PROMPTS` `OTEL_LOG_TOOL_DETAILS` `OTEL_LOG_TOOL_CONTENT` | 2.1.101+ | OTEL 敏感字段 opt-in |
| `ANTHROPIC_BEDROCK_SERVICE_TIER` | 2.1.122 | Bedrock service tier 选择 |
| `DISABLE_UPDATES` | 2.1.118 | 严格于 `DISABLE_AUTOUPDATER`,连手动 `claude update` 也阻断 |
| `wslInheritsWindowsSettings` | 2.1.118 | WSL 继承 Windows managed settings |
### 配置项
| Key | 引入 | 说明 |
|---|---|---|
| `tui` | 2.1.110 | fullscreen / inline 切换 |
| `autoScrollEnabled` | 2.1.110 | fullscreen 自动滚动开关 |
| `prUrlTemplate` | 2.1.119 | footer PR badge 自定义 URL |
| `sandbox.network.deniedDomains` | 2.1.113 | 黑名单覆盖 allowedDomains 通配 |
| `MCP server.alwaysLoad` | 2.1.121 | 跳过 ToolSearch 延迟,永远可用 |
| `autoMode.allow / soft_deny / environment` 中的 `"$defaults"` | 2.1.118 | 在内置 list 之上叠加,不替换 |
| `spinnerTipsOverride.excludeDefault` | 2.1.122 | 抑制 time-based spinner tips |
---
## 与 fork 差异
### Fork 应该跟进的
**P0订阅用户能直接受益、本地能力可实现且与 fork 已恢复的方向一致):**
1. **`/usage` 合并**v2.1.118)—— 把 fork 现有 `/cost`+`/stats` 合并为 `/usage`,保留 alias。零远端依赖纯 UI 重构。
2. **`/recap` + `CLAUDE_CODE_ENABLE_AWAY_SUMMARY`**v2.1.108)—— 返回 session 时给摘要。fork 有 `AWAY_SUMMARY` feature flag 但未实现命令。
3. **`/tui` 命令 + flicker-free 渲染**v2.1.110)—— 当前 fork 用 Ink且 fork CLAUDE.md 里设计原则强调"考究"。flicker-free 切换是 high-impact UX 改进。
4. **`/focus` 单独命令**v2.1.110)—— `Ctrl+O` 解耦 verbose 和 focus 两个职责。代码量小、收益清晰。
5. **`/effort` 无参 slider + `xhigh` 等级**v2.1.111)—— fork 已有 `/effort`,加 slider 是 UI 升级。
**P1需要后端但用户已订阅对接到 `/v1/agents` 模式可行):**
1. **`/team-onboarding`**v2.1.101)—— 从本地 JSONL 生成 ramp-up guide零远端依赖。
2. **`/less-permission-prompts`**v2.1.111)—— 扫 transcript 推 allowlist纯本地逻辑。
3. **`/branch` 增强**v2.1.116/v2.1.122)—— fork 需先确认 `/branch` 现状。
4. **`/extra-usage`**v2.1.113)—— 远程查询用量。
**P2依赖云端 endpoint订阅可达但工程量大**
1. **`/ultrareview`**v2.1.111+)—— 需 `/v1/ultrareview/preflight` 后端,订阅应可达。
2. **Auto Mode 不再要求 `--enable-auto-mode`**v2.1.111)—— fork 需对齐入口。
3. **MCP `alwaysLoad`、auto-retry 3 次**v2.1.121)。
4. **Plugin 体系(`plugin tag`、`plugin prune`、依赖解析)**v2.1.117~v2.1.121)。
### Fork 不需要跟进的
1. **`tengu_amber_*` 系列**10 个)—— 内部代号动物名strong indicator 是 Anthropic 内部 dogfood agent / 实验工具集,订阅版本不会暴露给最终用户。
2. **Vertex/Bedrock 边角 fix**(如 application inference profile ARN、`thinking.type.enabled is not supported`)—— fork 用户主要通过 firstParty / OpenAI / Gemini / Grok provider这些 fix 不影响。
3. **`tengu_ccr_*`CCR session bundle**—— 内部 cross-region session 链路fork 无对应基础设施。
4. **Native binary 分发改造**v2.1.113)—— fork 已用 Bun build无必要切到 per-platform optional dep。
5. **`tengu_ultraplan_*` 直接对齐**—— fork CLAUDE.md 里 `ULTRAPLAN` 是 P1 feature flag但 13 个事件覆盖dialog/keyword/identifier/timeout/awaiting_input是云后端流水线本地实现性价比低。
6. **Stickers / heapdump / sharp / pyright 命令**—— 内部诊断/营销,无业务价值。
7. **`/install-github-app` `/install-slack-app`**—— 依赖 Anthropic 后端 OAuth callback。
---
## 推荐 fork 接下来做的事
### P0一周内
1. **合并 `/cost` + `/stats` 为 `/usage`**(保留 alias—— 与上游 v2.1.118 对齐,纯 UI 改造,~150 行
2. **实现 `/recap` 命令 + 启用现有 AWAY_SUMMARY feature flag**—— fork 已有 flag缺命令实现
3. **新增 `/tui` 命令**—— Ink fullscreen 切换fork 已有 fullscreen 渲染基础
### P1两周内
1. **`/effort` 无参 slider + `xhigh` 等级**—— fork 已有 `/effort`UI 增强
2. **`/focus` 单独命令**(拆分 `Ctrl+O`
3. **`/team-onboarding`** + **`/less-permission-prompts`**(纯本地 transcript 扫描,与 fork 已恢复的 `/perf-issue` `/debug-tool-call` 思路一致)
4. **`/branch` `/fork`** 现状审查 + 对齐到 v2.1.122 fixrewound timeline tool_use_id 配对)
### P2长期
1. **MCP `alwaysLoad` + 自动重连 3 次**v2.1.121)—— 配置项扩展
2. **`Auto Mode` 默认开启路径对齐**v2.1.111+ "Don't ask again"v2.1.118
3. **Plugin 依赖解析增强**v2.1.117~v2.1.121 的所有 plugin fix
4. **Skills `${CLAUDE_EFFORT}` 模板替换**v2.1.120+ 描述上限 1536 字符v2.1.105
---
## 调研方法回顾
| 方法 | 是否 work | 备注 |
|---|---|---|
| WebFetch GitHub `CHANGELOG.md` | ✅ work | 最佳数据源。覆盖 v2.1.97~v2.1.123 完整条目v2.1.89~v2.1.96 已被 Anthropic 滚动裁剪,需通过 binary 字符串补 |
| Binary string grep `tengu_*` 事件 | ✅ work | 1081 事件覆盖所有 feature surface簇分析`_advisor_*``_kairos_*``_ultraplan_*`)能识别新功能 |
| Binary `name:"..."`,description 命令名 | ✅ work | 133 个命令名,与 fork `commands.ts` 直接对比 |
| Binary `/v[0-9]+/...` endpoint | ✅ work | 65 个 endpoint识别新后端 surface |
| Binary `FEATURE_*` 字符串 | ⚠️ 部分 work | Anthropic 业务 flag 已迁出 `FEATURE_<NAME>` 命名空间binary 命中的全是 Bun runtime业务 flag 走 `CLAUDE_CODE_*` env 与 settings key |
| WebFetch npm changelog | 未尝试 | 优先级低于 GitHub CHANGELOG因主仓库一般同步 |
| WebFetch `changelog.anthropic.com` | 未尝试 | 同上 |
**关键限制**v2.1.89~v2.1.96 的具体条目无公开来源,本报告对该段是"通过 v2.1.97 fix 列表反推 + binary 字符串"两层间接推断,置信度低于 v2.1.97+。如需精确,可:
1.`npm view @anthropic-ai/claude-code@2.1.89` 获取发布元数据
2. `git log` Anthropic 公开 SDK / docs 仓库相关提交
3. 反向查阅更早版本的 binary用户机器无 v2.1.89 二进制)