docs(research): report/chat voice vs competitor reading (agent loop, issue #113)

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

docs/research/voice_vs_competitor_2026_10_27.md

@@ -0,0 +1,78 @@
+# 语气对比：我方报告 / 对话 vs 竞品解读（issue #113，2026-10-27）
+
+产品负责人 10-27 转来某竞品对一张真实盘的完整解读（朋友评价「像占星师说的话」），说我方「agent 输出和报告输出的语气用户看不懂」，要求先查问题、做对比，敲定后由 Claude 改。竞品原文含真实个人资料，**本文只描述写法，不引用其中的盘面结论**；我方样本全部来自虚构盘或公开名人盘。
+
+## 1. 样本
+
+| 样本 | 来源 | 说明 |
+| --- | --- | --- |
+| 竞品 | #113 正文，约 9,300 汉字 | 章节：总评、性格与内在、事业、财富、情感、健康、灵性成长、行动建议、命盘结构、需留意的组合、大运解读 |
+| 我方报告 | 虚构 0 号盘，完整数据版中文，staging `cef7b317a` 生产渲染路径 | 192 万字符、88 章 |
+| 我方对话 | 名人回测 round4（10-02，Jobs 事业 / 婚恋）+ 10-01 新提示词（Obama 父母） | **都早于 10-06 去标题、10-07 姐姐口吻与提示词瘦身**；仓库里没有更新的整段真实回答 |
+
+## 2. 数字（每千汉字）
+
+| 样本 | 外文词 | 括注 | 「可能 / 或许 / 多半」类 | 「你」 | 表格行占比 |
+| --- | --- | --- | --- | --- | --- |
+| 竞品 | 12.2 | 8.7 | **0.5** | 12.8 | 0% |
+| 我方报告·大运解释段 | 5.2 | 8.1 | **27.4** | **0** | 0% |
+| 我方报告·全文 | 15.6 | 5.0 | 14.8 | **0** | **91%** |
+| 我方对话（旧样本） | 0.3 | 10.4 | 1.3 | 16.0 | 0% |
+
+## 3. 竞品为什么读起来像占星师
+
+1. **每段一条链：盘面 → 机制 → 生活里的样子。** 先点出一个配置，用一句话说它为什么这样起作用，再落到「你在工作 / 家里 / 钱上会怎样」。
+2. **术语当「招牌」用，第一次出现带中文括注。** 例如「全盘唯一的功能大吉星（Yogakaraka）」。读者不需要懂，但会感到「有门道」。
+3. **有张力、有化解。** 「然而……」「化解之道在于……」「先……后……」，把几条盘面因素编成一个人的故事，而不是逐项列条件。
+4. **按人生领域分章，开头有总评。** 用户最想读的「我是什么样的人、事业、钱、感情、健康、现在这几年」各有一章。
+5. **大运是叙事。** 给出具体起止日期，每个子运说「这段的焦点是什么、接下来会转向什么」。
+6. **第二人称、语气笃定**，全文几乎不出现「可能」。
+
+竞品的问题（**不学**）：
+
+- 健康章直接写出具体病名倾向，财富章写「严禁某类投资」——与我方红线（医疗、投资不下确定结论，AGENTS Part B4）冲突。
+- 「先苦后甜」「宿命式」这类确定性断语，没有任何不确定性提示。
+- 同一段「性格」在页面上重复了三次，排版有缺陷。
+- 辞藻偏重（「咆哮」「烟消云散」），信息密度不如看上去高。
+
+## 4. 我方问题
+
+### 4.1 报告（主要问题）
+
+报告**不是模型写的**，是引擎模板拼出来的（`scripts/pl9_interpretation_packs.py`），这是「看不懂」的主因：
+
+1. **没有解读正文。** 没有总评、没有性格章；88 章里 91% 的行是表格。最接近「性格」的是逐颗行星的条件说明。
+2. **每句都在免责。** 大运段的模板是「这段时间可能突出的主题：传统阅读里，X 容易把……推到眼前。条件好时可能……受压时可能……怎么细读：先核对……」，对每一个主运、子运、次子运重复。「可能」类词的密度是竞品的约 55 倍，全文没有一个「你」。
+3. **内部口径直接写给用户。** 例如「功能吉凶用本仓功能吉凶层，不另做一套判断」「取消条件以检测器返回的说明为准，这里不新判」「六维力量合计为 9.9407」，表格里还有 `mars_house=2；severity=中等` 这种字段名。
+4. **术语政策与对话相反。** 对话禁梵文外文；报告的术语白名单（`pl9_language_terms.py` 的 `ZH_ALLOWED_LATIN_TOKENS`）专门保留 Dasha、Shadbala、Ashtakavarga、Vimsopaka 等外文，且不加解释。罗睺在报告里叫「北交点」，在对话里叫「罗睺」。
+5. **重点卡只有字段值**（中性、入庙、功能凶星）加一句免责，没有一句结论。
+
+### 4.2 对话（次要，需先拿到现行样本）
+
+- 规则层面（`frontend/src/mastra/product-voice.ts`、`frontend/docs/VOICE.md`）已经要求先给结论、第二人称、一段最多一个术语、不读心，旧样本的「你」密度、免责密度已接近竞品。
+- 旧样本的问题：括号里塞一串依据（「木星 10 宫、力量最强一档；兼 4 宫与 7 宫主；事业分盘第 11 宫」），读者跳过括号后剩下的是结论，但**缺「为什么」那一环**；竞品是把「为什么」用一句白话写进正文。
+- 10-06 / 10-07 之后的现行输出仓库里没有存档，判断现行对话前需要一份 staging 上的真实回答（产品负责人截图或贴文字即可）。
+
+## 5. 改法选项（交产品负责人拍板）
+
+### 报告
+
+- **R1（推荐）：报告前面加一段模型写的「解读」**，按竞品的章节：总评、性格、事业、财富、感情、健康、现在这几年（当前大运与接下来两个子运）、几条具体建议。
+  - 素材只用引擎已算好的事实（同对话的同源卡），不新增算法。
+  - 写法照第 3 节 1～5，但守我方红线：不写病名、不给投资指令、不写「注定 / 先苦后甜」；免责每章最多一句，不逐句。
+  - 原有表格和附录整体后移，标题改为「计算依据（附录）」。
+  - 代价：每份报告多一次模型调用（约数十秒、有成本），要做 A/B（对 77 例里的名人盘人工读几份）。
+- **R2：只改模板，不加模型。** 去掉内部口径句与字段名、免责只留章首一句、改第二人称、术语第一次出现加中文括注。确定、便宜，但仍然只是逐条说明，**写不出「几条因素合成一个人」的叙事**。
+- 两者不冲突：可以 R2 先做（一两天），R1 随后。
+
+### 对话
+
+- **C1：保持「懂行的姐姐」口吻，吸收「盘面 → 机制 → 生活」的一句链。** 依据不再只塞括号，正文里用一句白话说出「为什么」；术语仍是中文、一段最多一个。
+- **C2：向竞品靠拢，允许关键术语保留原文并带中文括注**（如「功能大吉星（Yogakaraka）」）。会更「像占星师」，但推翻 10-01 起「不出现梵文外文」的决定（BUG-1132～1134）。
+- **C3：对话不动，只改报告。**
+
+## 6. 不管选哪个都守的线
+
+- 不写病名、诊断、投资指令、确定性的死亡 / 婚姻结局（AGENTS Part B4）。
+- 候选出生时间不写成已确认。
+- 报告解读与对话用同一套术语（罗睺 / 计都统一）。