技术篇前五章读者视角整体自审

审阅日期：2026 年 10 月 17 日。范围：技术篇合订稿。第一章此前已通过，本轮正文未改；第二至第五章调整稿待用户审阅。

主线与章节分工

第一章展示 Text-to-SQL 怎样执行；第二章用重复累计解释查询为什么会错；第三章讲可执行的业务定义与语义层代价；第四章展开 DSL 查询和错误修正；第五章集中讨论适用场景与系统组合。各章沿用客户与发票，衔接无需新增章节。

本轮调整

• 第二章删去与第五章重复的用户选择，改为独立复核结果；只读与数据范围的区别并入权限段。保留复杂 SQL 的成本与命名幽默。
• 第三章补清客户关联到公开字段 customerId、customerName 的对应；字段绑定改为引擎绑定请求字段，避免让读者误以为引擎负责理解自然语言。统一使用“语义模型”。
• 第四章说明 SUM 只适合本例可加总金额，平均值、比例应遵循语义定义；明确简化协议只示范聚合前筛选，不暗示已有聚合后筛选写法。
• 第五章删去与第三章及本章链路检查重复的证据提醒，保留问题、查询、范围和追问的检查方法；Agent 作为可选的多步编排方式。

基本构成、粒度、指标聚合、字段值与时间、权限执行、协议适配和如实回答已有交代。按入门技术篇目标，未发现需要另加章节的关键缺口。具体建模操作、环境接入以及语义 SQL、CTE、多维分析继续留给后续篇章。

核对范围

• 第一章与调整前合订稿一致；五章的代码、YAML、元数据示例和图示代码块均未变。
• 第四章 JSON 与物理 SQL 与已有样例文件一致；教学示意仍与真实语义引擎执行区分。
• 合订稿按正文同步，检查章节顺序、代码围栏和本地链接。
• 本轮为文字与结构复审，未重复执行查询、建立环境或推进实战；未引入具体语义层产品。

实战篇合并后的对应关系（2026-10-17）

原第六、七章合并为现第六章《认识 Foggy，准备第一个问数项目》；原第八至二十二章顺移为第七至二十一章。语义 SQL 与统一执行计划现为第十八、十九章。上文保留当时的审阅记录，现行结构以总大纲 v7 为准；未开展环境搭建。