返回正文目录

Launcher 0.1.30 / CLI 0.1.25：修复复测与第十二章收尾

2026-10-21。#148 成员接口、#149 同目录重复校验均通过本地发行包复测。 教学入口已升级到 Launcher 0.1.30、CLI 0.1.25，正式明细 QM 与第十二章查询统一使用具体列的 name/alias。第十三章未开始，正文待用户审阅。

环境与发行身份

实操顺序与结果

  1. 按发行脚本启动独立实例，等待就绪，读取 capabilities。登记 SQLite 副本、绑定数据源、检查五张相关表。复制教学六文件，在首次登记前校验 6/6，再登记 Bundle、刷新、describe。
  2. 重放 #149 的同目录原样校验、--clear-existing 和正斜杠规范化路径：均为 6/6，带 BUNDLE_ALREADY_REGISTERED，注册文件未改变。
  3. 重放 #148 的 artist、artist$id、完整点/下划线路径、album$id，另查 track$id：八项均成功，CLI 退出 0，响应包含 success: true 和 Runtime API 版本。
  4. 编辑已登记目录的明细 QM，配置专辑与艺术家具体列的 name/alias。在原 Namespace 校验 6/6、刷新并实时读取 JSON/Markdown，再执行第十二章 11 个查询，结果与原基线一致。编辑后再次普通/clear 校验也通过。
  5. albumArtistId、albumId 的成员查询成功。执行既有 15 项有限回归，以及 DISTINCT 升序、降序、分页、末页和最终 SQL 检查，均通过。
  6. 停止隔离进程，保留相同 WorkDir/registry 后重启（本轮显式 Console profile 与先前报错轮保持一致），重验同目录 clear 校验和旧/新成员名称，均通过。另用新 Namespace 首次校验同一六文件，也为 6/6。
  7. 升级日常教学入口。在原教学 Namespace 再做“原样校验 → 修改正式 QM → 校验 → 刷新 → 实时元数据 → 11 项查询 → 成员查询 → 最终 clear 校验”，全部通过，无须换 Namespace 或删除已有 Bundle。
核对点 实际结果
Artist 目录 total=275，ID=1 为 AC/DC
Album 目录 total=347，返回页 ID/名称与原表一致
Track 目录 total=3503，返回页 ID/名称与原表一致
成员响应 新 Runtime 信封，CLI 退出 0；未再出现 slot/name mismatch
已登记目录校验 原样、编辑后、clear、规范化路径、重启均 6/6
命名与查询 选择、筛选、分组、排序使用新 name；本例 alias 与 name 同值，结果键一致
第十二章数据 当年成交艺术家 119 位，全年金额 477.53、数量 447；Iron Maiden 19 张成交专辑合计 33.66，Powerslave 五首成交曲目合计 4.95

成员接口逐次核对了 total 与实际返回的第一页（本 CLI 默认十条），没有声称遍历了所有成员页。275 位完整目录与 119 位当年成交对象不同；成员目录不代替带日期的成交范围查询。

额外探查把 file:// URI 直接作为 CLI --models-dir 参数时，被 INVALID_REQUEST: Path must be an existing directory. 拒绝。该 CLI 入口需要文件系统目录路径；改用实际目录及规范化路径后通过。此项单独记录，不算 #149 复发，也未绕过参数校验。

正式模型与正文变更

只修改原六模型中的 ChinookInvoiceLineQueryModel.qm，公开 albumId、albumName、albumArtistId、albumArtistName。TM、其余四个模型和数据未变。旧 QM 已保存到本轮证据，原始失败证据不改写。

第十二章只保留一次 QM 配置，后续 DSL 统一使用新查询名称；保留旧字段兼容关系的简短说明，撤出当前失败的过时文案，补充成员目录与当年成交范围的区别。创建与查询仍分开，读者提示词未增加安装或参数细节。

新 payload 保存在 queries/chapter-12-0.1.30，不覆盖旧章原始 payload。引擎实时返回的 QM Markdown 快照只用于留档；读者不需要提前生成或维护。

证据、收尾与边界

证据目录：launcher-0.1.30-retest。

本轮由当前 Codex 会话实际执行 CLI，没有另开干净会话仅凭短提示词验收。未重新执行维护者的跨数据库/全量测试、生产身份权限、浏览器问数或 FAP 发布；未进行暂缓的 Text-to-SQL 多次生成对比，也未新增 GitHub issue/comment。下一步先交用户审阅第十二章，再进入第十三章查询范围与权限。