# 书籍影响分析: v2.1.88 → v2.1.100

生成时间: 2026-04-10

> 基于 v2.1.88 完整源码 + v2.1.100 bundle 字符串信号 + sdk-tools.d.ts 精确对比

---

## 概览

| 指标 | v2.1.88 | v2.1.100 |
|------|---------|----------|
| cli.js | 12.4MB | 13.5MB (+1.1MB, +8.5%) |
| Source Map | 有 | **无** |
| Tengu 事件 | 827 | 882 (+96 / -41) |
| 环境变量 | 178 | 197 (+19 / -5) |
| sdk-tools.d.ts | 基线 | +3 处变化 |
| 新增 vendor | — | audio-capture (6 平台) |

---

## 需要更新的章节

| 章节 | 影响级别 | 变化摘要 | 建议操作 |
|------|---------|---------|---------|
| **ch16 权限系统** | **高** | sdk-tools.d.ts 新增 `"auto"` 权限模式；TRANSCRIPT_CLASSIFIER 自动审批 | 新增 Auto Mode 小节：第六种权限模式，模型自动判断工具安全性 |
| **ch16 Bash 安全** | **高** | Tree-Sitter WASM AST 解析器移除（3 事件 + 1 环境变量） | 更新 bash 安全管道：AST 分析退回 regex/shell-quote 方案 |
| **ch09 自动压缩** | **高** | 新增 cold_compact + rapid_refill_breaker + autocompact_command/dialog | 新增"冷压缩"策略；压缩对话框 UX；快速回填熔断器 |
| **ch24 记忆系统** | **高** | 全新 Dream 系统：auto_dream + kairos_dream + dream_invoked + memory_toggled | 新增"Dream 记忆整合"小节：手动/自动/定时三种触发、修剪+反思两种模式、锁机制 |
| **ch20c Ultraplan** | **高** | ultraplan_first_launch + 更完整的生命周期信号 | 补充 Ultraplan 首次启动流程和会话状态管理细节 |
| **ch06b API 通信层** | **中** | api_retry_after_too_long + Bedrock/Vertex 完整设置向导（18 个事件） | 新增 Bedrock/Vertex 交互式设置向导和模型自动升级机制 |
| **ch20 Agent 编排** | **中** | forked_agent_default_turns_exceeded + subagent_md_report_blocked + mcp_subagent_prompt | 补充代理回合限制、子代理报告阻断机制 |
| **ch10 文件状态保留** | **中** | sdk-tools.d.ts 新增 staleReadFileStateHint + tool_result_dedup | 新增文件陈旧检测 + 工具结果去重两个上下文优化机制 |
| **ch04 工具系统** | **中** | sdk-tools.d.ts 新增 toolStats 统计字段 + image_resize + bash_rerun_used | 新增会话级工具统计；图片自动缩放；命令重跑 |
| **ch18 Hooks** | **中** | hook_output_persisted + hook_prompt_transcript_truncated + stop_hook_* (3 个) | 补充钩子输出持久化、停止钩子管理生命周期 |
| **ch22 IDE/桥接** | **中** | bridge_repl 子系统 16 个事件完全移除 | 记录 Bridge REPL 到新通信机制的重大重构 |
| **附录 G 认证** | **中** | Mantle 认证后端 + Bedrock/Vertex 升级流程 | 新增 Mantle 认证后端说明 |
| **ch22b 插件系统** | **低** | PLUGIN_KEEP_MARKETPLACE_ON_FAILURE | 补充插件市场错误容错 |
| **ch23 Feature Flag** | **低** | 12+ 新实验代号事件 | 更新实验列表 |
| **ch29 可观测性** | **低** | message_rated + status_line_result | 补充用户反馈追踪信号 |
| **附录 B 环境变量** | **低** | +19 / -5 环境变量 | 更新索引表 |
| **附录 E 版本演化** | **高** | 需要新增 v2.1.100 版本记录 | 追加版本条目 |

---

## 高影响变化详细分析

### 1. Dream 记忆整合系统（ch24 重大更新）

**新增信号**：
- `tengu_dream_invoked` — 手动 `/dream` 触发
- `tengu_auto_dream_skipped` — 自动 dream 跳过（条件不满足：会话数不够等）
- `tengu_auto_dream_fired` / `_completed` / `_failed` / `_toggled` — 自动 dream 生命周期
- `tengu_kairos_dream` — 后台定时 dream（cron 调度）

**从 bundle 提取的 dream 提示词**：
1. "You are performing a dream — a pruning pass over your memory files"（修剪）
2. "You are performing a dream — a reflective pass over your memory files. Synthesize what..."（反思）
3. "Do not promote personal memories into `team/` during a dream"

**v2.1.88 架构参考**：
- `restored-src/src/services/memory/` — v2.1.88 记忆系统只有基本的 extract_memories
- Dream 是 v2.1.100 全新引入的子系统，没有 v2.1.88 对应物

**对书的影响**：ch24 需要新增完整的"Dream 记忆整合"小节（约 1500-2000 字），包含三种触发模式、两种 dream 类型、锁机制、autoDreamEnabled 设置。

---

### 2. Auto Mode 权限（ch16 重大更新）

