2026-10-25 第一阶段收尾：第1—40章已成稿，待用户审阅发表。第37—40章完成实测与连续阅读复审。统一交付稿见交付入口，Console/FAP、FDP及Dashboard阶段按产品安排后续推进。
更新日期：2026 年 10 月 25 日。教学环境现为 Launcher 0.1.42 / CLI 0.1.25，第26—28章实操及旧题代表回归通过，见升级记录。文件系列第29—34章已整体复审，用户按现稿暂定。语义SQL与查询入口第35—36章已实操、自审，第36章待用户审阅。时间系列第17—21章按现稿暂定；高级建模第22—25章原实操与复审保留。
第35章：用SQL表达语义查询已按AI转换路线完成4项查询、1项字段拒绝，见入口核对、实操和读者自审。当前核对的0.1.42公开入口未发现原生语义SQL解析器，SQL由当前Codex转为DSL后交给引擎；没有将其称为确定性编译。
第35章整体复审已补清CLI提交、Foggy编译和数据库计算的职责；第36章：SQL转成DSL后，怎样核对查询含义已完成7项正常查询、1项教学错例执行及1项校验拒绝，见实操与读者自审。暂不进入下一系列实操。
全书围绕一个目标：建立让 AI 能够正确、如实回答用户问数问题的语义层。具体约定见逐章写作方案。
2026-10-25 文件系列进度：第29章的能力核对、13项最小实验和重启2项补验保留；第30—34章按后续授权一次完成，见整批实操与读者复审。跨源校验问题单独记录，后续系列尚未开写。
| 文件系列 | 本轮状态 |
|---|---|
| 29 从一份 Excel 开始问数 | 已实操、自审，使用普通持久 TM/QM；原生临时入口不作已发布承诺 |
| 30 不规范的 Excel 怎么整理 | 4项查询；83条确认、3条待确认，整理与追溯已核对 |
| 31 多份文件如何合并与更新 | 7项查询；重复、追加、更正与拒绝边界通过 |
| 32 遗留数据库如何建立语义层 | 3项查询及错误字段拒绝；viewSql 映射、分转元与固定范围通过 |
| 33 系统实际与 Excel 目标一起分析 | 6项查询及重复目标拒绝；零分母、匹配范围和同库准备已核对 |
| 34 让文件分析持续复跑 | 两轮成功流程各8项执行；输入失败与切换后恢复通过，用户按现稿暂定 |
连续阅读入口：技术篇合订审阅稿，包含第 1 至 5 章。前五章已整体自审，现按用户要求暂定。第六章合并范围、引擎介绍与环境接入，后续章号顺移。
| 章节 | 正文 | 当前状态 |
|---|---|---|
| 第 1 章 从自然语言到 SQL | 正文 | 2026-10-15 用户审阅通过 |
| 第 2 章 SQL 能执行结果为什么仍可能不对 | 正文 | 已整体自审，按用户要求暂定 |
| 第 3 章 语义层的作用与代价 | 正文 | 已整体自审，按用户要求暂定 |
| 第 4 章 自然语言到 DSL 再到 SQL | 正文 | 已整体自审，按用户要求暂定 |
| 第 5 章 怎样选择和组织问数方案 | 正文 | 已整体自审，按用户要求暂定 |
本轮前五章整体自审记录说明章节分工、精简内容和核对范围。
实战篇按已确认的专项大纲，统一使用 Chinook，固定 Codex 桌面端与 PowerShell。原范围导读保留为写作素材。第六章初稿已完成，配套环境与复跑说明保存实际步骤与结果。
| 章节 | 当前状态 |
|---|---|
| 第 6 章 认识 Foggy，准备第一个问数项目 | 第六章初稿按用户要求暂定；环境、绑定、11 张表发现及重启恢复通过 |
| 第 7 章 让 AI 探查 Chinook 并确认业务口径 | 第七章初稿按用户要求暂定；五张表探查、10 份只读查询与 Decimal 独立复核通过 |
| 第 8 章 让 AI 生成语义模型并完成首次问数 | 第八章初稿按当前稿进入后续写作；4 个模型文件、12 个查询用例与独立核对通过，1 个错误字段校验按预期拒绝 |
| 第 9 章 让 AI 正确筛选数据：slice 与 having | 第九章初稿按当前稿进入后续写作；原 8 项查询通过，本轮另补文字/排除/空值并自审待阅；SQL 对照已撤出正文，多次生成正确性评测暂不执行 |
| 第 10 章 聚合与计算指标：数清楚，再算平均和占比 | 第十章经 2026-10-20 复审进入后续写作；临时计算与 QM 固定指标分步讲解，原 11 项查询通过，本轮另补条件聚合并自审待阅 |
| 第 11 章 按日期与月份汇总数据 | 第十一章本轮已收紧并自审；日期建模与月度汇总保留，比较与 LAG 素材迁出；原 0.1.25 实操证据不变 |
| 第 12 章 从艺术家查到专辑：维度成员与多级关联 | 第十二章已获用户确认；0.1.30 / CLI 0.1.25 成员接口与 name/alias、11 项查询核对通过，去重与合计范围已补 |
| 第 13 章 让 AI 只查询用户可见的数据 | 第十三章初稿已完成独立权限示例与自审；11 项查询执行、5 项预期校验拒绝，模型/字段/行及成员边界核对，已获用户确认 |
| 第 14 章 在 QM 中关联多个 TM：普通 JOIN 与聚合 JOIN | 第十四章已获用户确认；重做为单 QM 建模 JOIN，10 项普通查询核对、字段/模型两项预期拒绝与 3 项旧查询回归 |
| 第 15 章 用字典连接业务名称与数据取值 | 第十五章已实操、自审待阅；24 国映射、7 项查询及旧题回归通过 |
| 第 16 章 模型维护与自动化回归 | 第十六章已按当前模型复验、自审待阅；字典纳入题库，校验刷新前后各 12 项查询一致、1 项字段拒绝；未修改源码与数据，2 项回答审阅未执行 |
高级篇已开始：第 17 章 时间分析：比较、累计与滚动窗口。已按 0.1.38 整体复审，完整 JSON 与主要窗口变体复跑通过；calendar/observed 口径明确，旧版完整初验记录保留。见自审、实操记录。
第 18 章 业务日期、日历与可比期间已按 0.1.38 整体复审，用户按现稿暂定：日期选择、日历补齐、完整性与同期/工作日比较，JSON/Markdown 的角色和用途一致；原始完整初验记录保留。见读者自审、实操记录。
后续功能次序见功能章节规划。Console/FAP、浏览器问数与高级篇顺延，原高级草稿文件暂保留旧编号，整体章号待后续统一。
高级篇时间系列第 17—21 章现已形成整批实操待审稿；按用户要求先完成和排查，再统一审阅。其余系列暂不定号，WWI 按数据条件逐步引入，见时间系列大纲与高级篇框架。
| 新稿 | 内容与当前结果 |
|---|---|
| 第十九章：存量与快照 | 0.1.38 回归通过；快照与目录 QM 分工明确，期末、未知历史、流水与日均已核对 |
| 第二十章：业务耗时 | 0.1.38 回归通过；日期差、完整单位与小数耗时分开，补显式 NULL，截止和超时口径不变 |
| 第二十一章：同期群 | 样本内首购、去重、复购和观察窗口；发行包及教学端口代表回归通过 |
时间系列在 0.1.38 的 40 次 CLI 查询执行、2 次 HTTP 执行与 3 项预期拒绝保留为完整历史验收。当轮升级与验证 · 当轮整体复审。当前入口已升级 0.1.42，包含时间系列代表题回归；不将历史计数与本轮计数混用。
第 17、19、21 章已加入滚动窗口时间轴、库存阶梯图与同期群热力图，数据沿用当前验收结果，并精简图文重复；见配图后复审。
2026-10-23：高级建模与多维分析第 22—25 章已按用户要求整批处理并自审，待审阅。创建与查询分开，提示词保持一两句。
| 章节 | 当前状态 |
|---|---|
| 第 22 章：父子维 | 初验保留；0.1.39 补上向上查、maxDepth 与上级链图，12 项范围/层数查询通过 |
| 第 23 章：层级汇总与下钻 | 层级汇总与下钻已核对；加入柱图点选演示和静态分步图，人员 → 客户 → 账单的全部路径及金额通过检查 |
| 第 24 章：Pivot 交叉分析 | 0.1.39 结果独立核对通过；补三图与展开/TopN 点击演示，已做配图后读者复审，待用户审阅 |
| 第 25 章：父级占比与基准 | 父级占比、筛选/分页分母、首末基准与边界核对通过；补分母对照图并完成读者复审，待审阅 |
第二十四章配图后复审已完成；下一步计划先收尾第二十五章，再验证并细化分阶段与组合分析系列，暂不进入新章实操。
本轮已完成第二十五章分母配图与复审，并按授权完成 Compose 当前版本最小实测：7 项执行、1 项预期拒绝通过，旧 #150/#151 复现未再出现。实操证据 · 第 26—28 章大纲。
| 分阶段与组合分析 | 当前状态 |
|---|---|
| 第 26 章：Compose 与 CTE 入门 | 5 项执行、1 项预期拒绝通过；本轮再次压缩概念与提示词，复审后按用户要求继续 |
| 第 27 章：先汇总，再关联 | 10 项执行独立核对通过；金额差异、双向未匹配与期间错配边界已核对，已自审待阅 |
| 第 28 章：先圈选对象，再继续分析 | 0.1.42 下 10 项执行独立核对通过；阶段 TopN、跨期间、截断与未匹配边界已自审，待用户审阅 |
第二十六章实操 · 读者复审。第二十七章实操 · 自审 · 派生接口修复复测。第二十八章实操 · 读者复审。第 26、27 章已在升级后的实际教学端口复跑，本轮停在第二十八章供用户审阅。
2026-10-24：#162 在 0.1.39 原请求复测通过。17 项 Pivot/边界 CLI 执行、1 项 HTTP 执行、8 项预期拒绝，另 18 项旧题代表回归通过。当前实操 · 修复后复审。
语义 SQL 与统一计划保留为高级草稿，文件名中的 18/19 仅为历史编号，正式章号暂不确定：
| 章节 | 正文 | 当前状态 |
|---|---|---|
| 高级专题：语义 SQL 与虚拟业务表 | 正文 | 迁移保留草稿 |
| 高级专题：SQL 与 DSL 怎样进入统一执行计划 | 正文 | 迁移保留草稿 |
高级专题草稿合订只包含这两章，不代表高级篇已经完成。原平台比较稿保留为选读参考，产品资料核对日期为 2026-10-15。
前两章使用自编虚构的小销售库，区别于实战篇的 Chinook 与高级篇的 WWI 开放数据。样例说明提供复跑方法及验证范围。当前章节安排见总大纲。
自审记录：第 1 章、第 2 章、第 3 章、第 4 章、第 5 章、原范围导读。迁移记录另见第 18 章、第 19 章和平台路线参考，历史记录中的原章号按迁移说明对应。
第六章本次实战自审见读者视角记录；上面的“原范围导读”记录保留历史语境。
第七章：读者自审、第七章探查与复跑记录。本章未创建语义模型，物理数据基线与后续语义查询验收分开记录。
第八章：读者自审、建模与查询记录。当前 Codex 会话真实调用 CLI，不等同于另开干净会话仅凭正文提示词的独立验收；Console/FAP 尚未接入。
第九章：读者自审、筛选条件实操记录。本章只查询已有模型，未修改数据或建模文件。
第十章：读者自审、聚合与计算实操记录。恢复教学服务后，在账单 QM 新增固定均额并验证，未执行用户暂缓的两路线多次生成正确性评测。
第十一章：读者自审、0.1.25 实操记录。2026-10-20 用户确认进入下一章；初轮记录保留历史范围。
第十二章：读者自审、0.1.30 实操记录。#148/#149 均通过，正式 QM、正文和 payload 已统一新 name/alias；原 Namespace 更新及 11 项查询通过，已获用户确认。
本轮结构调整：第十一章与基础/高级篇衔接复审。
第十四章：读者自审、新实操记录。仅新增两个 QM，复用原账单/明细 TM；旧 Compose 素材与证据已归高级篇，#150/#151 保留。
第十六章：读者自审、当前模型复验。字典已纳入题库，当前基线与校验刷新后结果一致；原说明修改记录按历史阶段保留。
本轮第九、十、十二章补充与第十五章字典实操见补充记录及整体自审。
2026-10-22：第十七章三个问题在 Launcher 0.1.35 的 24 项执行与 2 项预期拒绝中已复测通过，教学服务已升级；正文已按显式 calendar 等新合同更新，待用户审阅。见0.1.35 复测记录。