# Claude Code 版本差异报告

## v2.1.88 → v2.1.100

生成时间: 2026-04-10

---

## 概览

| 指标 | v2.1.88 | v2.1.100 | 变化 |
|------|---------|----------|------|
| cli.js 大小 | 13,047,043 bytes | 13,468,528 bytes | +421,485 bytes (+3.2%) |
| Source Map | 有 | **无** | 已移除 |
| Tengu 事件数 | 827 | 882 | +96 / -41 |
| 环境变量数 | 178 | 197 | +19 / -5 |
| sdk-tools.d.ts | 基线 | +3 处变化 | 新增 toolStats, auto mode, staleReadFileStateHint |
| 新增 vendor | — | audio-capture (6 平台) | 全新二进制模块 |

---

## 1. Tengu 事件变化

### 新增事件 (+96)

#### Advisor 系统（全新 — 2 个事件）
- `tengu_advisor_command` — advisor 命令触发
- `tengu_advisor_dialog_shown` — advisor 对话框展示

#### Dream 系统 / 记忆整合（全新 — 6 个事件）
- `tengu_dream_invoked` — dream 手动触发
- `tengu_auto_dream_skipped` — 自动 dream 跳过（条件不满足）
- `tengu_kairos_dream` — 后台定时 dream 任务
- `tengu_extract_memories_skipped_no_prose` — 无散文内容跳过记忆提取
- `tengu_memory_toggled` — 记忆开关切换

#### Ultraplan（远程多代理规划 — 6 个事件）
- `tengu_ultraplan_config` — ultraplan 配置读取
- `tengu_ultraplan_first_launch` — 首次启动
- `tengu_ultraplan_keyword` — 关键字触发
- `tengu_ultraplan_prompt_identifier` — 提示词标识符
- `tengu_ultraplan_stopped` — ultraplan 停止
- `tengu_ultraplan_timeout_seconds` — 超时配置

#### Autofix PR（全新 — 2 个事件）
- `tengu_autofix_pr_started` — 自动修复 PR 启动
- `tengu_autofix_pr_result` — 自动修复 PR 结果

#### Team Onboarding（全新 — 3 个事件）
- `tengu_team_onboarding_invoked` — 团队入门报告触发
- `tengu_team_onboarding_generated` — 报告生成完成
- `tengu_team_onboarding_discovery_shown` — 发现引导展示

#### Bedrock 云平台设置与升级（全新 — 9 个事件）
- `tengu_bedrock_setup_started` / `_complete` / `_cancelled` — 设置向导
- `tengu_bedrock_default_check` / `_fallback` — 默认模型检查/回退
- `tengu_bedrock_probe_result` — 模型探测结果
- `tengu_bedrock_upgrade_accepted` / `_check` / `_declined` / `_relaunch` / `_save_failed` — 模型升级流程

#### Vertex 云平台设置与升级（全新 — 9 个事件）
- `tengu_vertex_setup_started` / `_complete` / `_cancelled` — 设置向导
- `tengu_vertex_default_check` / `_fallback` — 默认模型检查/回退
- `tengu_vertex_probe_result` — 模型探测结果
- `tengu_vertex_upgrade_accepted` / `_check` / `_declined` / `_relaunch` / `_save_failed` — 模型升级流程

#### 压缩系统增强（4 个事件）
- `tengu_cold_compact` — 冷压缩触发
- `tengu_auto_compact_rapid_refill_breaker` — 快速回填熔断器
- `tengu_autocompact_command` — 手动 `/compact` 命令
- `tengu_autocompact_dialog_opened` — 压缩确认对话框

#### 工具系统（5 个事件）
- `tengu_bash_allowlist_strip_all` — bash 白名单全清除
- `tengu_bash_rerun_used` — bash 命令重跑
- `tengu_tool_result_dedup` — 工具结果去重（重复内容引用）
- `tengu_image_resize` — 图片自动缩放处理
- `tengu_file_read_reread` — 文件重复读取检测

