报告前面加一段模型写的解读（issue #113 R1）

引擎在同一份 packet 上给出与对话同源卡相同的事实（include_reading_facts），
报告任务交付前用一次结构化模型调用写八节解读，校验不过或失败就不出解读、
报告照常交付。解读存在计算快照里，读接口一起返回，页面放在引擎正文之前，
后面标「计算依据」。用量按实际 token 记账（BUG-1460、BUG-1461）。

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LutgzyJqNhPpZy1nFsJtN3

docs/tasks/PROGRESS-voice-reading-20261027.md

@@ -0,0 +1,40 @@
+# 进度：报告开篇解读 + 对话口吻 C1（issue #113，2026-10-27）
+
+- 任务书：`docs/tasks/TASK-voice-reading-20261027.md`
+- 分支：`codex/voice-reading-20261027`（基线 `origin/staging` `9ca933968`）
+- 执行：Claude（直接执行模式）。BUG-1460（C1）、BUG-1461（R1）；staging 合入 #111 后最大号 1459，编号即为最终号。
+
+## 做了什么
+
+| 项 | 状态 | 说明 |
+| --- | --- | --- |
+| C1 对话 | 完成 | `CHART_REASON_RULE` / `HOUSE_LIFE_AREA_RULE` / `TIMING_FOCUS_RULE`；示例改写；读心第 2 条收窄；VOICE 第七条原则补充 |
+| R1-1 事实包 | 完成 | `scripts/report_render/reading_facts.py`；`professional_report_reference` 接 `include_reading_facts`（只在 full_data + markdown），开关进缓存键，失败只返回 `gaps` |
+| R1-2 写作 | 完成 | `lib/personal-report-reading.ts`（提示词、重试、超时 120 s）+ `mastra/personal-report-reading.ts`（结构化输出，与合盘写作器同一模式） |
+| R1-3 校验 | 完成 | 外文、字段名、禁词（宿命 / 病名 / 投资 / 内部说法 / 北交点）、节数与顺序、长度、每节免责 ≤1 |
+| R1-4 存与读 | 完成 | 存进计算快照 v2 的 `reading` / `readingUnavailable`（不改表）；读接口返回 `reading`，与英文版共用一次快照读取；页面在导读之后、引擎正文之前渲染，加「计算依据」，目录首条「解读」；英文不显示 |
+| R1-5 记账 | 完成 | 报告用量取解读调用的 token，没有解读时为 0；单价结算沿用 `completeUsage` |
+| R1-6 文档 | 完成 | DESIGN、VOICE、CHANGELOG、BUG_HISTORY、BLOCKED、真机清单 |
+
+## 改动的既有断言（三栏也写在测试里）
+
+| 文件 | 原值 | 新值 | 原因 |
+| --- | --- | --- | --- |
+| `consultation-voice-contract.test.ts` | 「然后在括号里给出撑住这段判断的盘上依据」「每段最多一处括号」 | 依据写进正文「因为……」，宫位带领域，时间最多三件；旧句不得出现 | issue #113 C1 |
+| 同上 | 示例标签「括号里是依据的占位」；Bad 起点「多对象题」 | 「「因为」后面的依据是占位」；先是新 Bad「段尾括号复述」 | issue #113 C1 |
+| 同上 | 父母例括号 `（母亲这条线没有受冲；…）`、事业例括号 `（木星行运 10 宫；…）` | 依据进正文，宫位带领域 | issue #113 C1 |
+| 同上 | 「用户自己的心全篇最多读一句」 | 只在情绪、关系感受题读；结尾不猜动机 | issue #113 C1 |
+| 同上 | 是非题例 `不是。（母亲这条线没有受冲；4 宫主落 10 宫）…` | `不是。管母亲的 4 宫（母亲、家和住处）这条线没有受冲…` | issue #113 C1 |
+| `consult-no-presupposition-20261001.test.ts` | 受冲规则「括号里只写…」；`每段的判断后在括号里给…`；是非题例 | 「依据只写…用白话写进句子」；段规则后接三条新常量；是非题例新写法 | issue #113 C1 |
+| `consult-plain-speech-20261006.test.ts` | 「括号里的依据最多两条」「括号里只写最能说明问题的一两条」 | 「说出来的依据最多两条」「依据只写最能说明问题的一两条」 | issue #113 C1 |
+| `consult-upstream-functional-v2-20261002.test.ts` | 妈妈段例括号 | 「因为管母亲的 4 宫…没有受冲」 | issue #113 C1 |
+| `personal-report-worker.test.ts` | `/inputTokens: 0/` | `/inputTokens: generated\.usage\?\.inputTokens \?\? 0/` | R1 解读按实际 token 记账 |
+| `personal-report-view.test.ts` | `<ReportToc headings={outline.headings} …/>` | `headings={tocHeadings}`，只在有解读时多一条「解读」 | R1 解读进目录 |
+
+## 环境缺口
+
+见 `BLOCKED.md` 同名条目：无模型 key，真实解读输出和名人生平回测都没跑。
+
+## 验收数字
+
+见本文件末尾（提交前补）。

docs/tasks/README.md

@@ -538,3 +538,4 @@
 | — | `PROGRESS-full-data-parity-1-fix2-20261022.md` | **#91 A 段第 2 次打回**（Claude 口头修复单 F1～F4）：11 节只印「未判定」和键名改读真实记录；测试只认非第一列真实值、禁止键名格；中文瑜伽组合句由中文源给出（BUG-1418）；六章降为 `##`、节 `###`（BUG-1419） | 本地完成，待验收 | `codex/full-data-parity-1-fix2-20261022` |
 | `TASK-lagna-precheck-20261027.md` | — | **#112 选 A**：星盘页页头告诉用户上升在其时间精度内会不会换（复用现成的 D1 窗口扫描，纯计算）；校正开场说清能做 / 不能做（BUG-1444、BUG-1445） | 待执行 | `codex/lagna-precheck-20261027` |
 | `TASK-lagna-precheck-fix-20261027.md` | — | **#112 第 1 次打回**：已有进行中的校正时点链接报冲突（应走首页续上）；别人的星盘页不该给校正链接 | 待执行 | `codex/lagna-precheck-20261027` |
+| `TASK-voice-reading-20261027.md` | `PROGRESS-voice-reading-20261027.md` | **#113 选 R1 C1**：报告前面加一段模型写的「解读」（八节，素材只用引擎事实，失败不影响报告）；对话依据写进正文、宫位带生活领域、时间最多三件（BUG-1460、BUG-1461） | Claude 直接执行，待验收 | `codex/voice-reading-20261027` |