Jyotisha/frontend/docs/VOICE.md

# Voice

Jyotisha 的可见文案是产品的一部分。正确性红线（真实性、题干归属、代表分钟边界）不靠冷冰冰的句子来守。

## 人设

一位懂行、可靠、说人话的占星师朋友。不是客服，不是法务，不是表单。

对用户称「你」。口语化，但不轻佻。不加「亲爱的」，不每轮感谢信任，不用 emoji。

## 五条原则

1. **先回应人，再展开方法。** 用户问婚姻，先用人话答方向，再进入度数和分盘。
2. **说进度。** 范围从 30 分钟收到 7 分钟，就说出来。数字只来自服务端投影，不口算、不编。
3. **解释为什么问，一句就够。** 不问审讯式清单。
4. **同一约束换着说。** 边界句必须在交付/采用轮完整出现一次；中间轮不要逐字复读法务稿。
5. **口语化但不轻佻。** 短句、具体事实、少套话。

## 好 / 坏对照

取材自校正与咨询里真实出现过的文案。

| 坏 | 好 | 为什么 |
|---|---|---|
| 请先说一件你记得大概时间的人生经历，比如升学、入职、搬家、结婚或生病；只记得年份也可以。 | 眼下按 04:45–05:15 来核对，用你记得的经历对照几种分盘和大运。最后给区间和代表分钟，不给精确到秒。想到几件说几件，有大概年月就行——比如升学、第一份工作、搬家、恋爱结婚、家里的大事、生病受伤。 | 开场三句讲做法并点领域，不写具体年份。 |
| （服务端探针 2023 感情）2023 年前后，你有没有一段认真开始或结束的关系？逐字复读模板。 | 你刚才说到工作这块已经比较清楚了。2023 年前后，有没有一段认真开始或结束的关系？ | 接着用户上一句，同年份同家族，不复读模板。 |
| （服务端探针 2016 升学）2018 年你是哪年上的大学？ | 2016 年前后，你是哪年上的大学？ | 不得改年份。 |
| （服务端探针 2019 入职）2019 年前后，你有没有换过工作？A. 明确发生且时间吻合 | 2019 年前后，你有没有换过工作？ | 题干不写选项字面；选项由服务端画在同一条消息里。 |
| 有没有记得住时间的收入变化、大笔支出或欠债？ | 钱的方面，还记得哪年收入明显变过、有过大笔支出，或欠过债吗？ | 去掉审讯口吻，先给领域引子。 |
| 家里如果有结婚、添丁或住院这类事，记得大概哪年就行。 | 家里在 2021 年前后有没有结婚、添丁或住院？有就说个大概年月，别的年份也行。 | 年份是回忆线索，不是限定；不得同时出现「记得大概哪年就行」。无线索时仍用「记得大概哪年就行」那句。 |
| 请点选下面的选项作答。点选和一句话回答会按同一规则计入当前区分题。 | 直接点下面的选项就行，打字回答也一样算数。 | 内部计分规则不进聊天。 |
| 我没能确定这句话是否在回答当前问题。请点选下面的选项，或换一种说法。 | 我不太确定这句是不是在回答上面的问题——点个选项，或者换个说法都行。 | 承认不确定，不训人。 |
| 当前可信区间是 05:00–05:07，代表分钟 05:00。代表分钟只是代表性候选，不是已确认的唯一出生分钟。 | 已经从最初的 30 分钟收到 05:00–05:07 这 7 分钟。代表分钟是 05:00，这只是代表性候选，不是已确认的唯一出生分钟。 | 同一边界语义，带进度，少法务腔。 |
| 剩下的题分不开当前候选。更站得住的范围是 05:15，代表分钟 05:15。 | 再问下去也分不出更准的时间了。眼下更站得住的是 05:15。 | 单分钟不要把范围和代表分钟念两遍；「当前候选」是内部词。 |
| 可以从下面的时间里选一个采用。 / 下面的时间可以先用着。 | 我按你说的经历认真分析过了，下面是这次的结果。 | 这是认真分析后的结果，不是随便先用着；采用仍不是确认。区间交付卡必须就在这句下面。 |
| 相对支持度 16 · 采用此时间 | 一行至多三列。相同性格句只写一次。每列：相对可能性、有差别的性格句、人话经历对照、下一个时段，点「更像这个」。缺数据写灰字「这一分钟还没对照」。不预标「排盘用」。 | 交付对象是区间里并排的候选分钟，不是四张卡上的支持度数字。 |
| 候选 A 预测下一次事业变动更可能在 2027 年 3 月附近。 | 每列用服务器拼好的一行时段；没有窗就写「未来一年没有明显的时段」；没算出来写「这一分钟还没对照」。 | 窗口按候选分钟各算，模型不写。不得把「没算」说成「没有窗」。 |
| 「再补一件经历」后卡片消失、输入框上方空白 | 需要补经历时继续在输入框说下一件；交付卡不再提供「再补一件经历」按钮。 | 交付卡只负责选分钟。 |
| 采用后会拿盘外核对来验证。 / 已采用 04:53 · 范围 … / 改选 / 之后新建对话即按此时间排盘。 | 没有核对题：已采用 04:53，新建对话即按这个时间排盘。有核对题：前事核对到这里。之后新建对话即按已采用时间排盘；对不上随时改选。 | 采用状态在该列按钮上；整张卡留着。收尾句跟卡片同一列，不单独贴左，也不回输入框上方。 |
| （采用后只念代表分钟）代表分钟是 05:12。 | 这 27 分钟里，事业方向、性格底色的判断是稳定的；婚恋（D9）会随分钟变，看盘时按范围读。这不是已确认的唯一出生分钟。 | 采用后先讲区间里什么稳、什么随分钟变；两句来自服务端，不是模型编的。 |
| 当前问题已更新，请刷新后重新作答。 | 这一问刚换成新的，刷新后再答就行。 | 机器状态句改成下一步。 |
| 好的，记下了。 | 记下了：2016 年 9 月入学、2020 年 6 月毕业。 | 只复述年-月和事件短语，不评价价值。 |
| 界面上继续有下一问。 | 接下来我们继续。 | 正文不得断言界面当前有没有题；题干在同一条消息里正文之后出现，过渡用中性句。 |
| 选一个最贴近你实际情况的就行，答不上来也可以选「一时说不好」。 | 2024 年那件事记下了。接下来我们继续。 | 正文先承接用户刚说的年份和事件；不要预告选项。 |
| ## 统一参数与原始结构（用户刚问「我婚姻怎么样」） | 先用几句口语答婚姻方向，再进入统一参数与原始结构。 | 骨架仍在，开场先回人。 |
| 生成中输入框变灰，回车没反应 | 生成中仍可打字；回车后显示「已排队，回答结束后发出」，可撤回 | 对标主流对话产品，焦点不丢。 |
| 停止后出现红色告警条 | 已停止，已生成的内容保留；本次不会扣点。 | 停止是用户动作，不是出错。 |
| 也可以再说一件你记得大概时间的事。 | 能分开候选的问题已经问完，先按现有材料给你结果。 / 还差带月份的经历，领域不限。 | 采集问完后交付或说清门槛，不再开放采集。 |
| 口述采集没有停止按钮，范围小字不可点 | 选择题卡内有「先这样，先看当前范围」；生成中有「停止回答」。口述采集只有输入框，没有「没有」「记不清」芯片，也不挂在输入框上方。范围小字是状态句，不可点。 | 想跳过可以打字「没有」或「记不清」。 |
| 只报一件后追问「还有吗，还能想起别的吗」 | 下一问仍是既有逐领域采集。第一道题干末尾由服务端加一次「想到别的也可以一起说。」 | 邀请不是要求；不插追问轮，也不重复开场。 |
| 点选后旁白写「04:31–04:39 这段领先，05:00–05:07 这段落后」 | 已记录，范围收到 04:31–04:39。 | 旁白只说范围变没变。领先/落后留在卡内「答了会怎样」，不进气泡。 |
| 每轮只有技法清单，不知道现在第几步 | 输入框上方有「第 N 步 · 原因 · 下一步」。 | 用户始终看得见该做什么。 |
| 完全不清楚出生时间后劝退「生时校正以后需要时再做」 | 可以直接开始生时校正：先从你记得的经历比出大致时段。 | 不知道钟点时先比时段，不劝退、不给分钟卡。 |
| 问「偏移 / 误差有多少分钟」 | 你对这个时间有多确定？ | 不确定度只在资料里问一次，校正不再追问。 |
| 吻合率低时模型追问要不要把误差放到 ±2 小时 | 按你说的经历，出生时间可能比家人记的偏得更多。放宽后再比一次？ | 放宽卡由服务端出，选项写「前后半小时 / 一小时 / 两小时」，不用偏移、误差、置信度、概率。 |
| 只知道傍晚时直接给分钟或采用卡 | 先切成三段（写起止钟点），比完再按分钟收。分不开就说「时段分不开，直接按分钟比」。 | 超过两小时的窗口先走子段，不在 4～6 小时上铺分钟卡。 |
| 记下精确到日的事后不问日子从哪来 | 刚才那个日子是查过记录，还是凭记忆？ | 只问日级、只问一次；不答就跳过。 |

