第十章读者视角自审

日期：2026-10-19；复审：2026-10-20。状态：按本轮自审进入后续写作。正文：聚合与计算指标。

阅读与衔接

• 接第九章“选哪些记录”，本章讲“这些记录如何汇总计算”。先用既有账单 QM 临时计算，再固化常用指标，最后讲占比的分母，顺序由简单到复用。
• 五个简短提示词依次统计总额与计数、临时均额、固化指标、查询固定指标、国家占比。创建与查询分为两步，前一步成功加载后再查询。日期沿用前文 2012 年，国家始终是账单地址，不要求读者提前知道结果或函数名。
• 每题有实际 DSL 与结果。COUNT_DISTINCT 对客户去重，以 83 张账单、47 位涉及客户、59 位档案客户区分统计对象。
• 临时均额叫 temporaryAverage，固定指标叫 averageAmount，避免请求重定义已公开字段。均额以总金额除张数定义，平均值不能直接跨分组再取平均，以实际 5.84 对照整体 5.75。
• TM 已有金额和 ID，本次只在 QM 加一段公式，展示增量源码和单字段查询，不重复完整模型或元数据。说明修改、校验、加载刷新及实时获取查询说明的顺序；Markdown 由代码自动生成，不需提前维护。
• 固定指标减少 LLM 每次组织计算公式的推理，日期、分组仍由问题决定。没有把这个设计收益写成已经量化的准确率或 Token 提升。
• 占比同时保留分子与指标别名，比例转百分数只用于展示。先筛国家会改分母，单纯 limit 截取前三则保留全年分母，两种均已实际执行。
• 完整国家表、额外聚合、边界结果及本版校验已注册模型目录的处理放到 lab，不塞进读者提示词。第八章账单 QM 链接改指该章快照，源码与当时元数据保持一致。

验证与边界

首次发现服务未运行后，按原发行脚本启动自己的教学服务，原绑定和账单模型恢复。随后增加 QM 固定指标，四个模型文件校验通过，刷新并 describe 确认可用，再完整复跑 11 个请求。原始行和 Decimal 独立核对通过；固定与临时均额的全年、20 个国家分组及空期间结果一致。Top 3 明确是部分结果，其余结果无分页遗漏。

空期间返回账单数 0，而金额与均额字段缺失；正文保留实际返回行为，解释为无定义，不虚构 averageAmount: 0 或本版本没有返回的显式 null。平均金额的空值处理已验证，不推广为所有零总额占比情形都已验证。

部分原始数值带浮点尾数，均额/占比按 1E-12 误差核对，展示金额和百分数时才舍入。文中 5.75、26.80%、75.04% 等均来自实际结果与独立基线。

当前 Codex 会话实际修改模型、生成请求并调用公开 CLI，但未另开干净会话仅凭正文提示词做独立问答验收；用户暂缓的 SQL 与语义层多次生成正确性比较也没有执行。模型仅账单 QM 增加公式，数据、Console/FAP 和生产权限状态不变。

2026-10-20 再次从读者角度复审：用“一次性需求 → 常用指标”承接临时计算与固化指标；减少推导、降低出错概率的解释保留在查询结果后，删掉前后重复铺垫和结尾重述。固化提示词不再要求读者指定内部字段名，创建与查询仍分开。修正首段 JSON 中多余的 -，四段 DSL 与已执行 payload 重新逐项比对。章末保留 Foggy 知识点总结。模型与请求未变，无须重复执行原 11 个查询。

保留四段 DSL、一段 QM 增量源码，按用户“没问题后进入下一章”的要求继续时间分析。配套记录见实操说明。