0.1.29 实操后的下一步

2026-10-21。日常教学入口 18067 已升级到 Launcher 0.1.29，CLI 保留 0.1.24。QM 具体列命名与 DISTINCT 排序通过，尚有成员接口和已登记目录重复校验需要处理。证据见复测报告。本文件替代前一轮“先复测 0.1.26”的安排。

1. 先收束两个引擎问题

问题	本轮证据	下一步验收
members 返回对象错误、slot/name mismatch、信封不一致	已提交 #148；新进程仍能复现，艺术家请求返回曲目或 500	对 Artist 原表核对实际 ID/名称；模型字段与成员参数保持一致；CLI 成功退出、信封正确；不能把 275 位全目录与 119 位当年成交成员混为一谈
已登记目录再次 models validate 报重复资源	已提交 #149，关联 #106；首次登记前 6/6 通过，登记后 3 个 QM 失败，重启和 clear-existing 仍失败	同 Namespace、同路径重复校验成功，再完成修改、校验、刷新和查询，失败不能污染现有模型

问题记录不混入已修复的 #145/#146。按用户授权已提交两项 issue，并在 #106 下补充回归关联，未重开旧 issue；两份正文与评论均已回读核对。

将具体 ID/caption 项的 name 与 alias 设为同值，使用 albumId、albumName、albumArtistId、albumArtistName；读者先掌握查询名与返回键的关系，不展开整维度前缀写法。
候选别名稿的 11 个示例已在新 Namespace 首次登记场景通过。待正常模型更新流程通过后，再同步正式 QM、实时 Markdown 示例、正文、payload 与实操记录；不把新 Namespace 验证包装成原 Namespace 更新成功。
成交成员继续使用已验证的分组/DISTINCT 查询；专用成员接口修好后，只补简短用法，明确目录与成交范围区别。
交用户审阅，保持短提示词、创建与查询分开、章末知识点回顾。

主线仍是“同一句问数，不同身份为什么得到不同结果”。用 Chinook 单独建立本地权限演示 QM：先验证模型能否发现与执行，再验证字段可见范围，最后比较 USA/Canada 两个数据范围。

每一层都核对元数据、校验和执行；成员接口通过后，再验其与主查询的范围一致性。只做本地可重复的身份例子，不引入 TMS、不建设生产登录或角色后台，不把匿名开发模式当成权限验收。

第十四章讲“修改模型后，旧问题还能不能答对”：校验、刷新、实时元数据和小题库回归。已有重复校验问题必须先解决，避免教材依赖临时绕行。

之后介绍内嵌 Analytics Console，再接 FAP。0.1.29 的 JAR 已内置 Console，不再规划独立前端安装；本轮只验证默认关闭、显式启用和 Analytics 能力接口，浏览器连续问数、FAP 配置与权限尚未验收，留到相应章节边搭建边写。

CTE、多维分析、异构数据源、语义 SQL 及性能优化仍放高级篇，Text-to-SQL 多次生成对比继续暂缓。本轮只更新环境、探查和规划，不开始第十三章。