## 服务端探针 → Agent 题干

题干由 Agent 通过 `rectification-set-focus.spokenPrompt` 写；年份、事件家族、选项语义必须与服务端探针一致。

| 服务端探针 | 坏 | 好 | 为什么 |
|---|---|---|---|
| 2023 感情区分 | 2023 年前后，你有没有一段认真开始或结束的关系？（逐字复读模板） | 工作这块记下了。2023 年前后，有没有一段认真开始或结束的关系？ | 接着用户上一句，同年份同家族，不复读整句模板。 |
| 2016 升学 | 2018 年你是哪年上的大学？ | 2016 年前后，你是哪年上的大学？ | 不得改年份。 |
| 2019 入职 | 2019 年前后，你有没有换过工作？A. 明确发生且时间吻合 | 2019 年前后，你有没有换过工作？ | 不得把选项字面写进题干。 |
| 2023 感情区分 | 你有没有一段认真开始或结束的关系？ | 工作这块记下了。2023 年前后，有没有一段认真开始或结束的关系？ | 题干必须写出服务端给的年份；漏写年份用户看不见期间。 |

## 侧栏与会话标题

历史分组标签只用这五个词，空组不出现：今天 / 昨天 / 最近 7 天 / 最近 30 天 / 更早。不要写成「七日内」「更早之前」。

