跳转至

FDE 实战：Echo 与 Delta 的交付之道

引言与使用指南

本书定位： FDE（Forward Deployed Engineer，前沿部署工程师）能力培养的实战训练教科书。它教你"怎么练、怎么交付"——角色分工、实验闭环、成果验收，并把与课程主体紧密相关的方法论直接讲透，独立可读。 FDE-101（方法论大全）： 《AI 时代的 FDE》见 https://www.cloudzun.com/fde-course/ ——它讲"为什么、体系是什么"的完整方法论。本书与它是同源不同书：课程紧密相关的内容直接写入本书，相关性不紧密的、或想往深读的，只以"FDE-101 + 章节名称"形式给一个链接，不作为本书正文。

关于本书内容性质

本书正文中的交付方法论框架（四阶段与 Stage Gate、Echo/Delta 分工、能力回注四步法、本体建模等）为教材提炼，用于教学与实战训练，不代表任何厂商的官方术语或官方流程；Palantir 等厂商的实践仅作参照。凡给出外部链接的内容，以链接所指的官方页面为准；涉及型号、价格、许可证等易变数据，正文给出查阅位置，落地前请自行核对官方最新发布。

你想清楚的问题 → 读本书还是 FDE-101

想清楚的问题 读哪 到哪
FDE 本质、价值、最佳实践、Echo/Delta 分工、Echo 怎么干活 本书 第 1–6 章（图表配套）
FDE 完整方法论 SOP、团队管理、中国落地、财务全数据 FDE-101 https://www.cloudzun.com/fde-course/
怎么把需求做出来、把 Demo 跑通 本书 全部实操章
政务/企业私有化落地的红线清单 本书 + FDE-101 交叉 本书红线条 + FDE-101相关章节

四条交付红线

  1. 数据不出域——政务红线，决定私有化选型；
  2. 答案可追溯——RAG / 政务 AI 准入门槛；
  3. 敏感件零漏判——Agent 验收的硬指标（宁可多升级，不可漏）；
  4. 人做判断，AI 负责执行——Echo/Delta 分工哲学，不是"AI 越强人越省事"。

Note

课堂模拟数据与真实客户数据 本书全部实操使用课堂模拟数据——完全虚构、脱敏、无真实个人信息，可按教学要求使用公网 API。真实客户数据必须按数据分类分级、组织制度和监管要求在获批安全域内处理，不得先进入公网服务再事后补救。

后续各实操章的验收口径、反模式、能力回注决策，都围绕这四条红线展开。

读者画像与使用方式

本书同时面向两类读者：服务提供方（乙方 / 独立服务商） 与 甲方内部服务交付团队（如银行总行科技部、政务信息中心）。

读者 本书怎么用
乙方 / 独立服务商 第 1–5 章建立交付方法论与角色共识；第 6、8、10、12、16 章以五个项目实操训练可交付能力；第 13–14 章支撑私有化选型与生产化，第 15 章价值论证
甲方内部交付团队 第 2–5 章对齐"为什么引入 FDE 式打法"；第 6 章形成内部需求框架；第 8、10、12 章训练内部交付小组；第 14 章做生产化纵切、第 15–16 章用于设计验收口径、运营承接与能力回注

后续章节的"客户"可理解为"外部客户"或"内部被服务的业务部门"。

全书 16 章结构

板块一 · 认知打底（图表齐全、独立成书）

  • 第 1 章 FDE 是什么 —— 角色、三层含义、≠外包/咨询
  • 第 2 章 FDE 为什么有效 —— 死亡螺旋、四模式、能力回注飞轮、财务证据
  • 第 3 章 FDE 交付方法论：四阶段与能力回注 —— PPT×四阶段矩阵、能力回注、Gate、碎石路→铺装公路

板块二 · 角色主线

  • 第 4 章 Echo 与 Delta：作战单元的分工与协作（含角色定位游戏 · 形成性练习）

板块三 · Echo 侧

  • 第 5 章 Echo 工作法 · 定义问题（Discovery）（三脚手架 + 三 SOP + 选型 + Gate）
  • 第 6 章 实操一 · 西岭需求调研 →《解决方案框架》

板块四 · Delta 侧（三个单点 MVP + 一个无编号附加高级实验）

  • 第 7 章 Delta 工作法 · AI Coding 与工程纪律（知识）
  • 第 8 章 实操二 · 诉求智能分类器（一次 LLM 调用）
  • 第 9 章 RAG 方法 · 答案可追溯（知识）
  • 第 10 章 实操三 · 政策法规 RAG 问答系统
  • 第 11 章 Agent 方法 · 自动化边界（知识）
  • 第 12 章 实操四 · 工单智能分级路由工作流（Routing Workflow）
  • 第 13 章 从公网到本地：私有化部署与模型微调（知识 · 进阶选读）
  • 实操四B（无编号 Lab4B）· 西岭市民服务协同 Agent（附加高级实验，不占章号；将政策检索、部门查询、主动追问、工单草稿和人工审核组织为受控 Agent）

板块五 · 交付整合与收口

  • 第 14 章 Delta 生产化 · 工程 Scale：生产落地与客户接管（知识 · 贯穿证据任务 · 客户现场最后一公里）
  • 第 15 章 Echo 价值化 · 业务 Scale：价值落地、组织采纳与能力回注（知识 · 贯穿证据任务 · 含业务语义回注与本体）
  • 第 16 章 实操五 · 综合证据评审与决策层汇报（综合认证与成果展示）

单案例贯穿： 西岭市民服务平台。第 6 章 Echo 拆解 A/B/C 三个业务场景 → 第 8/10/12 章 Delta 完成三个单点 MVP（分类 / RAG / 固定路由工作流）→ 实操四B（Lab4B）综合为受控协同 Agent → 第 14 章进入客户环境并完成接管 → 第 15 章证明价值、推动采用并判断语义回注 → 第 16 章综合证据评审与决策层汇报。

