第十二章读者视角自审

日期：2026-10-21。状态：Launcher 0.1.30 / CLI 0.1.25 实操与自审完成，待用户审阅。正文：从艺术家查到专辑。

• 衔接第十一章的时间分析，围绕艺术家、专辑、曲目逐层查询；沿用第八章明细粒度，不重复接入与金额单位说明。
• 创建与查询分开；提示词仍只表达业务任务，不要求读者预知艺术家、专辑 ID，也不把 CLI 参数塞进提示词。
• TM 从顶层 dimensions 展开 Track → Album → Artist，说明每层 foreignKey 来自直接上一级表。QM 只展示一次具体列的 name/alias 配置，与正式源码一致。
• 简要说明 ref 绑定来源、name 用于查询、alias 决定结果键；本例 name 与 alias 设为同值。后续 JSON、分组、筛选和排序统一使用 albumArtistId、albumArtistName、albumId、albumName；旧名只在兼容说明中出现。
• Markdown 明确由引擎根据当前代码实时生成；不要求预生成，也不贴第二套手写字段说明冒充运行结果。
• 分组发现 2012 年成交的 119 位艺术家；成员接口目录 total=275。说明两者范围不同，不把目录人数当成交人数，也不把默认返回页当全目录数据已经遍历。
• 排名与分页共用一个完整 DSL；后续下钻仅说明新增 ID 条件与分组变化。排名第一明确指完整排名的 Iron Maiden，避免与第二页首项混淆。
• 日期、艺术家 ID 和专辑 ID 沿逐层分析保留；页内条数、分组 total、全年金额分别解释，金额与数量逐层对回。
• 保留 The Office 等样例中的影视内容说明；知识点只总结多级维度、具体列公开、成员、逐层分析与分页，不提前展开权限、CTE 或 FAP。

正式教学 Namespace 已完成原样校验、修改 QM、校验、刷新、实时描述、11 项查询、成员调用及最终校验。数据基线与此前原件只读表行/Python Decimal 核算一致；其余模型和数据保持。详见0.1.30 复测记录。

#148/#149 旧失败说明已从当前教学步骤撤出，原始日志、旧 QM/payload 和旧自审快照均保留在 lab。没有把修复公告当作本地验收，也没有把新 Namespace 首次登记当作原 Namespace 更新通过。

未另开干净 Codex 会话验收短提示词，未遍历成员接口所有页，未验证缺失关联、并发跨页、生产权限或 FAP。第十三章未开始。

本轮文字复审

修正曲目下钻说明中遗漏的旧字段 album$id = 107，统一为 albumId = 107。将成员目录放在成交查询前介绍，先分清目录 275 位与当年成交 119 位，再进入排名和下钻。

ref/name/alias 只解释一次，删除重复的范围说明与“名字来自实际结果”等旁白；短提示词改为“2012 年哪些艺术家有成交”“当年卖了哪些专辑”“第一张专辑的成交曲目”，避免被理解为全部目录。保留“排名第一”与日期/上层 ID 的继承关系。

本轮只修改正文与自审记录，模型、DSL 请求和已有结果未变；对照正式 QM、已验收 payload 与元数据核对字段，未重复执行引擎测试。