第 5 章读者视角自审记录

自审日期：2026 年 10 月 17 日。正文：怎样选择和组织问数方案。已自审，待用户审阅。

• 承接第四章的一次查询，扩展到完整系统的组合方式；不再复述语义模型定义、DSL 语法和 SQL 编译步骤。
• 用三种组合说明已有分析系统、独立语义服务和数据平台中的语义能力；它们可以组合，不是产品排名或互斥分类。
• 区分调用接口与实际执行能力，避免把接通 CLI、API 或工具协议写成业务规则已经生效。
• 首次出现 Agent 时解释含义，用客户销售变化说明多步分析、结果核对与证据范围。
• 写清语义模型，不与 LLM 混称“模型”；不引入具体厂商、TM/QM 或私有字段。
• 原始业务表需要补语义定义的表述限定在“提供语义查询”场景，不否定直接 Text-to-SQL 的适用性。
• 结尾把用户、问题和验收范围交给第六章，不让入门读者先选择 DSL 或语义 SQL。

本章为通用概念讲解，没有新增可执行命令或产品能力承诺。核对了与第四章结尾、第六章开篇的衔接。迁移后的样例另做 SQLite 等价性检查，不能作为本章系统接入已完成的证明。

技术篇收尾调整（2026-10-17）

第五章仍按用户要求暂定，仅调整结尾，作为技术篇收尾。第六章项目范围归入应用篇导读，后续章号不变，原有实操与高级专题保留。

改题与集中路线选择（2026-10-17）

正文现题：怎样选择和组织问数方案。

• 承接前四章的两条路线，先讲适用场景，再讲业务规则、工具和 Agent 怎样组合。
• 从第四章迁入路线判断与报表类比；增加指标复用和多人稳定问数需求，避免只按是否懂 SQL 划分。
• 保留直接 SQL 与语义层并存的路径，不把语义层写成所有项目的必经步骤，也不说直接 SQL 无法落实规则与权限。
• 删去工具接入段与第三章重复的元数据说明；整条链路的核对不再预设所有方案都使用语义模型。
• 保持产品无关，不比较 DSL 与语义 SQL；技术篇仍在本章结束，项目范围仍属应用篇导读。
• 本次改题与迁入内容已自审，待用户审阅；此前暂定状态属于旧稿。

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

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