#### 钩子系统（4 个事件）
- `tengu_hook_output_persisted` — 钩子输出持久化
- `tengu_hook_prompt_transcript_truncated` — 钩子提示词转录截断
- `tengu_stop_hook_added` / `_command` / `_removed` — 停止钩子管理

#### 代理系统（3 个事件）
- `tengu_forked_agent_default_turns_exceeded` — 代理默认回合超限
- `tengu_mcp_subagent_prompt` — MCP 子代理提示词
- `tengu_subagent_md_report_blocked` — 子代理 CLAUDE.md 报告阻断

#### OAuth/Auth（3 个事件）
- `tengu_oauth_bedrock_wizard_launched` — Bedrock OAuth 向导启动
- `tengu_oauth_platform_docs_opened` — 平台文档打开
- `tengu_oauth_vertex_wizard_launched` — Vertex OAuth 向导启动

#### 其他功能（6 个事件）
- `tengu_api_retry_after_too_long` — API 重试等待过长
- `tengu_ccr_session_link` — CCR 会话链接
- `tengu_chain_timestamp_fallback` — 链时间戳回退
- `tengu_edit_minimalanchor_jrn` — 编辑最小锚点
- `tengu_message_rated` — 消息评分
- `tengu_noreread_q` / `tengu_sub_nomdrep_q` — 读取优化实验
- `tengu_powerup_lesson_completed` / `_opened` — 学习系统
- `tengu_pre_tool_hook_deferred` — 前置钩子延迟
- `tengu_rate_limit_lever_hint` — 限速杠杆提示
- `tengu_rate_limit_options_menu_select_team` — 限速选项菜单团队选择
- `tengu_resume_return_action` — 恢复返回动作
- `tengu_status_line_result` — 状态行结果
- `tengu_velvet_anchor` — 实验信号

#### 实验性代号事件（12 个）
- `tengu_amber_lark` / `_redwood` / `_sentinel` / `_swift`
- `tengu_basalt_kite` / `tengu_billiard_aviary`
- `tengu_cedar_inlet` / `tengu_coral_beacon`
- `tengu_flint_harbor` / `_harbor_prompt` / `_heron`
- `tengu_garnet_loom` / `_plover`
- `tengu_gleaming_fair` / `tengu_gypsum_kite`
- `tengu_onyx_basin_m` / `tengu_pyrite_wren`
- `tengu_shale_finch` / `tengu_slate_finch` / `_reef`
- `tengu_willow_prism`

### 删除事件 (-41)

#### Bridge REPL 子系统重构（16 个事件完全移除）
- `tengu_bridge_repl_*` 全系列（ccr_v, env_expired, env_lost, env_registered, fatal_error, history_capped, poll_error, poll_give_up, reconnect_failed, reconnected_in_place, session_failed, suspension_detected, work_received, work_secret_failed）
- `tengu_bridge_initial_history_cap`
- `tengu_bridge_session_timeout`

#### Tree-Sitter 安全子系统（3 个事件移除）
- `tengu_tree_sitter_load` / `_security_divergence` / `_shadow`
- `tengu_bash_security_check_triggered`

#### 其他移除
- `tengu_attribution_header` — 归属头
- `tengu_compact_streaming_retry` — 压缩流式重试
- `tengu_pid_based_version_locking` — PID 版本锁
- `tengu_session_tag_*` (3 个) — 会话标签
- `tengu_skill_improvement_survey` — 技能改进调查
- `tengu_sm_compact` — SM 压缩
- `tengu_snip_resume_filtered` — 片段恢复过滤
- `tengu_tool_search_unsupported_models` — 工具搜索不支持模型
- 多个实验代号事件（cobalt_frost, copper_bridge, hawthorn_window, marble_sandcastle, quartz_lantern 等）

---

## 2. 环境变量变化

### 新增 (+19)

