从第九章起按 Foggy 功能点展开

2026-10-21 更新。以下是当前顺序；后面的日期段落仅保留历史计划，不作为现行章号和进度。最新安排见基础篇收尾计划。

先完成基础功能；Console/FAP 与在线交接另行编排。高级篇集中讲时间比较、累计、滚动和 LAG，保留 CTE、多维、跨源、语义 SQL 与性能主题，正式章号稍后确定。基础篇讲单 QM 中多 TM JOIN；Compose/CTE 动态组合仍为高级专题。

每章保持“业务问题 → 模型准备（需要时）→ AI 与 CLI 查询 → 结果 → 独立核对”，创建与查询分开，提示词简单，完整命令与证据放 lab。未实操的能力不预填通过。

历史安排（不作为现行顺序）

当前下一步（2026-10-20，#145 修复发布后）

最新补充：按用户要求已安装官方 0.1.26 到独立实例，专门复测 QM alias；模型校验通过但新名称未进入元数据/查询解析，已提交 #146。第十二章后续示例暂保留原可用名称，待修复再验证切换。本次未重跑 #145 或成员接口验收，日常教学入口仍为 0.1.25。见复测记录；下文“未安装”等表述为前一轮规划时的状态。

已核对 #145 修复与发布说明：修复提交 8c8e461b73224d8faddbc7573e550cb549901f05，已发布 Launcher 0.1.26。该 GitHub Release 标记为 prerelease；这里仅记录其包含本次修复，不等同于已通过教材现场验收。本轮只更新规划，未下载、安装、重启或执行新版本查询。

1. 先完成修复复测与第十二章收尾

• 按发行 README 与原启动脚本准备 0.1.26，校验资产、实际 JAR 和能力；CLI 暂沿用 0.1.24，除非发行要求变更。
• 原样复跑 #145 的 DISTINCT 请求，核对 119 位艺术家的完整升序、降序、分页与 total，并确认最终 SQL 落实 ORDER BY。使用既有原始数据基线，不能只看 success 或 normalized DSL。
• 选取第九至十二章中受排序规划影响的代表请求做有限回归，覆盖筛选、固定均额、时间比较、关联排名与下钻；不因升级重跑所有历史探查或启动 Text-to-SQL 多次生成对比。
• 单独复查成员接口的错误对象、slot/name mismatch 和成功信封。#145 不包含该问题；仍异常则保留独立诊断，第十二章继续用已验证的分组方式发现成交成员。
• 复测通过后统一后续教学入口版本，更新第十二章记录、自审和必要正文。DISTINCT 可作为去重成员的简短补充，不再贴一套重复业务流程，也不让正文变成故障排查史。交用户审阅后进入第十三章。

2. 第十三章：让 AI 只查用户可见的数据

主线是“同一句问数，为什么不同用户看到不同结果”。仍使用 Chinook，单独建立受限演示查询模型，保留此前模型作为核对依据；身份只做本地演示，不扩展建设登录、角色后台或生产 IAM。

简单提示词可围绕“建立一个按用户范围查询的演示模型，先不查询”“用两个演示身份分别查询 2012 年销售金额”。身份传递与权限配置在解释和配套文件中讲清，避免堆进业务提示词。模型配置与查询仍分开。实操前先核对目标版本的公开合同，模型、字段、行及成员能力逐项验证，不预填通过结论。

3. 第十四章：修改模型后，怎样确认旧问题还能答对

沿用已有模型和业务问题，围绕“调整字段说明或指标定义 → 校验 → 刷新 → 实时元数据 → 题库回归”展开。保留少量能发现口径变化、无效字段、空结果和范围错误的问题，不重复第十章的公式入门，也不扩展成自动化平台建设。

4. 基础篇收尾后接在线问数

接入 Analytics Console，再讲 FAP 的在线问数入口。复用已验收模型与问题，检查从终端到浏览器后，字段、统计范围、权限和结果是否保持一致。CTE、多维分析、异构数据源与语义 SQL 继续留在高级篇。

