第八章读者视角自审记录

日期：2026-10-18。正文：让 AI 生成语义模型并完成首次问数。状态：已自审，待用户审阅。

主线与衔接

• 第六章接通数据，第七章检查含义与统计方法，本章将定义写成可执行 TM/QM，再核对实际查询结果。没有重复安装、表关系图和语义层价值论述。
• 四个简单提示词分步推进：创建账单模型 → 查询客户排名 → 创建明细模型 → 查询分类金额。每次建模后先确认加载与公开字段，再发查询任务。2012 年来自上一章已探查并选定的练习期间；表名、字段名、文件名和命令顺序作为处理结果讲解，不要求读者先提供。
• 明确沿用同一练习目录和会话；更换会话时需提供上一章保存的资料，不假定新会话知道历史业务定义。
• 第四章已经解释 DSL，本章仅展示真实请求及结果；按用户要求加入四个已验证 TM/QM 文件的完整源码，用折叠块保留阅读主线，并链接实际源文件；说明 TM 字段定义与 QM 引用、公开字段之间的对应，不展开配置手册。
• 将 Bundle 就地解释为模型资源包；TM/QM 不只叫“模型”，避免与 LLM 混淆。客户姓名字段中的 $ 是公开名称，不代表物理库新增列；实际字段必须来自 describe。
• 先客户排名，再添加明细、对账，最后验证错误字段和交接。分类全表与额外总计响应保留在配套记录，正文只列必要结果。

事实与验证边界

• 当前 Codex 会话实际执行公共 CLI，4 个 TM/QM 文件校验通过，完成 Bundle 登记、刷新、describe、请求校验与执行。没有用生成文件成功代替运行结果。
• 独立读取原始 SQLite 行，用字典关联与 Decimal 核算 Top 5、四个期间的账单和明细统计、22 个有交易分类及账单 252 的字段。字段、姓名、金额、数量和顺序一致。
• Top 5 有两位 24.75 的客户，按客户 ID 升序稳定排序；Top 5 合计不等于全体客户金额。正文不推断币种、不把账单金额写成利润，不虚构退款或状态条件。
• 区分目录分类 25 个与 2012 年有交易分类 22 个，不将未返回的三个解释成不存在。部分 SQLite SUM 有浮点尾数，按两位小数核对，不称其为全链路定点精确计算。
• 主动构造 clientName 只用于验证拒绝路径，错误请求没有执行；修正后校验并执行成功。不编造“LLM 恰好写错”故事。
• 首次配置失败、实际字段差异、已登记目录重复资源、嵌套别名和满页提示均留在配套记录；修正发生在教学文件和教学 Bundle，没有修改引擎源码、数据或其他环境。
• 实际验证不包含另开干净 Codex 会话仅发送简短提示词；没有独立自然语言端到端通过结论，也没有重启恢复、生产权限或浏览器/FAP 通过结论。后续题库与在线入口单独验收。

正文已整体重读，提示词各一段；叙述顺序为“任务 → 文件与加载 → 查询及结果 → 扩展明细 → 错误修正 → 核对交接”。配套证据见实操记录与验收摘要。

补充复审：四个完整源码块各对应一个实际文件，账单 TM 没有重复定义；解释了 QM 中同名 loadTableModel 引用。两个 QM 均实际执行 Markdown 导出，以引擎输出节选替换手写字段表，并保留完整导出文件。说明当前 INTEGER 字段的 Markdown 展示标签差异，实际类型以结构化输出为准。未修改模型或提示词。

加入源码与 Markdown 后的整体复审（2026-10-19）

• 明确 Markdown 由引擎依据当前已加载的 TM/QM 代码自动生成，AI 需要时通过 CLI 实时获取，不要求读者预先生成、保存或维护 Markdown 文件。模型变更先校验、刷新，再读取说明，避免将“实时获取”误解为未加载的源码也会自动生效。
• 将“导出文件”改为“完整返回记录”，说明正文保存的是一次调用结果，供阅读对照；实时获取说明是查询流程的一部分，不增加读者准备步骤。
• 四份源码和两份引擎原文节选继续折叠展示，内容不改写。正文只解释字段映射、QM 引用、实时查询说明与 DSL 请求的关系，删除重复的字段用途、分类核对和小结表述。
• 此前先将两段提示词中的“建立分析”明确为创建语义层模型，澄清上一章仅完成探查、尚未建模的起点；随后按用户要求进一步拆成独立建模与查询任务，见下文。
• 本轮仅编辑文字，核对源码、Markdown 节选与已保存文件的一致性，没有重新执行查询或新增运行通过结论。仍待用户审阅，不进入第九章。

建模与查询拆步（2026-10-19）

正文拆成四步，每步一个简短任务：先创建、校验并加载账单模型，确认公开字段，再查客户排名；随后创建、校验并加载明细模型，确认日期与分类字段，再做分类汇总。查询提示词不再同时要求创建模型，建模提示词也不夹带统计问题。

分类对账明确比较同期全部账单金额，避免误解为与前五位客户的金额比较。Markdown 仍按需实时获取，源码及引擎返回节选不改，本次调整不新增实操或独立提示词验收结论。

四步流程整体复审（2026-10-19）

• 第一步止于模型校验、加载和字段确认，将残留的“再构造请求”改为供下一步使用；第二步单独提问并指定账单 QM。第三、四步同样分开，明细模型复用第一步加载流程，不重复解释。
• 两段 DSL 各自对应查询任务与实际结果。第四步补上已保存响应中的前三个分类，区分节选结果与全部 22 类合计；删去第七章已经展示的月度对账表，保持“任务 → DSL → 返回数据 → 独立核对”的衔接。
• 区分查询模型的基础记录与聚合后的返回行，表头改为“基础记录”，避免以为分组查询仍每行是一条明细。
• 四段提示词保持不变；源码、Markdown 原文及 DSL 与验证文件核对一致。正文再次明确 Markdown 自动生成、实时获取，无须提前准备；未增加提示词步骤。
• 本轮仅调整正文和审阅记录，没有修改模型、数据或重新执行查询。仍待用户审阅，不推进第九章。