| 变量 | 推断用途 |
|------|---------|
| `CLAUDE_CODE_AGENT_COST_STEER` | 代理成本引导控制 |
| `CLAUDE_CODE_DISABLE_CLAUDE_API_SKILL` | 禁用 Claude API 技能 |
| `CLAUDE_CODE_EXECPATH` | 可执行文件路径 |
| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 最大上下文 token 数覆盖 |
| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | MCP 服务器白名单环境变量 |
| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 版本控制支持 |
| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | 插件市场失败保留 |
| `CLAUDE_CODE_REMOTE_SETTINGS_PATH` | 远程设置路径 |
| `CLAUDE_CODE_RESUME_THRESHOLD_MINUTES` | 会话恢复时间阈值 |
| `CLAUDE_CODE_RESUME_TOKEN_THRESHOLD` | 会话恢复 token 阈值 |
| `CLAUDE_CODE_SANDBOXED` | 沙箱状态标识 |
| `CLAUDE_CODE_SCRIPT_CAPS` | 脚本能力限制 |
| `CLAUDE_CODE_SIMULATE_PROXY_USAGE` | 模拟代理用量 |
| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | 跳过 Anthropic AWS 认证 |
| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | 跳过快速模式组织检查 |
| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | 跳过 Mantle 认证 |
| `CLAUDE_CODE_TEAM_ONBOARDING` | 团队入门功能 |
| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | 使用 Anthropic AWS |
| `CLAUDE_CODE_USE_MANTLE` | 使用 Mantle 认证后端 |

### 删除 (-5)

| 变量 | 原用途 |
|------|-------|
| `CLAUDE_CODE_DISABLE_COMMAND_INJECTION_CHECK` | 命令注入检查禁用（tree-sitter 移除后无需） |
| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | 鼠标点击禁用 |
| `CLAUDE_CODE_MCP_INSTR_DELTA` | MCP 指令差异 |
| `CLAUDE_CODE_REPL` | REPL 模式（bridge_repl 重构后移除） |
| `CLAUDE_CODE_SAVE_HOOK_ADDITIONAL_CONTEXT` | 保存钩子附加上下文 |

---

## 3. sdk-tools.d.ts 变化

### 3.1 新增 `toolStats` 字段

```typescript
toolStats?: {
  readCount: number;
  searchCount: number;
  bashCount: number;
  editFileCount: number;
  linesAdded: number;
  linesRemoved: number;
  otherToolCount: number;
};
```

会话级工具使用统计，可用于成本估算、行为分析。

### 3.2 新增 `"auto"` 权限模式

```diff
- mode?: "acceptEdits" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+ mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";
```

Auto 模式：使用 TRANSCRIPT_CLASSIFIER 自动审批工具执行，无需用户确认。

### 3.3 新增 `staleReadFileStateHint` 字段

```typescript
/**
 * Model-facing note listing readFileState entries whose mtime bumped
 * during this command (set when WRITE_COMMAND_MARKERS matches)
 */
staleReadFileStateHint?: string;
```

工具执行期间检测文件 mtime 变化，向模型提示陈旧读取状态。

### 3.4 `originalFile` 放宽为可空

```diff
- originalFile: string;
+ originalFile: string | null;
```

---

## 4. 新增 vendor 二进制：audio-capture

v2.1.100 新增 `vendor/audio-capture/` 目录，包含 6 个平台的原生音频捕获模块：
- arm64-darwin, arm64-linux, arm64-win32
- x64-darwin, x64-linux, x64-win32

文件大小 438KB-510KB 不等。暗示可能的语音输入或音频处理能力。

---

## 5. 新增 Mantle 认证后端

从模型映射表中发现 `mantle` 作为新的认证后端：
- 部分模型（如 claude-haiku-4-5）支持 mantle 映射
- 通过 `CLAUDE_CODE_USE_MANTLE` 环境变量启用
- 通过 `CLAUDE_CODE_SKIP_MANTLE_AUTH` 跳过
- Mantle 使用 `anthropic.` 前缀的模型 ID（如 `anthropic.claude-haiku-4-5`）

---

## 6. 模型版本更新

