第十二章读者视角自审

日期：2026-10-20。状态：实操、自审完成，待用户审阅。正文：从艺术家查到专辑。

主线与措辞

接第十一章的“按时间分析”，改为“按业务对象逐层分析”；沿用第八章明细模型，不重复讲接入、基础建模、金额单位或完整元数据流程。
先扩展模型，再发现成员、排名分页、查专辑和曲目；六条短提示词只描述任务。创建与查询分开，不要求读者事先知道艺术家、专辑名称或 ID。
源码从 TM 顶层 dimensions 展开 track → album → artist，注明已有 invoice、genre 和其他配置省略，album 与 genre 并列；说明每层 foreignKey 来自直接上一级表。QM 展示实际公开方式，完整文件链接与节选配合，不重复整份明细 TM。本次仅扩展正文示意，实际模型与查询未变。
实时元数据与源码路径分开说明：当前 QM 的艺术家短名与完整路径名均经选择、分组、排序、筛选验证，正文统一使用实时元数据返回名；不把短名概括成 QM 默认去掉父路径的规则。Markdown 由引擎根据加载代码实时生成，只保留快照作证据。
别名按用户要求在 QM 的具体引用项上展示配置位置，已撤出先前误解为 TM 维度 alias 的方案。#146 在 0.1.29 的最小原始请求通过，候选别名稿的 11 项查询也通过；正文区分查询 name、输出 alias 与整维度引用。主线暂保留原名称，待已登记目录重复校验问题处理后同步正式 QM，不把首次隔离登记当作同 Namespace 更新通过。
解释成员是具体业务对象，用 ID 区分，用名称展示；2012 年成交成员不是完整目录。专用 members 接口未通过验证，正文明确说明，不把替代查询当作修复。
主线排名只贴一个完整 DSL；专辑下钻仅展示新增筛选，曲目沿用同一机制。2012 年期间、金额指标与上层 ID 持续保留。
“看下一页”后不再用“第一位”指代当前页首项，改为“排名第一的艺术家”，明确指 Iron Maiden，而非第二页 Lost。Powerslave 来自实际专辑排名，没有预置在读者提示词中。
页内条数、总组数、全范围金额分别说明；没有把本页金额当全年。Chinook 包含影视内容，解释 The Office 为何出现在榜单。
完整艺术家、专辑、曲目金额核对集中在章末；四个知识点仅总结已验证内容，不展开层级树、CTE、权限或在线接入。

实操与边界

公开 CLI 检查四张表结构，修改明细 TM/QM，六文件校验通过，刷新并实时 describe。11 项语义查询经逐条校验、执行，与原始只读表行、Python 主键映射及 Decimal 独立核算一致，涵盖成员分组、完整排名、三页检查、两层下钻、原汇总与分类回归、空期间。

成员专用接口的七次探查均未通过，含返回错误对象和服务端 slot/name mismatch；DISTINCT 请求的成员集合正确，但未按请求排序，另存诊断，不计为已验证成员接口或排序能力。正文采用已通过的分组成员查询。

数据库及另外四模型文件未变。第八章原明细源码保存快照，链接指向相同版本。没有改产品源码、重启服务、发布在线环境、另开干净 Codex 会话或执行暂缓的 SQL 正确性对比。后续按用户要求，DISTINCT 排序异常已提交 #145，专用成员接口异常尚未另行提交。

未验证异常缺失关联、并发跨页、全目录、生产权限与 Console/FAP。章节源码、DSL、表格数字与证据已对照；当前交付待用户审阅，第十三章未开始。详见实操记录。

字段命名补充验证：短名/完整路径四项等价请求已通过。此前 TM 维度别名试验仍保留历史证据，但不是用户要求的 QM 方案。随后用独立模型名和临时 Bundle 实测 QM 整维度 alias、ID/caption 分别 alias、同时配置 name/alias 三种方式；四文件模型校验通过，实时元数据仍未公开期望别名，三个查询在校验阶段返回 FIELD_NOT_FOUND，均未执行。临时 Bundle 已移除，原六个模型及数据哈希未变。失败与可用主线分开记录，不把新版本是否支持预填为通过。

0.1.26 复测补充：原三方案及最小复现均失败；每个同 QM 原字段对照均正确返回 34 条、33.66。已核对实际运行 JAR 和哈希，测试实例收尾停止，教学环境未切版。正文只更新别名限制及 issue 链接，后面的选择、分组、筛选与排序仍统一使用实时元数据字段，未增加读者提示词。见复测记录。

2026-10-21 更新：上述 0.1.26 结论保留历史语境。教学入口已升级 0.1.29，#145/#146 通过，members 仍失败，已登记目录重复校验疑似 #106 回归。正文只更新当前命名合同与实测状态，未进入第十三章，详见本轮复测报告。