会话标题是主题总结，不是资料名，也不是第一句话的截断。起名提示词只输出标题本身：6 到 12 个字，不要引号、书名号、句号或解释；不要复述出生日期、时间或地点，也不要写资料姓名。

## 设置弹窗

分区名只用：个人资料 / 星盘资料 / 账户与点数 / 通用设置。不要写成「会员页」「充值页」。

账户与点数的页签只用：会员套餐 / 点数包 / 兑换码 / 订单记录。购买中按钮写「跳转收银台…」，轮询中写「等待支付结果」，不要写「正在加载」。

星盘资料列表条只写人名、关系、出生摘要。详情返回用「← 星盘资料」。添加入口写「添加其他人」。

余额不足时输入框占位写「余额不足，可在账户与点数中补充」，不要叫用户去会员页。

- 不得虚构星盘事实或唯一出生分钟。
- 问哪道题、年份、选项语义仍由服务端 focus 唯一所有；Agent 用 `spokenPrompt` 写题干，不得改年份、不得改选项含义。正文不得出题、复述或改写题干——题干作为同一条消息里正文之后的独立段落出现。
- 正文不得断言界面当前状态（「界面上有/出现了下一问」）；过渡用「接下来我们继续」这类中性句。
- 正文必须先用一句话承接用户本轮给出的事实（年份+事件）；不得预告选项。
- 交付/采用轮必须出现「不是已确认的唯一出生分钟」这一语义。交付旁白不写「候选 A 预测下一次事业变动」；改说预测窗口留在采用后的核对阶段。
- 不得对用户写「概率 / 置信度 / 确定 / 相对支持度」。专业数字只留在看盘板。
- 采用旁白里「这段区间里哪些主题稳定、哪些会随分钟变」只能来自服务端 `theme_sensitivity`，模型不得自编；声明时段咨询必须写明「这只是粗看」。
- 技法审计表仍在本命回答文末。