第十一章已获用户确认；第十二章初稿已完成实操与自审，待用户审阅。当前 Codex 会话真实调用 CLI 与另开干净会话仅凭短提示词的独立验收分别记录，后者未执行。每章末尾增加简短 Foggy 知识点回顾。

下一步安排（2026-10-20，0.1.25 复测后）

第十一章复测时 #139–#142 的 SQLite/Chinook 用例已通过。随后第十二章发现成员接口与 DISTINCT 排序异常；后者 #145 已随 0.1.26 发布，教材现场待复测，成员接口问题独立保留，见诊断记录。本章已有分组查询可完成成交成员发现。

先收尾第十一章

2026-10-20 执行结果：以下四项已完成，用户确认进入第十二章。 原 18067 教学入口升级到 Launcher 0.1.25，CLI 保留 0.1.24；十项查询独立核对通过，一项错误写法按预期在校验阶段拒绝。以下保留当时执行范围。

1. 统一后续实操版本。 Launcher 0.1.25 为后续基线，CLI 沿用 0.1.24。18067 已在原工作目录完成升级，能力、绑定、模型与实际 JAR/监听进程核对通过；独立 18068 测试实例仍停止。
2. 更新正文。 保留“先准备语义层模型，再查询”的步骤，用已验证的 timeWindow 讲月度环比和跨年比较；同比作为同一机制的简短扩展。LAG 说明“上一结果行”和“上一自然月”的区别，保留一个精简示例，不展开全部窗口函数。
3. 调整证据定位。 引擎负责返回本期、上期、差额与比例；Python Decimal 留作独立核对。旧版失败和工具外算路径移入配套记录，正文不继续把它们当作当前限制。
4. 收束边界与自审。 讲清当前期范围、上期读取、首期无数据和空值；保留校验诊断的简短例子。同步实操记录、知识点与版本说明，通读后交用户审阅，通过再继续第十二章。

0.1.25 的原 17 组结果可直接作为已验证依据，不因文字改写重复全量执行；环境入口、模型或 payload 有变化时再运行受影响用例。

第十二章：维度成员与多级关联

2026-10-20 执行结果：正文、自审和实操记录已完成，待用户审阅。 11 项语义查询通过独立核对，验证 119 位成交艺术家、477.53 总额、艺术家→专辑→曲目与首/次/末页。仅扩展明细 TM/QM；专用成员接口未通过，采用 QM 分组发现当年成交成员，不将其称为完整目录。详见本章实操记录。下表为原规划及验收范围。

在现有明细分析上扩展 InvoiceLine → Track → Album → Artist。先检查真实表关系和公开字段，再确定最终语义字段名，不预先猜测嵌套路径。

提示词仍以业务任务为主，例如“给明细分析增加专辑和艺术家，校验并加载”“2012 年哪些艺术家的销售金额最高”“看看第一位艺术家的各张专辑”。成员发现、字段选择和查询构造由 AI 按 Skill/CLI 完成；创建与查询分开。具体接口或边界以实测为准；样例没有覆盖的缺失关联不标为已验收。

后续基础功能

• 第十三章：查询范围与权限。 用独立本地身份样例，验证模型、字段、行和成员范围；不触碰 TMS 权限配置，也不把开发匿名模式当作生产权限已验收。
• 第十四章：模型维护与回归。 修改业务定义、校验刷新、实时元数据、诊断与题集核对；结合实际需要补汇总行等结果功能，支持情况先验证后写。
• 基础篇收尾后，再进入 Console/FAP 在线问数与交接。CTE、多维透视、异构数据源、语义 SQL、性能优化仍放高级篇，暂缓的 Text-to-SQL 重复生成对比不在本轮启动。

当前第十二章已完成实操与自审，待用户审阅；第十三章及之后尚未实操。