从 bundle 中提取的模型映射表显示以下新模型支持：
- `claude-sonnet-4-6` (所有平台)
- `claude-opus-4-6` (所有平台)
- `claude-opus-4-5-20251101`
- `claude-opus-4-1-20250805`
- `claude-sonnet-4-5-20250929`

---

## 7. Bridge REPL 子系统重大重构

v2.1.88 到 v2.1.100 之间，`bridge_repl` 子系统经历了完整重构：
- 16 个 `tengu_bridge_repl_*` 事件全部移除
- `CLAUDE_CODE_REPL` 环境变量移除
- 推断：IDE 桥接从 REPL 轮询模型转向更高效的通信机制

---

## 8. 关键新功能详细分析

### 8.1 Advisor 工具（服务端 advisor）

从 bundle 中提取的 advisor 工具提示词：
- 使用更强的 reviewer 模型（如 Opus 4.6 审阅 Sonnet 4.6 的工作）
- 无参数调用 — 自动转发整个对话历史
- 规则："在实质性工作之前调用 advisor"、"提交前至少调用一次"
- 如果 advisor 结果与已有数据冲突，要求"表面化冲突，而非静默切换"

### 8.2 Dream 系统（记忆整合）

v2.1.100 引入完整的 "dream" 记忆整合系统：
- 手动触发（`/dream`）+ 自动触发（`auto_dream`）+ 后台定时（`kairos_dream`）
- 两种 dream 类型：修剪（pruning pass）和反思（reflective pass）
- 支持团队记忆（`team/` 目录）与个人记忆的分离
- 锁机制防止并发 dream 冲突
- 可通过设置开关（`autoDreamEnabled`）

### 8.3 Tool Result Dedup（工具结果去重）

新增工具结果去重机制：
- 检测重复的工具调用结果
- 用短引用 ID（如 `r1`, `r2`）替换重复内容
- 追踪节省的字节数（`savedBytes`）
- 有效减少上下文消耗

### 8.4 Autofix PR（自动修复 PR）

全新的远程代理任务类型：
- 生成远程 Claude Code 会话监控和自动修复 PR
- 支持分支重用（`reuseOutcomeBranch`）
- 与 ultraplan、ultrareview 并列为远程代理任务类型

### 8.5 Perforce 版本控制支持

新增 Perforce 工作区检测和支持：
- 通过 `.p4config` 文件或 `P4PORT` 环境变量检测
- 添加 Perforce 模式提示词（只读文件需要 `p4 edit` 打开）
- 与 git、mercurial、svn、jujutsu、sapling 并列

---

## 增量分析: v2.1.92 → v2.1.100

### 新增事件 (+45)
主要新增领域：
1. **Bedrock/Vertex 完整设置与升级向导**（18 个事件）— 云平台设置从手动配置转向交互式向导
2. **Dream 系统扩展**（auto_dream_skipped, dream_invoked, kairos_dream）
3. **Autofix PR**（2 个事件）
4. **Team Onboarding**（3 个事件）
5. **Ultraplan 扩展**（first_launch）
6. 多个新实验代号

### 删除事件 (-21)
1. **Bridge REPL 完全移除**（16 个事件）— v2.1.92 仍在，v2.1.100 完全清除
2. 多个短命实验代号移除

### 新增环境变量 (+8)
- `CLAUDE_CODE_MAX_CONTEXT_TOKENS` — 用户可覆盖最大上下文
- `CLAUDE_CODE_MCP_ALLOWLIST_ENV` — MCP 白名单
- `CLAUDE_CODE_PERFORCE_MODE` — Perforce 支持
- `CLAUDE_CODE_SANDBOXED` — 沙箱标识
- `CLAUDE_CODE_TEAM_ONBOARDING` — 团队入门
- `CLAUDE_CODE_USE_MANTLE` / `SKIP_MANTLE_AUTH` — Mantle 认证

### sdk-tools.d.ts 增量变化
- 新增 `toolStats` 统计字段（v2.1.92 没有）
- `originalFile` 从 `string` 改为 `string | null`