书籍影响分析: 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 提示词：
- "You are performing a dream — a pruning pass over your memory files"（修剪）
- "You are performing a dream — a reflective pass over your memory files. Synthesize what..."（反思）
- "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（经验教训）— 原则层面未变
更新优先级建议
第一优先级（高影响，读者最关心）
- ch24 记忆系统 — Dream 是全新子系统，对书的记忆章节是重大补充
- ch16 权限系统 — Auto Mode 是第 6 种权限模式，读者需要知道
- ch09 自动压缩 — 冷压缩 + 熔断器是压缩策略的重要演化
- 附录 E 版本演化 — 需要新增 v2.1.100 条目
第二优先级（中影响，完善性更新）
- ch10 文件状态保留 — staleReadFileStateHint + tool_result_dedup
- ch06b API 通信层 — Bedrock/Vertex 向导
- ch20c Ultraplan — 补充首次启动和生命周期
- ch18 Hooks — 停止钩子和输出持久化
- 附录 B 环境变量 — 更新索引
第三优先级（低影响，可选）
- ch21 Advisor — 新特性但可能仍在实验阶段
- ch22 IDE 桥接 — Bridge REPL 重构记录
- ch23 Feature Flag — 实验列表更新