**信号证据**：
- sdk-tools.d.ts 新增 `"auto"` 在 permission mode 枚举中
- `INTERNAL_PERMISSION_MODES` 包含 auto
- Auto mode 的行为：跳过权限检查（`if(q==="auto"||q==="bypassPermissions") return!0`）
- 使用 TRANSCRIPT_CLASSIFIER 对工具调用进行安全分类

**v2.1.88 架构参考**：
- `restored-src/src/utils/permissions/` — 5 种权限模式（default, acceptEdits, bypassPermissions, dontAsk, plan）
- v2.1.100 新增第 6 种：auto

**对书的影响**：ch16 需要将权限模式表从 5 种扩展到 6 种，新增 Auto Mode 说明小节。

---

### 3. Advisor 工具（ch21 潜在新章节）

**信号证据**：
- `tengu_advisor_command` / `_dialog_shown` — 事件追踪
- `advisorModel` 配置字段 — 可配置 advisor 模型
- 完整的 advisor 提示词（从 bundle 提取）：
  - "advisor tool backed by a stronger reviewer model"
  - "Call advisor BEFORE substantive work"
  - "Call advisor at least once before committing to an approach"
  - "If advisor points another: don't silently switch. Surface the conflict"

**对书的影响**：这是一个跨越 ch06b（API）和 ch21（Effort/Thinking）的新特性。建议在 ch21 新增 Advisor 小节。

---

### 4. Bedrock/Vertex 完整设置向导（ch06b + 附录 G）

**信号证据**：18 个新事件覆盖完整的设置和升级生命周期：
- 设置向导：`setup_started` → `setup_complete` / `setup_cancelled`
- 模型探测：`probe_result` — 验证模型 ID 可用性
- 默认模型检查：`default_check` → `default_fallback`
- 模型升级：`upgrade_check` → `upgrade_accepted` / `upgrade_declined` → `upgrade_relaunch` / `upgrade_save_failed`

**v2.1.88 架构参考**：
- `restored-src/src/services/api/bedrock.ts` — v2.1.88 只有基本 Bedrock 支持
- v2.1.100 引入完整的交互式设置向导和自动升级检测

---

### 5. Tool Result Dedup（ch10 重要更新）

**信号证据**：
```
"refer to that output" — 用短 ID 引用之前的工具结果
tengu_tool_result_dedup: hit (命中去重) / miss (未命中)
originalBytes / savedBytes — 追踪节省量
```

**对书的影响**：ch10（压缩后的文件状态保留）需要新增"工具结果去重"小节，这是一个重要的上下文优化机制。

---

### 6. Bridge REPL 重构（ch22 重大更新）

16 个 `tengu_bridge_repl_*` 事件在 v2.1.100 中完全移除，同时 `CLAUDE_CODE_REPL` 环境变量移除。这暗示 IDE 桥接通信机制经历了重大重构。

**v2.1.88 架构参考**：
- `restored-src/src/services/bridge/` — REPL 模式基于轮询的桥接
- v2.1.100 可能转向事件驱动或 WebSocket 方案

---

## 可能需要新内容的功能

| 功能 | 事件数 | 建议 |
|------|--------|------|
| Autofix PR（远程自动修复 PR） | 2 | 在 ch20c (Ultraplan) 或 ch20 中补充 |
| Team Onboarding（团队入门报告） | 3 | 在 ch20b (Teams) 中补充 |
| Perforce 版本控制支持 | 1 env var | 在 ch04 或附录中提及 |
| Audio Capture（语音输入） | 6 binary vendors | 观察后续版本，暂不写入 |
| Mantle 认证后端 | 2 env vars | 附录 G 补充 |

---

## 无需更新的章节

- ch01（技术栈概览）— 整体架构未变
- ch02（工具系统概览）— 工具列表未变
- ch03（Agent Loop）— 核心循环未变
- ch05（系统提示词架构）— 架构层级未变
- ch07（A/B 测试）— 机制未变
- ch08（工具提示词）— 模式未变
- ch13-15（缓存系统）— 核心机制未变
- ch17（YOLO 分类器）— 分类逻辑未变
- ch17b（提示注入防御）— 防御策略未变
- ch18b（沙箱系统）— 沙箱架构未变
- ch19（CLAUDE.md）— 加载机制未变
- ch25-27（经验教训）— 原则层面未变

---

## 更新优先级建议

### 第一优先级（高影响，读者最关心）
1. **ch24 记忆系统** — Dream 是全新子系统，对书的记忆章节是重大补充
2. **ch16 权限系统** — Auto Mode 是第 6 种权限模式，读者需要知道
3. **ch09 自动压缩** — 冷压缩 + 熔断器是压缩策略的重要演化
4. **附录 E 版本演化** — 需要新增 v2.1.100 条目

### 第二优先级（中影响，完善性更新）
5. **ch10 文件状态保留** — staleReadFileStateHint + tool_result_dedup
6. **ch06b API 通信层** — Bedrock/Vertex 向导
7. **ch20c Ultraplan** — 补充首次启动和生命周期
8. **ch18 Hooks** — 停止钩子和输出持久化
9. **附录 B 环境变量** — 更新索引

### 第三优先级（低影响，可选）
10. ch21 Advisor — 新特性但可能仍在实验阶段
11. ch22 IDE 桥接 — Bridge REPL 重构记录
12. ch23 Feature Flag — 实验列表更新