修订记录

  • v0.1（2026）：确立实战训练版结构，完成第 1 章样稿与导读总纲。
  • v0.2（2026）：全书 13 章第一版完成。
  • v0.3（2026）：前六章按"独立成书、图表齐全、颗粒度对齐方法论层级"重写；确立"紧密内容直接写入、扩展内容只给在线链接"的内容归属原则。
  • v0.4（2026-08）：第 9–13 章续写/改造完成，新增第 13 章"企业私有化部署与模型微调"，实操五顺延第 14 章。
  • v0.5（2026-08）：新增第 14 章"全程总览 · 价值落地与能力回注"（收束整合章，置于最后一个实操之前）；实操五顺延为第 15 章并对齐交叉引用。
  • v0.6（2026-08）：专项修订（细化章，不含第 6/8/10/12 实操章）：P0 硬伤——第 2 章 Mermaid Y 轴负值截断、第 5 章选型决策树 q3 死分支、第 4 章 Ch6/13→Ch6/15、第 13 章"下一章"跳转 15→14；P1——第 3 章标题统一、3.2 Echo/Delta 骨架化、图 3-6 金字塔视角定位，第 5 章 Gate 清单去重，第 7 章 7.3–7.4 进阶选读标注、Trae/豆包拆分；P2——第 1 章时间线精确化与 Shelfware、第 2 章 NRR 口径提示、第 7 章日期标签与 Karpathy 时间、第 9 章 jieba 强调、第 11 章 LangGraph 版本小贴士；导读勾选体例与"交付红线"表述统一。联动更新：修订记录、章节标题引用。
  • v0.7（2026-08）：按专家评审意见启动逐章修订。本版本已完成导读修订：统一章节列表的读者视角表述，板块命名替换序号记号；区分五个项目实操（第 6/8/10/12/16 章）与第 4 章形成性角色练习；新增读者画像与双读者使用方式、先修要求与预计学时、环境准备、全书能力地图、认证评价蓝图；明确课堂模拟数据与真实客户数据的红线边界；第 1–2 章修订——为 Palantir/Airbus 案例、财务数据与行业事件补可溯源来源并做时效与口径标注，"指数级"改为"非线性（幂律式）"，70/30 平台定制比例与毛利区间标注为教学假设，财务表述降级为"与平台复用假说一致"（相关≠因果），2.5"真伪 FDE 鉴别清单"更名"教材诊断量表"并加"教材提炼"标识，8 条鉴别项改普通编号。第 3–5 章修订——第 3 章新增 "3.3.2 四阶段 Stage Gate 总纲"（四阶段各一张六要素表 + 止损规则）、金字塔加"正交可组合"提示；第 4 章新增 "4.2.1 战位职责 vs 个人能力"、角色定位游戏升级（战位判断非人格测验、《战位声明》两栏化），文件名对齐章节名称（第04章_Echo与Delta_作战单元的分工与协作.md）；第 5 章 5.1 改口径为"Discovery 初期不以功能开发为目标"并允许时间盒技术验证，三个 SOP 统一"输入—步骤—输出—完成判据—异常—示例"六段式，快赢筛选升级为 1–5 分评分量表并以坐标图画影响力×可行性矩阵（图 5-5），5.7.2 新增技术决策矩阵，5.8.1 Discovery Gate 升级为六要素核验；成品样例不随正文公布（避免剧透第 6 章实操一答案）。第 7 章修订——动态数据（模型/硬件/工具/订阅）集中到新增"7.8 动态速查"（每条标注来源与信息截至 2026-08，随官方资料维护），正文保留稳定结论（选型三要素、显存公式、量化取舍、工具选型三问），删两处动态型号表与部署示例表；新增 7.6.4"15 分钟最小 gstack 演练"；7.7 新增第四条工程纪律"数据与评测证据必须独立、可追溯、可复现"；删除章末"待核验"表述；按联网核查删除未获可靠来源的具名数字（910C 出货 60 万片、集群 9000P、Claude Fable 5 等），并在 7.8 为保留条目补来源链接。第 9 章修订——新增 9.9.5"评估落地三件事"（检索/生成/引用分开定位、固定 evaluator 配置与人工抽检、外部给定库外问题与库外拒答）、新增 9.10"最小 RAG 预实验（20–30 分钟，自拟片段不剧透实操三）"。第 11 章修订——11.3.4 术语三分（Workflow / Agentic Workflow / Agent，第 12 章路由按教材口径归为 Agentic Workflow）、新增 11.3.6 六种模式二维判断矩阵（预定义/动态 × 单轮/闭环）、11.7.1 LangGraph 校正（thread_id 隔离、interrupt 断点恢复、幂等需自建）、新增 11.8.3 工具调用工程化（超时/重试/幂等/审计/降级）、"零漏判"改为"给定验证集召回率 100%，生产目标为零漏判"口径（4 处 + 红线句）。第 13 章修订——13.2.1 私有化四形态（本地机房/专属云 VPC/离线一体机/混合）、显存降绝对化（粗略下界、LoRA 非"接近推理"）、13.3.2 具体卡数表删改为量级表、13.4 合并路径与 adapter 独立部署双路径、新增 13.4.1 数据治理 Gate（授权/脱敏/版权/去重/血缘/删除/泄漏检查）、新增 13.7 小模型 QLoRA 实验（24GB 单卡可跑）、13.5 成本表补实据（B300 整机约 700 万/台）并删未核验数字；各章动态版本号一律"以官方发布为准"。结构重构（第 13–16 章）——按《第13-15章重构施工建议》执行：新增第 14 章"Delta 工作法：Build、Scale 与工程化交付"（Delta 生产化纵切：三阶段证据边界、Build Readiness Gate 九维度、配置与密钥、日志/审计/指标、超时重试熔断降级、权限与最小权限、版本灰度回滚、监控告警、运行手册与跨组接管、工程回注；默认实验对象第 8 章分类器，精确命令待实验环境复核后以随书资源包为准）；原第 14 章"全程总览"顺延为第 15 章、原第 15 章实操五顺延为第 16 章（两章内容未动，仅章号/节号/图号与自指引用顺延）；全书五实操更新为第 6/8/10/12/16 章；导读结构列表、学时表、认证段及第 3/4/5/7/12/13 章交叉引用、"下一章"指引、AGENTS.md（正文 17 个文件、核心主线）同步更新。第 15、16 章的专业化升级（Echo 工作法重构、Go/No-Go 升维）按约定留待后续轮次执行。本体建模融入能力回注（按《Palantir本体建模融入能力回注_编写施工指南》）——能力回注明确两条路径（工程能力回注 vs 业务语义回注）；第 15 章新增 15.4"从项目资产到业务本体"（原编号 15.5，随后将承上启下节顺延为 15.5 并移至章末正文）（六类元素、西岭最小业务本体含图 15-2、四层回注模型、回注优先级、平台无关练习与第二场景验证）、第 14 章新增 14.10.1"业务本体的工程验证"（九项验证 + 概念/可执行/已验证三级区分）并使 Build Readiness Gate 升为九维度；第 1/2/3/5 章补业务语义总览与 Discovery 观察要求，第 6/8/10/12 章补"本体贡献"一行；Palantir Ontology 明确为代表实现而非唯一标准（附官方文档链接）；第 16 章未动。第 15 章重写（消除"全程总览"式拼凑，按《第13-15章重构施工建议》）——改名"Echo 工作法：价值落地、组织采纳与能力回注"，单一主线（14 章系统接得住 → 本章组织愿意接 → 16 章综合决策）：15.1 两个"不等于"、15.2 价值证据链（图 15-1 重画）、15.3 五口径分开（年度价值/净收益/TCO/ROI/回收期）、15.4 门槛·动机·信任（合并原两套框架）、15.5 四类干系人表达、15.6 业务 Scale（试点→扩大范围 Gate→停止条件，新增）、15.7 能力回注联合决策（含本体论三层次地基、两条路径、业务语义本体与图 15-2）、15.8 业务证据包；删除"主线速览"独立节与"把散装拼成地图"类元叙述；文件名更名（第15章_Echo工作法_价值落地_组织采纳与能力回注.md）；各章本体引用 15.4→15.7、第 16 章知识背景引用更新。第 14 章 FDE 化重构——按《第14章FDE化重构建议》转正方向：不教通用 SRE，改教"客户现场最后一公里"（五个转换、原型假设核验、语义对齐先于接口、业务动作闭环、八项 FDE 生产准入 Gate、现场变化分级、客户自运营与撤出、两类回注与本体工程验证、模拟客户环境贯穿实操）；层级上 14.1 保留三级目录、其余合并为二级并写厚；通用运维深水区（熔断实现/Trace/SLO/K8s 等）压为生产准入证据并移附录；新增知识点经 deep research 锚定（事实来源 / RACI / 数据分类分级）；文件名更名（第14章_Delta工作法_生产落地_客户接管与能力回注.md），第 3/5/15 章引用同步（14.10.1→14.9）。第 13 章补"模型切换适配"——新增 13.7"从公网验证到本地回填"（作者关切：西岭 ABC 三场景公网模型验证后合规切本地/微调模型，功能需适配回归）：三个适配层面（接口/行为/质量）、适配五步（接口抽象 → 行为回归〔冻结切换基准集〕→ 检索重建 → 量化对照 → 灰度双轨与回滚）、三场景适配对照、决策依据与切换 Gate 五项、反模式 8 条、练手任务与迁移；原 13.7 QLoRA 实验顺延为 13.8（动手实验置于章末），13.6.2/小结/练习引用同步；新增知识点经 deep research 锚定（vLLM OpenAI 兼容端点、LLM 切换检查清单、影子流量/金丝雀）。实操四B 与复盘真实项目纳入教科书（执行《Lab4B…施工指南》，角色体系修订建议除外）——实验命名统一为"实操四B（Lab4B）"与"复盘真实项目"；三角色编制按作者决定保留原编写（指南的角色修订建议不采纳）；导读更新为 16 章结构、板块四"三个单点 MVP + 一个无编号附加高级实验"、第 12 章更名、学时与认证（三类评价出口）拆分；第 15 章编写要求具备通用性（方法兼用于 16 章对西岭项目的总结回顾，也用于对"复盘真实项目"的拆解总结）；建立 experiments/ 学员版工作副本并完成指向校正（ch06→第 9 章、ch07→第 11 章）；后续各章（11/12/14/15/16 等）桥接与重构陆续登记于本条之下。第 12 章更名与第 11 章桥接（执行《Lab4B…施工指南》第 11/12 项）——第 12 章统一为"工单智能分级路由工作流"：标题、文件名、定位/产出/延伸阅读、学习目标（1–5 条）、"路由工作流正确率"验收口径、启动提示词参考答案、章末桥接实操四B（Lab4B）全部同步，明确其为"预定义路径 × 单轮"的 Agentic Workflow、不是动态自主 Agent；第 11 章新增 11.3.7 从 Routing Workflow 到受控 Agentic Loop（实操四B）（六维对照表），图 11-1 节点更新，interrupt 归属修正（第 12 章用固定转人工分支，真"暂停—恢复"在实操四B）；第 7 章图 7-1 节点同步；实操四B 独立构建、不复制 12 章代码、复用 LangGraph/工具/HITL 概念。第 16 章重构（执行《Lab4B…施工指南》第 15 项）——改"综合证据评审、能力回注与决策层汇报"：两层验收（第一层三场景双视角 + 第二层实操四B 六维）、下一阶段决策（Go / Conditional Go / Continue Pilot / No-Go + 依据/风险/责任人/Gate，允许 No-Go）、十页汇报骨架（含第 9 页支持申请）、AI 使用边界（判断归人、AI 仅整理/润色/红队）、课后可选"复盘真实项目"出口；演练流程与 DoD、反模式、小结、练习、收口话全部同步；交付物新增下一阶段决策单与实操四B 验收表。P1 桥接与数据出域口径校准（《Lab4B…施工指南》8/9/10/13/14/17 项 + G2）——第 8 章加 classify_request 最小工具契约（输入/输出 + 迁移问题：实操四B 何时调用/跳过）；第 10 章加 search_policy 契约与来源元数据（source_file / normalized_file / article / excerpt）；第 7 章加实操四B 工程纪律五条预告；第 13 章加多工具数据域提醒并把"公网验证 → 本地回填"口径改为"模拟数据边界 + 本地回填"（3 处）；第 14 章 14.4 表扩为四行（含实操四B）并给"一次动作 vs 一条动态轨迹"闭环递进注；第 15 章新增 15.9 通用性：从西岭总结回顾到"复盘真实项目"（八问，含证据四状态）；第 3 章合规句口径同步；AGENTS.md 术语表补"实操四B / 复盘真实项目"。实验手册正式入库 labs/（与 textbook 同级、英文路径）——收录实操一~五学员版 + 实操四B + 复盘真实项目 + 客户需求/政策素材/gstack 流程（中英对照见 labs/README.md）；experiments/ 降级为草稿；确定教科书实操章与手册的错位分工（教科书=方法/任务/验收，手册=执行细节/参考答案/模板/素材），正文引用统一"见《实验手册》labs/<文件名>"；后续按批对 8/10/12 章做 A/B 分层瘦身，并核对第 16 章六维验收与手册 Lab4B 口径。实操章轻量化试点：第 6 章（按推荐档 A/B 分界）——客户需求材料全文下沉《实验手册》labs/source-client-requirements.md，附录 A/B/C 与参考话术下沉 labs/lab1-requirements-brainstorm.md，环节步骤精简为"要点+决策点+检查点"，保留任务书三问/三脚手架判据表/DoD/反模式红线/练习；正文引用统一"见《实验手册》labs/<文件名>"；419 行 → 261 行；"关键判断不用 AI"口径与全章一致。后续按同一分界对 8/10/12 章逐章瘦身。实操章轻量化：Ch8（320 行 → 223 行）——启动提示词参考答案与 25 条测试样本下沉 labs/lab2-classifier.md 附录 D、gstack 安装速查下沉附录 A、驱动指令全文下沉环节 2、灵魂追问与讲师要点指向手册；保留 7 项信息块表/7 自查/八环节把关表/关键决策点/DoD/反模式红线/练习；contract 与验收口径不变。后续按同分界继续 Ch10 → Ch12。实操章轻量化：Ch10（286 → 251 行）与 Ch12（280 → 235 行）——Q&A 验证集/启动提示词参考答案/安装速查下沉 labs/lab3、工单样本/部门职责库/参考答案下沉 labs/lab4；保留双指标验收表、RAG 五决策点与图 10-1、三档判定与档位例子反向核对、八环节把关表、DoD、反模式红线、search_policy 契约；Ch16 补引用（optional-labs → labs/lab5、labs/lab4b、labs/migration-review-real-project.md）。至此五个实操章全部完成轻量化并统一 labs 引用协议；验收口径、契约、红线表述均不变。随书模板包 resources/templates/ 正式建立——六份模板（solution-framework / two-layer-acceptance / capability-reinjection / decision-sheet / client-report-outline / roi-calculator）+ README（模板唯一权威、与 labs 手册同源同步规则）；第 6 章《解决方案框架》模板引用由 labs 改指 resources/templates/solution-framework.md（5 处），第 16 章模板文案兑现（决策单/十页骨架/ROI/能力回注四步法）。权威源转移（本仓为权威，不回写）——labs/ 与 resources/templates/ 自 2026-08 起为实验手册与模板的权威来源；陕西移动专题综合实操与 fde-bootcamp-site 降为历史参考（labs/README 与 AGENTS.md 声明同步）；labs 手册内嵌模板加"同源提示"5 处（lab1 附录 A、lab5 输出物 1/附录 A/B/C）。术语统一：在线全书 → FDE-101——https://www.cloudzun.com/fde-course/ 自此统一称 FDE-101：全文“见在线全书”→“见 FDE-101”、章末标题统一“## 延伸阅读”、“在线全书（延伸阅读）”→“延伸阅读”，导读“与 FDE-101 的层次区分”；AGENTS.md 术语表新增 FDE-101 行、引用格式统一“见 FDE-101 https://…”；misc 过程文档与 experiments 草稿不涉及。 子代理全文 review 修复批——裁决术语标准为 FDE-101（含短横线，正文已全局统一）；修复：与 FDE-101 的层次区分缺空格、“FDE-101 见文末”残留两处（Ch12/Ch16）、Ch5「全程禁用 AI」→「关键判断不用 AI」、Ch8 标题统一「延伸阅读」且 FDECore 依赖式引用改 FDE-101 链接、「6/8/10/12/15 章」→16、「FDE-101 章节 / 还是 FDE-101 / FDE-101 交叉」缺空格、Ch1 嵌套 [!NOTE] 解嵌套、Ch11 [!WARNING]→[!CAUTION]、「（不用 AI）」→「（关键判断不用 AI）」4 处；lab3-policy-docs 补齐 5 份（新增户籍迁移政策.docx、就业创业补贴政策.pdf，源＝陕西移动专题 Lab3-policy-docs），labs/README 素材计数同步。 联动更新：AGENTS.md（版本号说明）。后续各章修订陆续登记于本条之下。
  • v0.7（2026-08 · 整改轮 1）：按《misc/FDE教科书全书Review整改操作手册_v0.7.md》执行。去厂商组织归因——第 4 章"Palantir 前线编制是三角色"改为"教材口径"；第 1 章"Palantir 实际组织通过 Delta+Echo+后方平台工程分工实现三合一"改为本书分工框架（维持三角色口径，AGENTS.md 无需改动）；导读学时表拆分第 14/15 章贯穿证据任务学时（原"生产化与收口 10 学时"拆为 13 章 4 + 14 章 3 + 15 章 3，合计不变）；导读结构段补充"编号实操 vs 贯穿证据任务"区别；第 13 章导学新增"主线必读 / 进阶选读"标注；第 15 章章首新增"必做贯穿任务 + 知识支持"属性句。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 整改轮 2–7）：轮 2 内容整改——第 2 章财务改按 SEC 一手来源（S-1/10-K）并去因果归因（驱动因素列改"教材解释假说"）、经验曲线标"教材提炼"；第 1 章"首创"降级为"早期实践通常归因"、去"Palantir 实际组织"归因；第 9 章 RAGAS 表按评价对象重写、加"引用存在≠引用正确"反例、准入门槛条件化；第 11 章 Agent 分类对齐 Anthropic 原始框架（OW/EO 属 Workflows）、interrupt() 恢复四点语义 + 重复发消息反例；第 13 章 LoRA 表述区分全参/增量参数、容量结论条件化、学习目标标进阶选读；第 15 章 ROI 改回报率口径、另定义收益成本比、年度价值公式补年运行天数；第 7 章新增"出域"六类口径、数据不出域条件化（非普遍法定义务）、速查来源纪律；第 5 章新增 5.8.3"成功标准八字段"并升级解决方案框架模板；第 3 章"三条红线"改四条、部署约束条件化。轮 3 格式——实操章补齐 N.x/N.x.y 编号（6.1–6.6、8.1–8.5、10.1–10.5、12.1–12.5、16.1–16.5 及环节/检查单编号）、带圈数字清零、FDE-101 链接去 URL 加粗并合并章节名、模糊指代改明确编号（如"按上文"→"按 12.4.1"）、5 实操章加学习目标追踪表、Ch8 Python 版本统一为 3.11+。轮 4 资源——新建 resources/environment/（环境自检 / 依赖锁定 / 排障）、resources/certification/（八项能力量规 + lab1–5 量规 + 个人评价 + 陌生平行案例）、resources/index/（术语 / 图表 / 五实操产出物索引）。轮 5 实验章内容——Ch6 八字段落地（6.4.5 + DoD）、Ch8/10/12 新增《Echo Prototype 检查单》（8.6/10.6/12.6）、Ch10 小样本 6/6 口径修正与教学数据边界、Ch12 红线表述补第四线、Ch14 章首属性句 + 去"待环境复核"残留。轮 6 labs 同步——lab3 统计口径修正（可追溯率 6/6）、lab1 八字段同步。轮 7 回归——G-1 自动检查通过（17 文件、H1/标题跳级/图题/LR 节点数/带圈数字/待核验残留/Python 版本一致）；G-2 事实核验台账建立。联动更新：misc/FDE教科书整改问题台账_v0.7.md、misc/FDE教科书事实核验台账_v0.7.md。
  • v0.7（2026-08 · labs 母本更新轮）：按"labs 为执行细节母本 → 教科书提炼要点"方向更新实验手册正式册——lab2：Python 3.11+、自查表与防翻车信息带圈数字清零、DoD 加《Echo Prototype 检查单》（教科书 8.6）；lab3：两处"实操二已确认数据可出域"改教学数据边界口径、"政务 AI 的准入门槛"条件化、自查表/附录带圈清零、DoD 加检查单（教科书 10.6）；lab4：自查表与附录 E 带圈清零、DoD 加检查单（教科书 12.6）；lab4b：Python 3.11+；migration-review：角色措辞微调为"不新增第三学员角色（Engineering 仅作保障方）"。教科书回填核对：八字段 / Echo 检查单 / 6/6 口径 / 教学初始值 / Python 3.11 已全部覆盖。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · F-01/F-13 落笔）：财务复算落笔——第 2 章 2.4 第一阶段表扩为 2018–2022 五行并更新数字（2018 约 51%、2019 约 60%、2020 约 67%、2021 78.0%、2022 78.5%），表注注明"2021–2025 已按财报数据复算（2022=1,497/1,906）"；学习目标/正文/小结的 50% 同步改约 51%。速查官方来源落笔——第 7 章 7.8 速查表来源列换官方页（DeepSeek API Docs、Kimi GitHub、智谱文档、Anthropic Release Notes），Qwen 旗舰 / OpenAI / B300 标注"待官方核验"，来源纪律 NOTE 同步更新。联动更新：misc/FDE教科书事实核验台账_v0.7.md（F-01/F-13 行）。后续修正： 回 SEC S-1/A 原文复算后，2018 毛利率确定为 72.2%（430,008/595,409，推翻第三方"约 50%/51%"口径）、2019 为 67.4%；第一阶段表、正文（约 67%→82.4% 叙事）、小结同步更新；第二阶段表 2022 行与图 2-5 同步改 78.5%（详见下方"F-01 落笔补记"条目）。
  • v0.7（2026-08 · Reader Testing 修订轮）：AI 代理预演（三类读者无上下文测试，7 题通过）后按 8 条可读性信号修订——S3 学时口径统一（导读=核心必做 3 学时 + 章内注明含进阶 5–6 小时）；S5 交叉引用修正（"第 8 章开头"→"7.4 六类口径与 8.1"）；S6 gstack 仓库统一为 garrytan/gstack（GitHub API 实测 130k stars 权威，garnet-labs 为 0-star 同名仓库）；S1 导读补两类读者最低技术线（Echo 不需动手安装）；S4 Ch14/15 章首补评价量规位置；S7 Ch3 Build 口径补第 14 章模拟演练；S2 Ch6 标题改"六个环节 + 可选红队环节"；S8 Ch15 章首补决策单落点 16.4.4。联动更新：misc/FDE教科书事实核验台账_v0.7.md（G-4 行）。
  • v0.7（2026-08 · 收尾定版）：发布 Gate（G-5）12 条逐条核验完成，主编授权签字定版——收尾清单见 misc/FDE教科书v0.7整改收尾清单.md；Reader Testing 按主编拍板以"往期课程实践 + AI 预演 + S1–S8 修订"放宽通过；F-2（FDE-101 目录核对）与 F-3/F-4（格式抽查）标注为"签字接受现状，发布前可再核"，不阻塞定版。联动更新：misc/FDE教科书事实核验台账_v0.7.md（G-5 行）。
  • v0.7（2026-08 · F-2 章节名核对）：按 FDE-101 实际目录（本地 repo D:\vibecoding\dsh\fde-course，16 章 + 附录）核对全部 FDE-101 链接——修正 7 处（Ch1 补第二链接 URL；Ch7/Ch14/Ch15 六处补章号：第 8 章 Phase 4 Scale、第 9 章能力回注方法论、第 15/16 章 AI FDE 落地），8 处分隔符统一为"："；"第 5–9 章"范围表述核对无误。全书 FDE-101 链接现已统一为"见 FDE-101 https://www.cloudzun.com/fde-course/（第 X 章 <名称>）"格式。联动更新：misc/FDE教科书事实核验台账_v0.7.md（F-2 行）。
  • v0.7（2026-08 · 角色表述去口语化）：按主编意见，全书清理"Echo 靠想 / Delta 靠做"类口语化表述（15 处：Ch1/Ch3/Ch4/Ch5/Ch6 的定义句、一句话记住、章节地图、承接句、图 3-2 节点与图题）统一为"Echo 主责判断、Delta 主责施工"；"不写代码"作 Echo 定义词处（Ch3/Ch4/Ch6/导读共 4 处）改为"以业务与价值判断为主、不直接负责工程实现"，消解"只动脑/只动手"的割裂感；战场比喻（尖刀/政委/保阵地、手上沾泥、脏活累活）保留。grep 靠想|靠做|不写代码 零残留。
  • v0.7（2026-08 · 章节命名重构）：按主编意见重构 8 章命名并重命名文件——Ch5「Echo 工作法 · 定义问题（Discovery）」、Ch7「Delta 工作法 · AI Coding 与工程纪律」（Vibe Coding→AI Coding，体现 gstack 规范）、Ch9「RAG 方法 · 答案可追溯」（去"知识问答"）、Ch11「Agent 方法 · 自动化边界」（去"系统设计"）、Ch13「从公网到本地：私有化部署与模型微调」、Ch14「Delta 生产化 · 工程 Scale：生产落地与客户接管」、Ch15「Echo 价值化 · 业务 Scale：价值落地、组织采纳与能力回注」、Ch16「实操五 · 综合证据评审与决策层汇报」；"能力回注"去重（仅 Ch3 定义 + Ch15 主体）；文件名同步重命名 8 个，导读结构表、正文全名引用（Ch8/9/10/12/13/14/15）、AGENTS.md 核心主线、lab5、figures 索引同步；正式交付物旧标题零残留（misc/experiments/references 归档不动）。
  • v0.7（2026-08 · F-01 落笔补记）：2.4 数字同步回归——第二阶段表 2022 行 78.6%→78.5%、图 2-5 毛利率线 [78.6,…]→[78.5,…]；至此 2.4 全部配套（第一阶段表、第二阶段表、图 2-5、正文 L211/L221/L263/L265、学习目标 L15、小结 L330）与 S-1 复算数字一致，grep 78.6|50%→82|51%→82|约 50%|约 51%|约 68% 零残留。联动更新：misc/FDE教科书事实核验台账_v0.7.md（F-01 行）。
  • v0.7（2026-08 · 脚本事故恢复补记）：修复引用脚本（PowerShell 嵌套数组展平 bug）曾把 6 个文件全文件字符替换破坏（Ch3「（」→「类」、导读「（」→「六」、Ch8「本」→「书」、Ch9「第」→空格、Ch11「第」→空格 +「（」→「应」、Ch14「进」→「阶」）。经主编确认按 git 恢复方案处理：逐行以"当前行 == HEAD 行.Replace(破坏对)"判据恢复 HEAD 行（Ch3 117 行 + 11 混合行人工、导读 188 行 + 25 处残留修复、Ch8 162 行、Ch9 417 行、Ch11 368 行 + 1 处残留、Ch14 422 行 + 2 处残留），v0.7 全部预期改动（Alert 独占行、角色表述、章节重命名、Ch7/Ch13 重构、F-01 财务、Echo 检查单等）均保留；全库破坏特征 grep 零残留。联动更新：misc/FDE教科书整改问题台账_v0.7.md（恢复记录）。
  • v0.7（2026-08 · AI Coding 叙事统一轮）：按主编意见统一第 4/5/7 章叙事——确立"Echo 定方向（选层）→ Delta 定落地（建层）"接力主线，金字塔为分界线与契合点：Ch4 4.5 末尾加"连续统一的团队 + 金字塔分界线/契合点"段；Ch5 5.7 加"选层→建层交接接口"句；Ch7 重构 7.2（图 7-2 改 Delta 工程视角——各层实现形态与工程代价，去与 Ch5 决策矩阵的重复；7.2.2 改"逐层工程形态与代价"表；7.2.3 改施工含义 + 分界线/契合点）、7.3 改"AI Coding：Vibe Coding 驱动 × harness 工程约束"（Vibe Coding 升级为 AI Coding = 驱动层 + harness 约束层）、7.5 改"驾驭 AI Coding 防止翻车"（翻车主体 = 驾驭方式失当，非工具本身；"Agent"统一为 coding agent，并与第 11 章"智能体系统"区分）、7.1 加接力叙事段、章首/小结/反模式同步；Ch3 图 3-6 分工 NOTE 同步措辞；Ch4 "AI 施工"处 Agent→coding agent；新增 图 7-3（Echo 选层→Delta 建层接力）、图 7-4（AI Coding 两半：Vibe Coding 驱动 × harness 约束）、图 7-5（gstack 八环节流水线，替换原 text 块）。grep 防 Agent 翻车|何时用、何时不要用 零残留。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 图 2-5 加 0 线）：按主编意见，图 2-5（利润率趋势）加第三条水平 0 参考线并更新图解说明——"0 线以下为亏损（2022 净利率 -19.5%），2023 起站上 0 线"。注：mermaid xychart-beta 不支持自定义颜色/虚线，采用 0 值数据线方案（实线、自动配色），红色虚线需外部 CSS 环境方可实现。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch15 对齐 Ch3 框架 + 本体线增强轮）：按主编意见打通第 3/15 章对应关系——四阶段/Scale Gate 线：Ch15 15.1 加"本章 = Scale 阶段业务侧落地"定位 NOTE、15.8 加"6 问 = Scale Gate 评审（四档决策 = Gate 动作，业务证据包 = 必交付物 + 通过证据）"、小结加定位条目；Ch3 3.3.2 Scale Gate 表后加互指（业务证据见 15 章、工程证据见 14.9、综合评审见 16 章）。本体线：Ch15 15.7 开头加"承接 Ch3 3.5 + 全书本体线索引"（3.5 总览 → 5/6 收集 → 8/10/12 贡献 → 14.9 工程验证 → 15.7 建模 → 16 评审），15.7.3 末尾加"与 Palantir 生态的对接定位"（方法论是标准、Palantir 是参照系；Foundry Ontology 为代表性实现，平台无关可迁移）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · harness 与 gstack 关系澄清）：按主编意见，Ch7 讲清"harness 是方法/产品类别，gstack 只是其一个具体开源实现——如同 opencode 只是 coding agent 类里的一个工具，gstack 不代表整个 harness 类别"：7.3 导语加"两个'类'要分清"段、7.3 标题与图 7-4 改"harness（本书以 gstack 演示）"、7.4.1 补"非唯一实现（自有脚本/CI/商业平台均可）"、7.5 导语与章首/学习目标/小结同步；教学以 opencode + gstack 演示"一套能跑通"，实践选型（甚至自建流水线）灵活、纪律（7.5）比工具更重要。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · harness 生态落笔）：按调研结论，Ch7 7.3 导语加"harness 是当前 AI 工程主流方向"共识锚点（Anthropic《Effective Harnesses for Long-Running Agents》2025-11、OpenAI/微软 Magentic-One/DeepSeek Agent Harness 押注，附中英文综述链接）；7.6.1 速查加"harness 工具生态"段（gstack / OpenSpec / LangGraph / Magentic-One / DeepSeek Agent Harness / Harness.io，标注信息截至 2026-08 与来源纪律）；全库"gstack 工程约束 / × gstack 约束"表述统一为"harness 工程约束"（含修订记录历史文字）。应主编意见精简重复表述："harness 是一类方法/产品，gstack 只是其中一个实现"的完整定义仅保留 7.3 一处，7.4.1 / 7.6.1 / 小结改为简短提法"本书以 gstack 演示（7.3）"且不加粗。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · coding agent 生态补全）：按调研结论补全 Ch7 7.3 工具生态——共性：海内外 coding agent 都通过"技能/插件（Skills/Plugins）"获得增强能力（Anthropic 2025-10 Agent Skills 开放标准，SKILL.md 按需加载）；opencode 定位：7.3.2 表格新增 opencode（独立开源终端 agent、模型无关、不绑定大模型厂商——本书默认演示选它的中立性理由）；7.3.3 国内工具改 7.3.2 同款表格（Trae/Qoder/WorkBuddy/Comate/CodeGeeX/办公线，含技能生态共性）；7.3.4 选型三问与 NOTE 补 opencode；7.4.1 补"gstack 支持跨 agent 运行（官方 host 接入机制，Claude Code/Codex/opencode 均可）"。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 7.3.3 价格落笔）：按主编意见，7.3.3 国内工具表格补价格列（各档位代表值：Trae 免费版 0元/月/速通 Pro 99元/月/速通 Ultra 699元/月；Qoder 社区免费/专业 59/旗舰 559；WorkBuddy 体验免费/标准 99/旗舰 999；CodeGeeX 个人免费/Coding Plan Pro 149 起；千问办公 19 起、豆包标准版 68），删除百度 Comate 行，表注标注"信息截至 2026-08、以官网实时为准"；Trae 大小写统一。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · coding agent 专节）：按主编意见，Ch7 新增正式小节 7.3.1 coding agent：定义、分类与共性（从"引文"提升为专节）——定义 + "coding agent（工具类）vs harness（方法/产品类）"对照表 + 三维分类（按归属：厂商绑定 vs 独立开源 opencode；按能力侧重：纯 coding vs 全能型；按形态：CLI/IDE/平台）+ skill 共性（Agent Skills 开放标准）；harness 主流方向与 gstack 定位两条引文移入该节；原 7.3.1–7.3.4 顺延为 7.3.2 Vibe Coding 五原则 / 7.3.3 海外 / 7.3.4 国内 / 7.3.5 选型三问，引用同步（阅读路线 7.3.1→7.3.2、7.3.3 表注互指、7.6.1 "正文 7.3.5"、图 7-4 节点）。grep 7.3.4 / 7.4|见 7.3.2）|本节 7.3.1–7.3.4 零残留。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 7.3/7.4 分工理顺）：按主编意见——7.3 主讲 coding agent、7.4 主讲 harness：7.3.1 移除 harness 主流方向与 gstack 定位两条引文（改由 7.4 承接）；7.4 改名"harness：gstack 工作流与 SPEC 驱动开发"，导语将 harness 定义、主流方向综述、gstack 定位（"gstack 只是 harness 类里的一个实现，就像 opencode 只是 coding agent 类里的一个工具"）转为正文承接 7.3；skill 共性去重：仅保留 7.3.1 一处（Agent Skills 开放标准），7.3.3 海外表注删共性段、7.3.4 国内表注删"国产工具同样通过技能/插件生态"句，保留价格时效声明；7.4.1 定义引用改 7.3.1。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 7.4 三层递进重构）：按主编意见，7.4 改为"理念 → 通用规范 → 具体实现"三层递进，开篇词精简为两句承接（不再大段解释）：7.4.1 harness 理念（专节：定义 + 三个翻车点 + 四条通用原则〔受控执行/外部验证/可追溯/人机回环〕+ 主流方向综述）；7.4.2 SPEC 驱动：harness 的通用规范（产品无关，标注 SDD/OpenSpec）；7.4.3 工程流水线：harness 的通用骨架（图 7-5 通用化——环节改中文"1 要不要做…8 复盘"，表格去命令列）；7.4.4 gstack：harness 的一个开源实现（gstack 定位 + 八环节命令映射表 + 跨 agent）；7.4.5 最小 gstack 演练（原 7.4.4 顺延）。引用同步：阅读路线/7.6.2/小结/练习的"7.4.4 演练"→7.4.5。7.4.3 加来源声明（教材提炼）：八环节骨架系训练营基于 gstack 提炼、实践磨合，符合 harness 通用规范但非 Palantir 或其他大厂官方流程，落地可裁剪。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch7 全章 review 整改轮）：按主编意见完成第七章整体 review 整改——历史残留清理（模型/选型内容已移 Ch13 但 Ch7 未同步）：删学习目标 3、学习目标 2 去"选型三要素"并重排编号（6→5）、小结"选模型/部署"条改指向 Ch13、自检/基础练习去"选型三要素/双栈/显存"（改"Delta 视角金字塔"与"速查在哪"）；图 7-3 接力图从 7.1.5 移至 7.2.3（图号恢复连续 7-1→7-5）；删解释性文字 4 处（"论证根基/对齐 AI FDE/三层递进/理念讲完落到"）；7.6.1 重构：删与 7.3.3/7.3.4 重复且冲突的工具订阅表（含已删百度的残留），改名"工具与 harness 生态速查"，保留 harness 生态段 + 指向行，全章"7.6.1 速查/工具价格在 7.6"类引用同步至 7.3.3/7.3.4/13.10。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch9 开场架构化）：按主编意见，Ch9 新增 9.1.2 三步工作原理与组件总览（全章地图）——检索→增强→生成三步（图 9-3）+ 组件→章节地图表（数据准备与索引→9.3-9.6、查询与检索→9.7、增强与生成→9.8、评估与监控→9.9）+ 典型场景一句（指向 9.1.5），解决"后面内容堆叠拼凑感"（先给总览架构，9.2–9.9 逐块展开）；原 9.1.2–9.1.4 顺延为 9.1.3–9.1.5，正文引用同步（9.1.2→9.1.3 两处、9.1.3→9.1.4 一处、9.1.4→9.1.5 三处）；图号顺延（核心链路 9-3→9-4、检索增强 9-4→9-5、生成提示词 9-5→9-6）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch9 RAG 概念重构）：按主编意见修正 9.1.1"开卷考试"类比不当——原"开卷 vs 闭卷"对比暗示微调=闭卷=差，与第 13 章微调叙事冲突。重构为概念先行：RAG 定义（给大模型补上"它不知道的信息"）+ RAG vs 微调两条互补路径表（补信息方式/适用/更新/成本，明确"没有优劣，只有适用场景不同"）+ 图 9-2 改为"开卷式检索 vs 背书式内化，各有所长"并列对比（不再贬低闭卷）；"开卷考试"比喻降级为概念之后的附加 NOTE（帮助记忆、非严格定义）；同步学习目标 1、9.1.2/9.1.3 承接句、反模式（"把书背进脑子"→"凭模型训练记忆硬答"）、小结、自检。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch9 圈数字与指针清理）：按主编意见——9.1.2 三步工作原理圈数字 ①②③ 改为 1/2/3（全书"带圈数字清零"纪律）；删除三步正文的预告式指针（"检索（9.7）/增强（9.8）/生成（9.8）"），组件→章节地图表保留（集中一处的架构地图，非零散指针）；典型场景句"见 9.1.5"改"判断方法见下文选型边界"。grep [①-⑳] 零残留。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch9 合并 9.1.4 进选型边界）：按主编意见，删除 9.1.4（为什么超长上下文取代不了 RAG）——其与 9.1.5 选型边界表重叠（超长上下文已有行）；核心内容（Lost in the Middle / 按 token 成本 / 溯源不透明 + "能读多少 vs 读哪几段、答得有依据"结论 + "引用存在≠引用正确"见 9.9）压缩为 9.1.4 选型边界表后的展开 NOTE；原 9.1.5 顺延为 9.1.4，正文 6 处引用同步（对照/印证/反模式 ×2/小结）；9.1 标题改"RAG 是什么：检索外部资料补足模型语料"，学习目标 1 与章首产出同步去"为什么超长上下文取代不了它"。应主编意见，进一步删除选型表后的"超长上下文展开 NOTE"（表格行已含结论，避免变相塞回已删内容且"引用存在≠引用正确"与 9.9 重复），9.1.4 保留"选型表 + 判读 TIP"。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch9 9.8 加厚）：按主编意见补厚"生成 + 来源引用"节——9.8.1 加组装提示词模板（代码块示例）+ 两条组装纪律（只给片段不给全文、片段排序与数量 top-K 3–8 段）+ 常见坑 NOTE；9.8.2 引用格式细化（标准写法 / 多来源并列 / 无文号降级）+ "检索不到不能编"三条判据（检索为空 / 命中不相关 / 片段冲突）+ 引用三类失败预告（错引 / 漏引 / 引而不符，承接 9.9 双指标）+ 完整示例会话（西岭社保问答：提问→检索片段→组装提示词→带引用作答 + 对照拒答输出，标注"示意内容非真实政策文本"）。9.8.3 保持。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch7 过渡精简）：按主编意见学 Ch9"开门见山"风格精简第七章小节过渡——去掉 8 处机械"承接 7.x"句式与"本节将/本节给出/本节先讲"元描述、解释腔（7.1.1"回顾第 3 章/本章讲的"、7.1.3"翻译成……根源破法"、7.2"承接 7.1 的接力叙事/本节给出"、7.3"承接 7.1/本节把……讲清楚/本节先讲驱动层"、7.4"承接 7.3"、7.5"承接 7.1/手段驾驭"），各节改为一句定义/场景直接切入。grep 承接|本节将|本节先讲|本节给出|回顾第 零残留（实操四B"承接知识"术语除外）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch11 泛化去实操绑定）：按主编意见（"教科书不是实验手册说明书，讲通用场景和方法"）泛化 Ch11 的章节/实操绑定表述——11.3.5 工单分级改为"Routing 的典型应用场景（业界运用普遍）"，去掉"第 12 章实操四的工单分级…为 6 类工单搭…"的为实操找补腔，改为"这类场景会在实操四中演练"；11.3.7 标题去"（实操四B）"，开篇改为"两种常见模式"对比（路由工作流 vs 受控 Agentic Loop），表格头去"第 12 章/实操四B"，说明段改为二维判断 + 演练指引；同类表述一并泛化 8 处（L59/L146/L155/L238/L373/L424/L471/L494："第 12 章/实操四"→"路由工作流/工单分级/受控 Agent"）；保留章定位、章节地图、下一章导航、红线落地、Lab4B 演练要求等正常语境。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch11 11.7.2 MCP 讲透）：按主编意见重写 MCP 小节（原来只有定义+三原语+规范更新，突兀）——概念（解决"每个工具一种接入方式"、USB-C 类比）、组件与架构（Agent → Host/MCP Client → MCP Server 调用链 + 图 11-5 + Host/Server/三原语）、适用场景（多工具多 agent 共享 / 接入方式杂 / 团队共享工具库 / 简单场景不上）、与 agent 解决方案的关联（工具层与决策层解耦、与 LangGraph 配合、承接 11.8 工具设计、能力回注落点）、规范时效声明保留。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch11 11.9/11.10 扩充）：按主编意见——11.9.3 HITL 讲透：标题改"让'人能判断、AI 能执行'可落地"，新增三种环的层次（Human-in-the-Loop 人在环内 / Human-on-the-Loop 人在环上 / Human-out-of-the-Loop 人在环外，含机制与适用）、三个工程要点（暂停点选在哪——敏感路径设 interrupt、确认界面给人看上下文+候选+风险、人工超时策略——超时默认拒绝绝不自动通过）、注意（HITL 非免死金牌，双人复核+审计）、与 agent 方案关系（interrupt/固定转人工分支/request_human_review，HITL 写死而非模型自觉）；11.10.2 三问加判定细则（每问的"可自动/留人"判据 + 用法：任何一问指向留人就设暂停点，全可自动也留审计）；11.10.3 改名"边界写进 SPEC，并落到工单分级"，新增 SPEC 落地清单（自动化范围/转人工触发条件/兜底动作/人工超时策略 = DoD 检查点）+ 边界随阶段演进（Prototype 保守、生产扩大，敏感路径 in-the-loop 不动）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch11 章节重排）：按主编意见消除堆砌感，重排为"概念 → 模式 → 工具底座 → 权衡/安全 → 边界决策 → 案例收尾"：11.5 工程底座（原 11.7 LangGraph/MCP）、11.6 工具设计（原 11.8）、11.7 假阳性 vs 假阴性（原 11.6，改名去"自动化边界"）、11.8 安全与三层护栏（原 11.9）、11.9 自动化边界（原 11.10）、11.10 企业案例（原 11.5 反洗钱，放最后综合演示）；改名 11.2"适用边界"→"什么时候用智能体"、11.10"企业案例"（全章"边界"字眼仅剩 11.9 核心节）；全章 30+ 处子节编号与正文引用同步（11.5.x–11.10.x 映射）、图号重排（MCP 图 11-5→11-4、反洗钱图 11-4→11-5）、跨章引用同步（Ch12 三处：11.10→11.9/11.9→11.8/11.7.1→11.5.1；Ch13 一处：11.8.2→11.6.2）；修复重排脚本切块遗漏导致导学块丢失（从 HEAD 重建导学块、前置行用当前版）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 部署/微调顺序理顺）：按主编意见改"先本地部署、后微调"——新写 13.1 为什么需要本地（数据不出域 → 公网 API 三条边界表 → 本地两件事：部署=第一层、微调=第二层 → 本地回填主线）；原 13.1（该不该微调）移到 13.4，标题改"部署之后：什么时候才轮到微调"并加承接句（"模型本地跑起来了，还有一类需求 RAG 覆盖不了——行为类，这才轮到微调"）；新顺序：13.1 部署引入 → 13.2 选型 → 13.3 私有化部署 → 13.4 微调判断 → 13.5 方法 → 13.6 流程 → 13.7 成本 → 13.8 回填 → 13.9 判断清单 → 13.10 实验 → 13.11 速查；全章编号与引用映射（13.10→13.11、13.9→13.10、13.7→13.9、13.6→13.7、13.5→13.6、13.4→13.5、13.1→13.4 及子节）、导学主线必读/学习目标/章节地图同步（学习目标按部署→微调→回填→决策重排）；跨章引用同步（Ch7 十处 13.10→13.11、Ch16 13.7 模型切换适配→13.8，原引用错误顺带修正）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 合并 13.1+13.2 合规重写）：按主编意见——合并 13.1（为什么本地）+ 13.2（选型）为新 13.1「为什么在本地部署 + 怎么选型：合规与能力双驱动」：13.1.1 合规要求（数据不出境〔《数据安全法》《个保法》〕/ 算法备案与安全评估〔《生成式 AI 服务管理暂行办法》〕/ 自主可控〔信创〕表）；13.1.2 选型三问（能否本地部署 / 算法可否解释 / 权重是否公开，从合规推导的能力维度判据）+ 原选型三要素并入（复杂度定档 / 敏感度定本地 / 约束定规格）；删原"国内开源 vs 海外闭源"地域二分与"地域不是判据"澄清节（按主编意见不多讲地域、直接从合规说明）；全章顺延 -1（13.3→13.2 部署…13.11→13.10 速查），子节/引用/图号全同步；导学主线必读与学习目标 1 更新；跨章同步（Ch7 10 处 13.11→13.10 回改 + 2 处 13.2/13.3→13.1/13.2；Ch16 13.8→13.7）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.1 再重写·规范依据）：按主编意见——修掉选型三问的回环（原问 1"能否本地部署=权重是否公开"与问 3"权重是否公开"重复），并改用公开规范作依据（不再自编）：13.1.1 提出问题——三条合规红线（数据不出域〔《数据安全法》《个保法》〕/ 算法备案与安全评估〔暂行办法 + TC260-003 语料/模型/服务安全〕/ 自主可控〔信创 + 政采安全采购指南〕，均附官方链接）+ 必要性小结；13.1.2 解决问题——选型三问（第一问数据能不能出域〔决定要不要本地〕/ 第二问能不能本地部署〔权重可得+算力许可+自主可控，三者合起来，权重公开只是子条件〕/ 第三问选哪个档位〔复杂度定档+评测验证+约束定规格〕）+ 可行性小结（合规红线内本地部署的完整链路）。规范链接标注"教材引用，落地以官方最新文本为准"。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.1.3 成本动因）：按主编意见新增 13.1.3 经济性动因：烧不起公网 API，转而在本地运行（合规之外纯成本考量）——成本形态对比表（API 随调用量线性增长 vs 本地固定投入+低边际成本；低调用量 API 划算、高调用量/长上下文/批量本地摊薄后可低一个量级）、盈亏平衡逻辑（达到规模后显著更省，标注"教材分析非精确报价"）、案例链接（免推理 token 费 / 路由降本 / GLM 真实账单）、两点提醒（① 本地不总是更便宜，先算调用量；② "省钱"与"合规"是两个独立动因，不可用成本论证替代合规论证）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.1.3 盈亏平衡计算扩充）：按主编意见给 13.1.3 补理论计算模型——本地月成本构成表（8×H100 单台：折旧含 30% 残值 / 电费 / 机房 / 运维 / 维护 ≈ 10 万/月）+ 打平公式（本地月成本 ÷ API 混合单价）+ 两个场景（国产低价 API ≈¥3.8/百万 → 打平需 2.6 亿 tokens/日极大规模；海外前沿/涨价后 ≈¥135/百万 → 打平需 740 万 tokens/日，每天几千上万次高频场景即可）+ 一句话画像（高频调用 × 单价高 × 算力满载）；还需考虑的因素 4 条（算力利用率 50% 打平点翻倍 / 分摊模式〔算力池、云 GPU 按小时〕/ 软硬件维护常被低估 / 折旧与残值 30–40%）；全部标注"教材理论分析、示意口径，落地以官方定价与自身核算为准"。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.1.3 换 2026 口径重算）：按主编意见，盈亏平衡计算改用当前算力与模型（B300 跑 DeepSeek V4 Flash）与2026 年最新价格——硬件：B300 服务器公开市场约 700 万/台，受美国禁运与中国合规限制走非正规渠道（黑市）翻倍至约 1400 万/台（中时、FT 中文网、网易），月成本合计 ≈ 26 万/月（折旧 20.4+电费+机房+运维+维护）；API：DeepSeek V4 系 2026-08-17 峰谷定价生效（涨幅最高 1100%），高峰 output ≈ ¥27/百万（湖南日报）；打平点：平峰 ≈ 520 亿 tokens/月、高峰 ≈ 236 亿 tokens/月——2026 年自建 B300 整机打不平且非正规渠道有合规风险，现实路径改为"单卡小规模 / 云 GPU 租赁 / 国产昇腾 / 高峰走 API 混合"；考虑因素新增"采购渠道与可得性"（禁运型号非正规渠道翻倍+合规风险，替代=昇腾/租赁）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 成本分析归位）：按主编意见——13.1.3 精简为"成本形态对比表 + 两点提醒"（删 B300 盈亏平衡计算与考虑因素，避免 13.1 过长；提醒指向 13.2.8）；13.2 新增 13.2.8 高性价比档位与价格核算（以 V4 Flash 为例）——5 档硬件表（RTX 4090/5090/4×6000 Ada〔≈21 万〕/AMD MI300X〔≈10 万〕/华为 Atlas 800〔120–140 万〕+ 量化配置与吞吐）+ 均衡/企业级两档价格核算（V4 Flash 官方报价 2026-09-01：输入命中 0.05–0.10/未命中 1.5–3.0/输出 4.5–9.0 元每百万 tokens；混合 ≈ 空闲 1.9/高峰 3.8；均衡档打平 11–23 万次/日但吞吐瓶颈差一个数量级、企业级 MI300X 打平 5–11 万次/日且吞吐足够）+ 结论（V4 Flash 便宜→打平点上移；省钱替代的现实档=MI300X 高吞吐大显存单卡；Atlas 800 走合规路线）+ 考虑因素（利用率/分摊/维护/残值）+ 真实案例链接；全部标注"2026-09 口径、示意估算，以官方定价与实测为准"。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.2.7 量化讲透）：按主编意见扩充量化取舍（原来只有三行结论）——概念（量化=权重/激活压到低位宽，FP16 2 字节→FP8 1 字节→INT4 0.5 字节，显存按比例降、精度损失，权重冗余与分布集中使其可行，GPTQ/AWQ/GGUF 思路）；档位谱系表（FP16/BF16 基线 100% → FP8/INT8 50% 生产默认 → INT4/FP4 25% 慎用；W4A16 混合量化注释）；选型三步（① 显存够不够→不够才量化；② 精度敏不敏感→政务/RAG 保守 FP8 起步；③ 必须评测定档→低于验收线升一档，呼应 13.7 量化对照）；示例（V4 Flash 各档位与量化档一一对应：4090 AWQ/5090 4-bit/6000 Ada W4A16，呼应 13.2.8）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.2.5 显存规划去教材提炼）：按主编意见重写显存规划——去掉"🔶教材提炼"标注，改用公开权威口径：显存三部分（权重 + KV cache + 激活/运行时），权重每 10 亿参数 ≈ FP16 2GB / FP8 1GB / INT4 0.5GB（每参数 2/1/0.5 字节），KV cache 随上下文/并发/层数增长；估算步骤（总显存 ≈ 权重 + KV cache + 余量；卡数 = 总显存 ÷ 单卡显存，700 亿参数 FP16 ≈140GB 在 80GB 卡需 ≥2 卡示例）；来源标注 HuggingFace 显存估算器 / vLLM 官方显存文档 / 阿里云 PAI 估算指南；判读要点改为"按公式计算"（2.8T 总参 NVFP4 ≈1.4TB）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 合并 13.2.5+13.2.7）：按主编意见合并"显存规划"与"量化取舍"为新 13.2.5「显存规划与量化取舍：从模型反推要几卡」——逻辑闭环（量化决定显存需求）：量化概念 → 档位谱系表（FP16 2GB/FP8 1GB/INT4 0.5GB 每 10 亿参数）→ 显存三部分（权重/KV cache/激活，HF/vLLM/阿里云来源）→ 估算步骤 → 选型三步（显存够不够/精度敏不敏感/评测定档）→ 判读要点 → V4 Flash 档位示例；原 13.2.7 量化小节删除，原 13.2.8 档位核算顺延为 13.2.7，引用同步（13.1.3 提醒、W4A16 注、示例）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.2.5 卡数示例表）：按主编意见把"700 亿参数模型卡数估算"改为与量化档位表逐行对齐的示例表（FP16 ≈140GB→80GB 卡 ≥2/48GB 卡 ≥3；FP8 ≈70GB→≥1/≥2；INT4 ≈35GB→≥1/≥1，未含 KV cache 余量），并加一句"量化一档卡数大致减半、再降一档单卡可装"。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.2.2 算力路线重写）：按主编意见——"两条算力路线（B300 vs 昇腾）"改为"合规可得性优先的分层选择"：4 档表（国产信创〔昇腾 910C/Atlas 800，合规默认〕/ 性价比〔RTX 4090/5090/4×6000 Ada，正规渠道，留意出口管制〕/ 吞吐〔AMD MI300X，非禁运可采购〕/ 旗舰仅参照〔B300：禁运、官方不可得、非正规渠道翻倍+合规风险，本书不推荐〕）；新增"为什么 B300 不推荐"说明（呼应 13.1.1 红线三与 13.2.7 价格核算）；决策树图 13-2 的"算力栈选择"改为"按合规与预算选档（13.2.2 表 / 13.2.7）"；昇腾 910C 中流砥柱说明保留；读法更新。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.2.3 移入微调章节）：按主编意见——删除 13.2.3"推理 vs 微调硬件差异"（部署章节不插微调内容），内容并入 13.4.2 微调硬件量级开头（"为什么微调比推理吃显存"原理前置：推理=权重+KV+激活+并发；全参=梯度+优化器 4~6×；LoRA=介于两者之间 + "推理可单节点、全参常跨多机"分界说明）；13.2 编号顺延：三档选型→13.2.3、显存量化→13.2.4、服务化→13.2.5、档位核算→13.2.6；引用全同步（导学 13.2.4–13.2.6、提醒/算力路线表/图/读法/W4A16/示例→13.2.6、推理微调引用 4 处→13.4.2、三档选型引用→13.2.3；L110"决策三要素同 13.2.3"顺带修正为"同 13.1.2"）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.2.5 服务化写厚）：按主编意见扩充模型服务化与推理引擎（原来只有引擎表 + 一段口诀）——服务化是什么（把模型包装成可并发服务的 OpenAI 兼容 API）；引擎选型表（vLLM 生产默认 / TensorRT-LLM 极致优化 / Triton 多模型网关 / MindIE 昇腾）；三个关键机制（Continuous batching / PagedAttention-KV 分页 / Prefix Caching，解释"同卡多并发"与 RAG 前缀命中降本）；多卡并行策略（TP 单机 / PP 跨节点 / DP 多副本 / EP MoE 专家并行）；生产部署要点（K8s+GPU Operator / 网关限流鉴权灰度〔呼应 11.8.3〕/ 监控 / 多副本灰度〔呼应 13.7〕）；呼应句（引擎决定 13.2.6 吞吐上限、服务化是 13.7 回填承载）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 微调四节合一）：按主编意见——13.3（微调判断）+13.4（方法）+13.5（流程）+13.6（成本）四节合为一节新 13.3「微调：判断、方法与成本（进阶选读）」：13.3.1 什么时候才轮到微调（原 13.3 三子节压平为加粗小标题）；13.3.2 三种微调方法（原 13.4.1）；13.3.3 硬件与成本量级（原 13.4.2 + 原 13.6 合并——消除雷同：两张"模型量级 × 方法"坐标表合一〔卡数表 + 费用量表并列〕、"教材落点"与"决策口诀"合成一条、B300 采购行删除〔13.2.6 价格核算已覆盖〕）；13.3.4 一次微调的典型流程（原 13.5 + 数据治理 Gate 改加粗子块）；后续顺延：回填 13.7→13.4、判断清单 13.8→13.5、实验 13.9→13.6、速查 13.10→13.7（子节 13.7.x/13.8.x/13.10.x 同步）；导学主线必读/学习目标/章节地图同步；跨章引用同步（Ch7 10 处 13.10→13.7 + 1 处"13.3 私有化"→13.2；Ch16 13.7 模型切换适配→13.4；Ch3/Ch8/Ch9/Ch10/Ch11/导读"13.3 私有化/出域"错位引用顺带修正为 13.2 系；Ch13 内 13.5.1/13.6/13.8/13.9/13.10 引用约 20 处全同步）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 微调节继续收拢）：按主编意见——13.5（判断清单 + 红线呼应）与 13.6（实验）并入 13.3：判断清单并入 13.3.1 末尾（"判断清单（落地勾选）"六项 + 反例，消除与判断逻辑的重复）；红线呼应成为 13.3.5；实验成为 13.3.6（两块移至 13.3.4 与 13.4 之间）；速查 13.7→13.5（子节 13.5.1–13.5.3）；引用全同步（Ch13 内 13.5/13.6/13.7 系引用约 10 处、Ch7 10 处 13.7→13.5）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 13.3.3 在售配置重写）：按主编意见——13.3.3 去掉"示例口径，非在售配置"标签，改用在售配置计算：原理前置（推理 vs 微调显存差异）保留；抽象"模型量级 × 方法 → 卡数"表与费用量表合并重写为"在售配置怎么选"表（与 13.2.6 同一批在售硬件：RTX 4090 0.5–0.8 万 / 5090 2–3 万 / 4×6000 Ada ≈21 万 / MI300X ≈10 万 / Atlas 800 120–140 万 / B300 仅参照）——每行给出购置成本 + 能跑的微调（模型量级×方法）+ 单次微调成本量级；新增单次微调成本演算（人力=大头 + 折旧 + 电费，示例：4×6000 Ada 跑 70B LoRA 2 天 ≈ 数千元级）；教材落点改"不是为微调买硬件，而是买来既跑推理也跑微调"；13.5.3 标题同步改"容量规划示例"、小结费用口径对齐（LoRA 千元~数千元级 / 全参数万~数十万元级）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 速查同步 + 标题去括号）：按主编意见——13.5 速查同步课程最新模型与硬件：模型速查补 DeepSeek V4 Flash 档（13.2.6 核算主角，附官方报价 2026-09）与 BGE-M3（第 9/10 章本地 embedding）；硬件速查从 2 行扩为 7 行，补齐正文全部在售硬件（RTX 4090 / 5090 / 6000 Ada / MI300X / Atlas 800，均给官方来源；B300 / 910C 保留）；Ch13 章节标题全部去括号（10 处）：13.1.1/13.1.2（提出问题/解决问题）、13.2.5（企业做法）、13.2.6（以 V4 Flash 为例）、13.3（进阶选读）、13.3.3（信息截至 2026-08，时效移正文）、13.3.6（可选动手）、13.5（附录式）、13.5.1（截至 2026-08）、13.5.3（说明移正文 NOTE）。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 全库标题去括号）：按主编意见"章节标题尽量不用括号"，全库 16 个正文文件 + 导读约 60 处说明性括号标题去除——删除或改冒号（如"8.1 知识背景（呼应第 7 章）"→"8.1 知识背景"、"6.4.7 环节 7 ·（可选）用 AI 当红队…"→"环节 7 · 可选：用 AI 当红队…"、"9.10 最小 RAG 预实验（可选动手，20–30 分钟）"→"：可选动手 20–30 分钟"）；保留类约 24 处（术语注释〔Airbus（空中客车）、（Deployment Strategist）、（Embedding）、（HITL）、（Lab4B）〕、时间范围〔（2018–2022）〕、环节时长〔（约 X 分钟）〕、DoD 术语、导读体例模板示例）；速查类标题的时效标注移入正文。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 全局格式 review 修复）：按《FDE教科书全局格式检查规范_v0.7》全局扫描，修复正文带圈数字残留（Ch13 13.1.3 提醒、13.2.6/13.2.7 结论、Ch14 导学 Delta 三项职责、Ch15 小结四节结构，①②…→1. 2. …，全书带圈数字清零）、Ch2 图号断档（折线图 图 2-5→图 2-4，恢复 2-1→2-4 连续）、Ch10 失效引用（9.7.3→9.7.2，Ch9 §9.7 仅 9.7.1/9.7.2）、11 处裸代码块补语言标注（导读骨架、Ch4/5/6/7/8/10/12/16 输出示例 ```→```text）。正文式开篇词（D2 系统性补写）留待后续轮次。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · Ch13 小节开头精简）：按主编意见——删除 13.2、13.3 的承接过渡段（"承接 13.1 选型，当数据敏感度判出不能上云……"与"承接 13.2——……本节按……讲四件事"，口吻像讲稿而非教科书正文；所承载的信息〔条件化声明、行为类入口、四件事导航〕正文各处已覆盖）；13.4 开场由引用块 + IMPORTANT 改为正文段落（"第 8、10、12 章的三个 Demo……"场景段与"答案是：功能会漂移……"结论段均为普通正文）；13.4.1 接口层一段改无序列表（超时重试 / 参数通道 / 并发限流三项拆为 bullet，与行为层、质量层的列表格式统一），"自建 provider 适配层"与"西岭例"两段改引用块；13.4.7「迁移问题」归位——标题词不达意（"迁移"既指切换又指经验迁移），改为："三种切换路径的适配深度"并入 13.4.4 决策依据（做成"切法 × 适配工作量 × 行为差异 × 适用"小表，决策顺序"先试最轻的切法"）；13.4.7 改名「经验沉淀：切换资产的可复用性」并加厚（provider 适配层进 14.9 回注、切换基准集进第 7 章纪律四案例、适配清单沉淀为团队检查清单）；删除 13.4.5 反模式 / 13.4.6 练手 / 13.4.7 经验沉淀三节（按主编意见——反模式与章末"反模式与红线"的"把切模型当换 base_url（对照 13.4）"重叠、练手与 13.6 实验的切换衔接重叠、经验沉淀信息已散见 13.4.1/13.4.2 正文；13.4 精简为 13.4.1–13.4.4）。Ch13 全文通读适配：删除 L3"（原第 7 章 7.3/7.4/7.8.1 的模型内容并入本章）"内部解释表述；"两条算力路线（B300 / 昇腾）"旧表述全清（产出/学习目标 1/图 13-1/小结/挑战/13.3.5 红线表改"合规可得性分层"口径）；"选型三要素"→"选型三问"（产出/13.2.1 落地判读/13.2.2 政企默认做法）；学习目标 1 的"推理 vs 微调硬件差异（13.1–13.2）"改指 13.3.3；13.2.3"原型一卷点一句"笔误修正；13.5.1 V4 Flash 行"系列"列补"（同上）"。全库跨章残留扫描：Ch8 延伸阅读与知识背景"选型三要素（13.2）"→"选型三问（13.1.2）"（任务复杂度/数据敏感度/部署约束三点并入三问口径）；Ch9 章节地图 mermaid"选型三要素"→"技术选型"；Ch13 前置知识"已并入本章"内部表述改为直接列小节；Ch7 挑战题"双栈"旧表述→"算力路线分层"。Ch14 四阶段口径同步与 Delta Scale 职责优化（按主编意见"结合全书修改同步 + 按四段交付优化 Delta 在 Scale 的职责"）：章首定位加四阶段坐标（Build 收口 + Scale，坐标第 3 章 3.3、角色第 4 章 4.6）；导学新增"Delta 在 Scale 阶段的三项职责"（生产评估 14.2/14.5、自运营交接 14.8、能力回注 14.9，Echo 管业务侧、Engineering 管运维深水区）；14.1 五转换标注 Build（转换 1–3）/ Scale（转换 4–5）归属；14.5 八项 Gate 对照第 3 章 3.3.2（Build Gate 工程侧展开，14.8 撤出喂给 Scale Gate）；14.7 生产保障深水区明确由 Engineering（3.2.3）或客户平台团队承接；14.7 灰度回滚与 14.9 provider 适配补第 13 章最新引用（13.4.2 / 13.4.4 / 13.4.1）；小结开头加"Delta 在 Scale 三项职责"条。Ch15 三块结构重组 + 删 15.8/15.9（按主编意见"15.1 做开口、15.2–15.3 用 ROI 说服领导/项目负责人、15.4–15.6 让用户采纳推广、后面讲能力回注、15.8/15.9 偏实操介绍可不要"）：15.2/15.4/15.7 开头分别加"第一部分 · 对决策层证明价值 / 第二部分 · 推动用户采纳与推广 / 第三部分 · 能力回注"定位句；导学章节地图、小结改为三块结构；删除 15.8「承上启下：为第 16 章准备业务证据包」与 15.9「通用性：复盘真实项目」（15.8 的准备清单由 16.4.4 决策单承载、15.9 由 labs/migration-review-real-project.md 与 16.4.6 出口承载），15.7.7 末尾补一句"三块证据合成第 16 章业务证据（16.4.4）"衔接；引用同步（Ch16 两处 15.8 引用改 15.2–15.3 / 15.2–15.7；小结 15.1/15.8 改三块；"业务证据包"统一改"业务证据"）。Ch15 改为四节结构（按主编意见"一共就四节：开场 / 对决策层证明价值 / 推动用户采纳与推广 / 能力回注"）：15.1 开场（原 15.1）→ 15.2 对决策层证明价值（15.2.1 价值证据链 = 原 15.2、15.2.2 价值口径 = 原 15.3）→ 15.3 推动用户采纳与推广（15.3.1 组织采用 = 原 15.4、15.3.2 干系人表达 = 原 15.5、15.3.3 业务 Scale = 原 15.6）→ 15.4 能力回注（15.4.1–15.4.7 = 原 15.7.1–15.7.7）；大节标题下加定位句（原"第一/二/三部分"NOTE 并入）；内容与图表不变、编号层级重排；全库引用同步约 25 处（Ch1/2/3/5/6/8/10/12/13/14/16 的 15.7→15.4、15.3→15.2.2、15.4/15.6→15.3.1/15.3.3 等）。Ch15 15.1 开场加厚（按主编意见"开场太薄、三话题只提了两个、必须说能力回注；作为收束章要结合第 3 章内容营造最后一幕"）：开场重写为"前三幕（Discovery 6 / Prototype 8-10-12 / Build 14）→ 最后一幕 Scale"叙事，回扣第 3 章 3.3.2 Scale Gate 三份证据；新增三话题表（对决策层证明价值 15.2 / 推动用户采纳与推广 15.3 / 能力回注 15.4，各自对应 Scale Gate 与"卖人力→卖能力"主线）；"两个不等于"升级为三个不等于（价值成立 / 组织愿意采用 / 能力回注平台，呼应第 2 章飞轮与 14.10 工程侧三个不等于）；Scale Gate 位置 NOTE 改为三证据 × 三话题对应（客户自运营←15.3+14.8、回注复用←15.4+14.9、飞轮指标←15.2+15.3.3）；学习目标 1、一句话主线、小结同步三话题。Ch15 开场去指针（按主编意见"不要对本章内容做过多的指针，尤其是在表格里"）：15.1 三话题表的"对应"列去掉全部子节编号（15.2.1/15.3.1/14.8 等）改纯概念（Scale Gate 通过证据 / 客户能自运营 / 第 3 章四步法）；话题名去掉（15.x）括号；位置 NOTE 的编号箭头简化（每项只保留一个大节编号 + 第 14 章）；15.3.3 扩大范围 Gate 表内的子节编号也文字化（"回'组织采用'一节"、"价值证据链"）；开场首段"第 3 章 3.3.2"简化为"第 3 章"。Ch15 15.2 重构（按主编意见"15.2 开场像目录要改；开场要说明为什么决策层更关注业务价值成立（在工程验收之上）+ 怎么把核心业务价值说清楚 + 放流程图不做细节；15.2.2 公式不要堆一起、每公式单独解释、拆成两节——ROI 与口径精确定义一节、估算方法与话术一节"）：15.2 开场改正文式——讲"决策层在工程验收之外更关心业务价值"（工程验收通过 = 能用，业务价值成立 = 该投入）+ "把核心价值说清楚 = 一条证据链"，价值证据链流程图（图 15-1）上移到开场（F 节点去编号"五类口径"）；15.2.1 改标题「证据链怎么走：以诉求分类器填实六环」（去掉重复引言）；15.2.2 拆两节：15.2.2「价值口径：五类口径的精确定义」（年度价值/年净收益/TCO/ROI/回收期，公式不再堆一个代码块，每个公式加粗成行 + 单独解释）；15.2.3「估算方法与汇报话术」（三类价值公式表、年运行天数来源、口径第一、给区间不给单点、对决策层话术、标来源、书面锁口径）；引用同步（16 章 2 处 15.2.2→15.2.3、反模式锁口径→15.2.3、小结拆 15.2.2/15.2.3）。Ch15 删目录式概述引文（按主编意见"15.3 这种目录式的概述引文一律不要"）：删除 15.3 大节标题下"三节讲透这块：门槛·动机·信任（15.3.1）…试点→推广 Gate（15.3.3）"的罗列引文；删除 15.2 开场末尾"下面把这条链的每一环展开…"的概述句；删除 15.4 大节标题下"把跨客户的价值带回平台…"的主题概述引文（保留"回注不是单方职责"实质引文）。Ch15 15.3/15.4 补章节开篇词（按主编意见"15.3、15.4 也需要像 15.2 那样的章节开篇词"）：15.3 加正文式开篇（讲"决策层点头 ≠ 系统被真正用起来，操作层/技术层/监管层在意好用/添麻烦/找谁 → 门槛·动机·信任"）；15.4 加正文式开篇（讲"项目交付不是终点，能不能把能力带走才是——卖人力→卖能力分野，回注是 Scale Gate 回注候选"），均非目录/引文式。联动更新：misc/FDE教科书整改问题台账_v0.7.md。
  • v0.7（2026-08 · 教学站点上线）：fde-102 教科书 GitHub Pages 阅读站建成——MkDocs Material（Python 3.11；插件 search / callouts；扩展含 pymdownx.superfences 的 mermaid 自定义围栏、arithmatex + KaTeX、tasklist、magiclink、admonition），站点 URL https://www.cloudzun.com/fde-102/；新增 scripts/build_docs.py（由 textbook/ 单一底稿重建 docs/，docs//site/ 不入库）、index.md 首页、.github/workflows/pages.yml（push main 自动构建并部署 gh-pages，peaceiris/actions-gh-pages@v4）、本地 vendor（katex / mermaid）+ assets/extra.css 主题与字体栈；nav 覆盖 00 导读 + 第 1–16 章（三篇分组）。mermaid 深底深字修复：Material 将 mermaid SVG 置于 closed shadow DOM，页面 CSS 无法触及，改用 javascripts/mermaid-themefix.js 包装 mermaid.initialize 注入 themeCSS 强制深色节点标签为白字（mermaid-contrast.js 为 DOM 兜底）。联动更新：AGENTS.md（仓库概况、目录规范）、.gitignore。
  • v0.7（2026-08 · 导读精简）：00_导读与体例说明.md 收敛为"引言与使用指南 / 读者画像与使用方式 / 全书 16 章结构"三块（含单案例贯穿），去掉五个项目实操的综合介绍及先修、环境、能力地图、认证、体例等章节。联动更新：AGENTS.md（结构与目录说明）。
  • v0.7（2026-08 · 书名统一）：全书书名统一为《FDE 实战：Echo 与 Delta 的交付之道》——导读第 1 行 H1 与 AGENTS.md 仓库概况同步；ppt/、misc/、references/ 保留旧名（非交付正文）。
  • v0.7（2026-08 · 渲染修复批）：按 MkDocs 实际渲染逐项修复 markdown 排版——1）16 章章首引用块按字段分行（字段行之间插入空引用行 >，消除字段挤成一团）；2）「学习目标」嵌套列表缩进 2→4 空格（渲染为嵌套 <ol> 而非散开的并列项）；3）15 章「动手自检」的 - [ ] 列表前补空行（否则被并入上一段落、checkbox 渲染为纯文本）；4）14 个文件共 43 处"段落行紧邻列表无空行"补空行（含第 2 章 8 条鉴别量表、各章 DoD / 关键决策点 / 分类 / 原则等列表）；5）5 个文件共 25 处嵌套子列表缩进 2→4 空格（第 5 章 SOP1/SOP2/SOP3 步骤、第 7 章压缩走查、第 8 章追加项、第 9 章三条判据与预实验步骤、第 13 章三个子条件）；6）mkdocs.yml 启用 pymdownx.magiclink 使裸 URL（FDE-101 链接）自动可点击。以上仅改空行与缩进，正文文字零改动。联动更新：AGENTS.md 3.6 增补"列表前必须空行""嵌套子列表缩进 4 空格"两条排版纪律。
  • v0.7（2026-08 · 第 13/14/15 章审校整改）：按三路评审整改第 13/14/15 章逻辑、准确性与格式问题（含跨文件联动）——第 13 章：型号与报价更新为现行官方数据（V4.1-Flash，旧名已退役）、价格核算整段重写为可复算三表（汇率 / 混合比例 / 折算公式齐备，打平点含"月→日"换算链）、全章时间口径改 2026-09、验收口径对齐第 8 章（自信区 ≥85%）、B300 移出交付主力档、折旧口径与 13.3.3 同源；第 14 章：删除内部编辑指令泄漏（"九维 Build Readiness Gate"，红线级）、"移入附录"改真实落点、五转换与三项职责对齐、本体三级命名对齐第 15 章、案例补锚点并新增案例索引表；第 15 章：质量型 / 收入型公式修正（量纲错、缺转化率因子）、三场景数值重算为可复算、三块拼图口径对齐第 16 章、失效指标出处修正、收益分类统一为效率 + 质量 + 收入增益 + 风险避免、ROI / 净收益 / TCO 口径与成本边界澄清。跨文件：resources/ 章节号错位修正（15.5~15.7→15.2.3 / 15.3.2 / 15.4）、ROI 模板公式与正文同步、图表索引补图 15-2 并顺延。联动更新：resources/ 六份模板与索引文件。
  • v0.8（2026-09 · 引用克制与章首体例轮）：按主编意见清理影响阅读的引用、冗余标注与章首重复，全库执行——1）引用克制纪律：删除本章内小节号引用（"见 N.x"式），跨章引用收敛到核心概念与基本流程（Echo/Delta 分工、四阶段交付、四条红线、能力回注、"卖人力→卖能力"主线、五实操总分总收口），保留图 N-x / 表 N-x 就近指引与"下一章"导航（不带章号）；2）溯源克制：不再在正文逐处插入"教材提炼 / 教学假设 / 待核验 / 信息截至 YYYY-MM"等来源性质标注，改由导读「关于本书内容性质」一次性总声明交代（外部来源 URL 一律保留）；3）章首体例统一：16 章统一为"引用块（本章定位 / 建议读者 / 前置）+ 本章学习目标编号列表"，删除 ## 本章导学 容器及「本章产出」「前置知识」「章节地图」三个与引用块内容重叠的字段，删除第 7/9/11/13 章章首 mermaid 导航图（该四章正文图号顺延，跨章图号引用同步）；保留各章「一句话记住」与实操章「学习目标追踪」表；4）残留节号清理：正文、表格与 mermaid 节点中残留的 N.x 引用全部去号（4.1 / 7.3.2 / 9.3–9.9 / 9.9.5-2 / 10.2 / 11.3.5 / 11.6.3 / 12.2 / 13.2.2 / 13.2.6 / Ch3 3.3.2 / Ch3 3.5 等），实操三 / 四「学习目标追踪」表活动列改用"环节 N <名称>"表达；5）第 13/14 章章首瘦身：向其他章节体量靠拢（13 章 1188→631 字、14 章 1344→807 字，全书章首字数中位数 761 字）——13 章「定位说明 / 主线必读与进阶选读」并为「阅读方式」、学习目标去枚举；14 章「实验设置 + 本章属性」并为「实验设置」、删除与定位重复的"三项职责"段、原章首"三个问题"下移为 14.1 正文开篇。联动更新：AGENTS.md 3.2（章首模板 + 章首纪律）、3.6、7（引用克制纪律）、8（溯源纪律）、9.1（版本号 v0.8）。
  • v0.8（2026-09 · mermaid 深底深字修复轮）：作者发现第 13 章「3. 合并 or adapter？」深底菱形文字仍是深色。根因：javascripts/mermaid-themefix.js 追加的 themeCSS 只按 rect 写选择器，而决策节点是 <polygon>（另有 circle / ellipse / path），未命中覆盖规则，文字仍被 Material 的 .nodeLabel p{color:var(--md-mermaid-label-fg-color)} 染成深色。修法：形状列表扩为 rect / polygon / circle / ellipse / path，兄弟选择器为主，另加 :has() 兜底并单独成规则（不支持 :has() 的浏览器只丢弃该条）。验证：jsdom + 本仓 vendored mermaid 11.16.1 + Material 真实 themeCSS 逐图复算——全库 55 个 mermaid 图块、30 个深色填充节点（rect 27 / polygon 3）；修复前 30/30 文字计算色为 var(--md-mermaid-label-fg-color)，修复后 0/30、全部 rgb(255,255,255)；受影响的 3 个深色菱形为第 13 章 图 13-1（q0 数据能否出域？）、图 13-2（M 3. 合并 or adapter？）与第 15 章 图 15-2（G 扩大范围 Gate）。删除 javascripts/mermaid-contrast.js：v0.7「教学站点上线」条目所称的 DOM 兜底——经证实用 document.querySelectorAll 无法穿透 Material 的 closed shadow DOM，从未生效。新增回归检查 scripts/mermaid-dark-node-check.js（+ scripts/package.json 声明 jsdom 依赖），并入 9.2 核验清单；支持 --nofix 基线自检与 --verbose 明细。联动更新：AGENTS.md 2（目录规范加 scripts/、3.4 mermaid 纪律、9.2 核验清单）、mkdocs.yml（移除 contrast.js）、scripts/build_docs.py（注释同步）。
  • v0.8（2026-09 · 小节口水句清理轮）：作者指出第 7 章 7.4 标题下"coding agent 解决'怎么写'，harness 解决'怎么不翻车'"这类标题后一句口号读感尴尬。遂逐节复核全书 115 个 ## 小节的首个内容块，清理同类的"没话硬说"共 13 处 / 8 章：1）孤立口号——7.4 删句（7.4.1 首段已把同一件事讲全）、7.3 删空话首句"执行要靠 coding agent 承载"；2）自我评价式元叙述——1.5"这是全章最重要的判断标准"、4.5"这是全书最重要的分工观念，它回答…也回答…"；3）章内自我叙述——2.6"到这里，本章完成了它的任务——"改为"本章立住了…"、14.6"本节讲…"改为直陈；4）纯图表/列表引出句——2.2"要理解…最好把它放到…坐标系里对照"、4.6"下面这张矩阵告诉你…"、11.2"从最简单开始，选该用哪一层"、5.1"Echo 进驻客户后的第一原则"、5.9"AI 时代 Echo 也可以借力，但要守住一条铁律"；5）空话收尾——5.2 删"它们是 Echo 的核心知识"；6）跨章措辞重复——6.2 与 5.2 同用"不是'随便聊聊'"，6.2 改实操口吻。处理原则：只删空话、不编新内容；删除后标题直接接表格 / 引用块 / 子节，与全书主流形态一致（另有 44 个 ## 小节本就无正文段，属正常体例）。净减 12 行，固定结构计数（标题 / 表格 / 图 / 复选框 / 链接）零变化；mkdocs build --strict 与 scripts/mermaid-dark-node-check.js 均通过。联动更新：8 个章节文件。
  • v0.8（2026-09 · 格式与体例统一轮）：作者提出"在确保核心文本不变的前提下优化格式与体例"，遂先做全库审计（115 个 ## 小节、55 张图、146 张表、16 章章首），再分四批落地。批次 A 体例统一（只换符号与包装）——1）并列分隔符统一为 A / B：修正 28 组"同一词对两种写法并存"（Echo/Delta 与 Echo / Delta、超时/重试、行为/格式、分类/RAG 等）共 54 处，并逐条显式修正 17 处因此产生的"混合链"（性能 / 安全/合规 → 性能 / 安全 / 合规）；单位型（699元/月）与复合词（本地/微调）按新规保持紧凑；2）语义引用块升格为 Alert 自定义标题 12 处（> **注意：** … → > [!NOTE] 注意），统一 RED 线块为 [!IMPORTANT]，并清理 2 处既有空标记叠加（原「口径说明 / 口径第一」块本就是 Alert，初次误改后已回滚）；批次 B 结构对齐——1）实操一章节名与其余实操章对齐（实操概述→演练背景，去「知识背景 / 任务书」副标题，「产出物清单」+「完成标准（DoD）」合并）；2）「下一章」导航统一为 - **下一章：** <章标题>（<说明>） 并补齐第 1–5 章（第 2 章删去与之重复的章内过渡句，末章不写）；3）§8 过程性标注清理 8 处（第 9 章 ×5、第 11 章 ×3，删「截至 2026-08」类时间标注、保留"以官方…为准"；第 13 章价格表报价时点属数据口径，按 §3.5 保留）；4）连接符定则落地——流程序列改 →（输入 → 步骤 → 输出 → …、暂停 → 接收人工输入 → 从断点恢复、试点 → 推广流程、拆解 → 复盘），数值区间 4—6/3—5 改 en dash 4–6/3–5；批次 C 自动化——新增 scripts/style-lint.py（零依赖），机器化检查固定尾部节齐全与顺序、N.x 编号连续、裸代码块、连续 Alert、语义标签式裸引用块、混合分隔链、单位被拆、图号连续、下一章 覆盖、章首字段、文件尾换行、过程性标注、标题中英空格、复选框前空行、嵌套缩进；已做灵敏度自检（注入违规报出 7 个 ERROR，恢复后 0/0），并接入 .github/workflows/pages.yml 作为部署前阻断步骤；批次 D 站点侧（md 基本不动）——1）启用 navigation.footer（上一页 / 下一页）、navigation.instant.progress、search.share；2）搜索启用中文分词 search: lang: [zh]（构建期依赖 jieba，已加入 CI 安装项），索引已按词切分（原先整段不切词、中文检索几乎不可用）；3）新增 mkdocs-print-site-plugin 生成「打印与离线阅读」单页（整本 680KB，供打印 / 离线），不生成 PDF 以避免引入 weasyprint 系统依赖。联动更新：AGENTS.md 3.2（实操章节序 + 两处例外）、3.3（Alert 语义与"标签升格为标题"）、3.5（表不编号 + 表内时点标注）、新增 3.6 标点与符号体例（原 3.6/3.7 顺延）、7（「下一章」统一格式）、2（scripts/ 加 style-lint.py）、9.2（核验清单加体例检查）、.github/workflows/pages.yml、mkdocs.yml。两项经评估后暂缓：① 第 13 章「进阶选读」折叠（章首列出的主线 / 进阶边界与小节并非一一对应，需作者确认要折叠哪几节）；② 宽表格窄屏横向滚动（display:block 两类写法对"窄表是否铺满"影响不同，需浏览器实拍确认后再定）。
  • v0.8（2026-09 · 引号口径固化）：作者说明——本书正文会被复用进课件 PPT，全角引号在 PPT 文本框与生成链路里会出问题，故引号是刻意保留的半角标点例外（此前规范只写了"沿用既有口径"，未交代原因，容易被后人当疏漏"修正"）。据此：1）AGENTS.md 3.6 把引号从"沿用口径"改写为硬约束并写明 PPT 复用原因，3.8 标注"全角标点不含引号"；2）消除全书残留的 6 对全角/直角引号（第 7 章「AI 万能论」「AI 与己无关」及 mermaid 节点、第 9 章红线块、第 10 章"按条组织"、第 11 章 11.2 节标题的弯引号），全库现为 0 个 “ ” ‘ ’ 「 」；3）mermaid 节点文本内不能用半角 "（与 ["…"] 分隔符冲突），改用 HTML 实体 &quot;——已用 jsdom + 本仓 vendored mermaid 11.16.1 实测：&quot; 渲染为 "，而 &#34; 会被渲染成字面量 &"（不可用）；4）scripts/style-lint.py 增加第 16 项检查（正文出现全角/弯引号即 ERROR），该口径从此机器把关。联动更新：AGENTS.md 3.6/3.8、scripts/style-lint.py、第 7/9/10/11 章。
  • v0.8（2026-09 · PPT 复用友好纪律）：作者补充关键背景——本书正文会被复用进课件 PPT（ppt/ 为 pptxgenjs 生成），这是"引号刻意用半角"的根因，也牵出一条此前未成文的写作约束：站点专有语法（> [!NOTE] 注意、- [ ]、表格分隔行、```mermaid 围栏、<br/>）在 md 源里是可见字符，摘进 PPT 会变成噪音；反过来若只按渲染页取文本，则"信息只存在于 Alert / 图内"同样会丢失。据此新增 AGENTS.md 5.4「PPT 复用友好」写作纪律：总原则是"站点语法用于强调与装饰，不作为信息的唯一载体——去掉所有标记后同一句话仍要完整可读"，并落成 6 条可执行规则（结论放普通段落/列表项、Alert 块内不写依赖版面的指代、图表都要有"一句话结论"、复选框清单要有概述句、不嵌套 Alert、关键数字写进句子）。按此纪律清理：第 5 章两处「坐标轴的读法」块尾的"四象限策略对照见下表："、第 7 章工具节块尾的"（海外见本表，国内见下表）"——共 3 处引用块内版面指代已删除，块内文字可独立成立。scripts/style-lint.py 扩到 19 项：新增 17）mermaid 图与图题一一配对（每张图必须带 *图 N-x：标题*，当前 55 图 / 55 题全配对）、18）引用块内版面指代（限 > 块内——正文段落里紧跟表格的"见下表"是正常写法，不报）、19）嵌套 Alert（ERROR）。联动更新：AGENTS.md 3.6（引号硬约束写明 PPT 原因）、3.8、新增 5.4、9.2（核验清单）、scripts/style-lint.py、第 5/7 章。

  • v0.8（2026-09 · 撤下「全文阅读和打印」单页）：作者决定不要整本单页功能（原 https://www.cloudzun.com/fde-102/print_page/）。移除 mkdocs.yml 的 print-site 插件与 .github/workflows/pages.yml 的 mkdocs-print-site-plugin 依赖；构建不再生成 print_page/，导航项「打印与离线阅读」随之消失（上一条目所述的该功能已作废）。保留同一批次引入的中文分词检索（search: lang: [zh] + jieba）与 navigation.footer / navigation.instant.progress / search.share。联动更新：mkdocs.yml、.github/workflows/pages.yml。

  • v0.8（2026-09 · 术语口径统一：第四条红线的表述）：作者指出"人能判断、AI 能执行"这个表达较粗糙，全书统一为 "人做判断，AI 负责执行"。改动覆盖 4 种既有写法（人能判断、AI 能执行 28 处、人能判断·AI 能执行 6 处、人能判断 AI 能执行 2 处、人能判断，AI 能执行 1 处），共 37 处 / 16 个文件：AGENTS.md 术语统一表、index.md 首页红线、resources/certification/（一票否决口径 ×2）、resources/index/figures.md（图 4-5 索引）、正文第 03/04/07/08/11/12/13/14/15/16 章（含 4.5 节标题、图 4-5 图题、11.8.3 节标题与四张红线对照表）。保留未改：本修订记录 v0.7 条目对旧标题的历史引用（9.2「只追加、不删改历史条目」）；第 11 章"让人能判断而不是盲批"是与红线不同的构造（讲确认界面要让人做得出判断），不在替换范围。写作口径：新表述按 3.6 中英文空格纪律写作 AI 负责执行（AI 与 负责 之间留半角空格），不是 AI负责执行。核验：全库 人能判断 残留 0（仅修订记录历史引用除外）；站内锚点链接 0 处，故 4.5 / 11.8.3 标题改名不影响任何跳转；scripts/style-lint.py 0 ERROR / 0 WARN；mkdocs build --strict 通过。联动更新：AGENTS.md 6（术语统一表）、index.md、resources/、第 03/04/07/08/11/12/13/14/15/16 章。

  • v0.8（2026-09 · 第 11 章 11.1.3 补决策循环图 + OODA 溯源）：作者指出 11.1.3"决策循环"只有四条文字说明、建议配 mermaid 图，并要求补充与 OODA 循环的关系与区别。1）新增图 11-1「决策循环」——8 个节点 > 4，按 3.4 规则用垂直布局 flowchart TB：观察 → 思考 → 行动 → 再看结果四步成环，"再看结果"（菱形判断）接三条出口：直接交付 / 继续处理（回到观察）/ 升级人工；全部浅色填充，不引入深底深字风险。原图 11-1~11-4 顺延为 11-2~11-5（本章图题与 resources/index/figures.md 同步），全章现 5 图 5 题。2）新增 OODA 对照段（置于"循环四条说明 + 图"与"单次调用 / 工作流 / 智能体三方案对比表"之间）——点明这四步与 OODA 循环（Observe → Orient → Decide → Act，美国空军上校约翰·博伊德在 1970 年代初提出，附概念链接）同源，给出逐步映射（观察 ↔ Observe、思考 ↔ Orient + Decide、行动 ↔ Act、再看结果 ↔ 下一轮 Observe），并列三条差别：① OODA 面向对抗、比的是循环速度；② 智能体多出上下文窗口 / 记忆 / 工具权限 / 幂等审计 / 成本超时 / 人工升级一整套工程约束；③ OODA 的关键在"定向"（Orient）而非"决策"（Decide），对应到智能体即上下文工程、记忆与路由。末句归纳同类循环（ReAct、感知 → 规划 → 行动、PDCA、控制论反馈回路）的共同内核：不是输入直接到输出，而是感知 → 推理 → 行动 → 反馈 → 再调整。溯源说明：OODA 的概念、提出者与年代以正文所附链接页为出处；"Orient 是重心"这一表述源自博伊德本人的论述与后续研究（正文该链接页未展开这一点），如需更严出处可另补 Boyd《The Essence of Winning and Losing》一类原始文献。3）修复 resources/index/figures.md——该文件生成于 v0.7 之后未随正文维护，上一轮删除第 7/9/11/13 章章首导航图、并对 7/9/11/13 章图号顺延后未同步：现补第 7 章 7-1~7-4 条目、改正第 9 / 11 / 13 章条目、删除已不存在的"本章位置"图号；第 2 章的"图 2-4 经验曲线"实为未编号插图（assets/experience_curve.png，全书唯一一张非 mermaid 插图），改为单列说明，不再占用图号。对账后：索引 56 条 == 正文图题 56 条 == mermaid 块 56 个，逐章图号 1..n 一致。核验：scripts/style-lint.py 0 ERROR / 0 WARN；mkdocs build --strict 通过；scripts/mermaid-dark-node-check.js 通过（56 图块 / 30 个深色填充节点 / 文字非白色 0）；新增图另用 jsdom 单独渲染验证——8 个节点标签与 8 条连线全部完整。联动更新：第 11 章、resources/index/figures.md。

  • v0.8（2026-09 · 语体纠正：11.1.3 通用化 + 新增 5.5「不写成实验手册的说明书」）：作者指出上一轮把 11.1.3"决策循环"写成了带具体场景的操作步骤（"观察：拿到一个工单、一笔交易、一个任务""行动：调用工具、查数据、生成处置意见"），犯了本书的忌讳——不要把教科书写成实验手册的说明书；这四个环节要通用化。1）11.1.3 四个环节通用化：改为"观察：接收输入，读取环境状态与上一轮动作的反馈 / 思考：理解局面——这是什么情况、要达成什么、下一步做什么 / 行动：调用工具或执行动作，改变环境、产出结果 / 再看结果：评估这次动作的效果，决定收尾、再来一轮，还是转人工"——去掉只在某个场景成立的对象名，只留结构性四环节。2）图 11-1 改为通用结构图：节点收敛为四个环节名（观察 / 思考 / 行动 / 再看结果）+ 入口"输入 / 事件 / 环境变化" + 三条出口（收尾结束 / 再来一轮 / 转人工），不再复制正文长句——图只承载拓扑（成环 + 三出口），语义由图题与正文承担。3）出口用词统一为"转人工"（全书主导词 112 处，不用"移交人工"）。4）新增 AGENTS.md 5.5「教科书语体：不写成'实验手册的说明书'」：总原则"正文写'类'，手册写'例'"，落成 5 条——概念段不写操作动作（判断标准/验收口径属"方法"可写，命令参数界面路径属"执行"不写）／抽象描述换任何场景都要成立／例子要标明"以 X 为例"且定义在前／序列语言分级（第一步 → 第二步 属实操章与手册，概念段用"环节/要素/阶段"）／改概念段先自问"删掉场景名词后还成立吗"；并同步进 11 红线与 9.2 核验清单。该条不设机检：试点审计（8 类操作动词关键词扫全书）命中 25 处，逐条核对全部合法——实操章的执行语言（第 6/8/10/12 章"打开《解决方案框架》"）、比喻用法（第 2 章"回到第 1 步"描述死亡螺旋、第 11 章"工具定义得好只是第一步"）、清单勾选（第 2/13/14 章）、修订记录（00 导读），关键词检查只会误报，故作为人判断项写入 9.2。核验：scripts/style-lint.py 0 ERROR / 0 WARN；mkdocs build --strict 通过；图 11-1 用 jsdom 单独渲染验证（8 节点 / 8 连线，标签全部完整）；scripts/mermaid-dark-node-check.js 通过（56 图块 / 30 深色填充节点 / 文字非白色 0）。联动更新：第 11 章、AGENTS.md（新增 5.5、9.2 核验清单、11 红线）。