Compare commits
1
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
f602a92a11 |
@@ -0,0 +1,95 @@
|
||||
# 生时纠正自选:改成「用户自选情景」,按占星师 11-17 要求修订(2026-11-17,Claude)
|
||||
|
||||
Bug 编号:BUG-1958。关联 BUG-1936(#301)、BUG-1952(#306)。
|
||||
|
||||
## 背景
|
||||
|
||||
占星师 11-17 审了 #301 的任务单。结论:允许用户自己选线前线后,报告和聊天可以按所选一侧作主叙述;但这只是「用户选的情景」,不是出生时间已核实,来源可信度不能升级。她点名了几处必须改。产品负责人 11-17 同意照她的要求改,并同意:自选过的用户在回答开头看到一句说明(只出现一次,写成事实陈述)。
|
||||
|
||||
本单改自选页面、自选的保存记录、聊天。**报告、年运、合盘、导出里的说明不在本单**(依赖 BUG-1956 的出生输入版本,另开 BUG-1959)。
|
||||
|
||||
## 一、页面文案只描述已检查的东西
|
||||
|
||||
`frontend/src/components/chart-choice/chart-choice-page.tsx`:
|
||||
|
||||
- `这个时间范围内六张盘都不变,可以直接用。` → `这个时间范围内,六张盘的上升星座都不变。`(去掉「可以直接用」:六张盘的上升没变,不等于任何问题都不受影响。)
|
||||
- `不受影响:主盘。` → `上升星座不变:主盘。`
|
||||
- `差几分钟就不同:婚恋、事业…。` → `上升星座会变:婚恋、事业…。`
|
||||
- 首页「当前使用」里 `按你自己的选择` 保留。确认页 `这是你自己选的,可以随时改。` 后面加一句:`这不是出生时间已核实,你填的时间和范围都还保留着。`
|
||||
- 每张盘一行里的 `等 N 处`:现在只是文字。改成可以展开,展开后列出这张盘在范围内的全部换座时刻和前后星座(用现有的行样式,不新造组件)。结果页的统计、「还有几条线没选」的计数必须按**全部**线算,不能只按最近那条。
|
||||
- 以上都是正文,不是提示性小字副标题;不用加新的样式类。
|
||||
- 检查复用的 `ChooseStep` / 选项列表:选项顺序固定为 线前、线后、不确定;说明文字里不得出现任何旧的推荐、打分、「更符合」之类残留。加一条测试扫这些词。
|
||||
|
||||
## 二、保存记录写清这是情景
|
||||
|
||||
`frontend/src/lib/chart-choice/server.ts::adoptSelfChoice` 写入的 `provenance` 增加(已有字段不删):
|
||||
|
||||
- `selection_kind: "self_selected_scenario"`;
|
||||
- `declared_window`:用户原始申报的范围(现在的 `window` 是本次用的范围,可能是页面上选的宽度;两者都留,写清各是什么);
|
||||
- `scenario_segment`:所选情景的范围(等于现有 `segment`,保留 `segment` 以兼容旧读取);
|
||||
- `choice_revision`:这个主体的自选次数序号,从 1 起,每次保存加 1(从历史记录数出来,不新建表);
|
||||
- `remaining_lines`:所选情景范围内**还剩下**的换座线(时刻 + 换座的盘),用户点了「就到这里」或选了「不确定」时非空。
|
||||
|
||||
出生时间状态继续写 `accepted`,但新增并导出一个判断函数(放 `frontend/src/lib/chart-choice/` 下):`isSelfSelectedScenario(provenance)`。然后全仓搜索把 `accepted` 当作「已确认/已核实」对待的地方(界面标签、提示词、报告入参、合盘指纹里的 `reading_minute_confirmed` 等),**逐处列进 PROGRESS**,并改成:来源是自选情景时不显示、不传递「已确认」含义。拿不准某处该不该改的,列出来不要改,验收时定。
|
||||
|
||||
## 三、「不确定」不再硬凑两版
|
||||
|
||||
现状:「不确定」时为了让聊天的「两版都读」生效,硬写了 `chosen_side` 和一个 `other_saved_at`。占星师指出:多条线时情景可能不止两种,一个 `other_saved_at` 代表不了。
|
||||
|
||||
改成:
|
||||
|
||||
- Python `scripts/chart_choice/service.py::_self_choice` 的结果增加 `scenarios`:所选情景范围内,按剩余换座线切开的每一段各一条,字段为 `segment`(起止)、`saved_at`(用 `_self_choice_at` 的同一规则取代表时刻)、`key_charts`(六张盘上升)、`is_primary`(主叙述用的那一段:所填时间所在段;所填时间不在范围内时取离它最近的一段)。没有剩余线时只有一条。
|
||||
- `scenarios` 多于 4 条时只保留离所填时间最近的 4 条,另加 `scenarios_omitted: N`。
|
||||
- `provenance` 存 `scenarios`。旧字段 `chosen_side`、`other_saved_at`、`both_versions` 的处理:恰好两段时照旧写(兼容现有读取);一段时不写 `other_saved_at`;三段及以上时 `other_saved_at` 写 `null`、`chosen_side` 写 `"none"`,由 `scenarios` 表达。
|
||||
- `frontend/src/lib/chart-choice-both-versions.ts`:优先读 `scenarios`。两段时行为与现在一致;三段及以上时把非主段都作为「另外的情景」交给聊天(各段的分盘上升差异),被省略的段写明「另有 N 种情景没有算」。没有算的情景不得编内容。
|
||||
- 聊天侧现有的说明文字(`bothVersionsNotice`)相应改成能表达多种情景;不新增工具。
|
||||
|
||||
## 四、聊天开头的一句说明
|
||||
|
||||
来源是自选情景时,聊天回答里用到星盘的**每个会话的第一次回答**开头写一句(之后的回答不重复,除非用户问到出生时间):
|
||||
|
||||
`这次按你自己选的线后情景来看,不是出生时间已核实;你填的时间和范围都还保留着。`
|
||||
|
||||
「线后」按实际所选替换成「线前」;选的是「不确定」时写 `你没有选定线前还是线后,受影响的地方我会把几种情况分开说。`
|
||||
|
||||
实现放在现有咨询提示词装配处(`frontend/src/mastra/consultation-workflow.ts` 及其调用的提示词片段),作为一条条件指令,只在 `isSelfSelectedScenario` 为真时加入。这是产品负责人批准的例外,不违反「回答直接下判断」的规则:除这一句外,不得因为自选而在正文里加任何额外的保留语气。
|
||||
|
||||
两边结论不同的地方照现有「两版都读」的做法分开说;占星师要求以下情况即使用户选了一侧也要点出另一侧:两侧结论相反、一侧有时间窗另一侧没有、时间窗明显错开、父母手足等客观事实不同。本单的范围是**上升星座换座造成的分盘差异**(现有 `scenarios` 能给出的);时间窗漂移的比较依赖用途扫描(BUG-1953 之后),本单不做,在 PROGRESS「已知边界」写明。
|
||||
|
||||
## 五、旧请求重放不得覆盖新申报
|
||||
|
||||
`/api/chart-choice/adopt` 的 `selfChoice` 请求增加必填字段 `baseRecordId`(字符串或 `null`):客户端在 `preview` 时从响应里拿到当前记录号(服务端在 preview 响应里返回 `current_record_id`),保存时原样带回。服务端保存前比对当前记录号:
|
||||
|
||||
- 不一致(期间有过别的保存、改回、改申报)→ 409,稳定码 `stale_choice`,不写入;
|
||||
- 申报范围或原始填写时间在 preview 之后变过 → 同样 409(把申报的指纹也放进比对:preview 响应返回 `declaration_fingerprint`,保存时带回)。
|
||||
- 两个相同请求并发:只成功一次或两次结果完全相同(现有 `alreadyUsingSelfChoice` 的幂等保留)。
|
||||
|
||||
页面收到 409 时重新加载当前状态,回到结果页,不显示报错弹窗以外的新样式(用现有的错误提示)。
|
||||
|
||||
旧客户端不带 `baseRecordId` 的 `selfChoice` 请求:400。(自选还没上生产,不需要兼容期。)
|
||||
|
||||
## 六、不做的事
|
||||
|
||||
- 不恢复问卷、事件打分、任何推荐;`RECT_QUESTIONNAIRE_ENABLED` 不动。
|
||||
- 不改报告、年运、合盘、导出(BUG-1959)。不改聊天历史的处理(BUG-1960)。
|
||||
- 不改 `_self_choice_at` 的取分钟规则(BUG-1952 刚定)。
|
||||
- 不迁移已保存的自选记录:旧记录没有 `selection_kind` 时,`isSelfSelectedScenario` 按 `basis === "self_choice_20261116"` 也判为真。
|
||||
|
||||
## 七、测试
|
||||
|
||||
- `frontend/tests/chart-choice-self-choice-scenario-20261117.test.tsx`(新):三句文案替换;`等 N 处` 展开列出全部线;页面不出现「可以直接用」「不受影响」「推荐」「更符合」「已核实」(确认页那句「不是出生时间已核实」除外,按整句匹配放行)「已确认」「已校正」;409 后回到结果页。
|
||||
- 接口测试:`provenance` 新字段齐全;`choice_revision` 递增;`baseRecordId` 不一致 409 且无写入;申报变化后 409;并发两次幂等;不带 `baseRecordId` 400;#292/#294/#301 的旧载荷拒绝断言不删、照旧通过。
|
||||
- Python `tests/test_chart_choice.py`:`scenarios` 在 0、1、2、5 条剩余线时的段数、代表时刻落在各自段内且满足 BUG-1952 的规则、`is_primary` 唯一、超过 4 条时 `scenarios_omitted` 正确;第一条线就选「不确定」时不再有硬凑的 `other_saved_at`(两段时除外)。
|
||||
- 聊天:`isSelfSelectedScenario` 为真时提示词含开头说明的指令,为假时不含;三段情景时交给模型的块含全部非主段且不含未算的内容;既有 `chart-choice-both-versions` 测试照旧通过(确需调整的逐条在 PROGRESS 说明)。
|
||||
- `accepted` 审计:对 PROGRESS 列出的每一处改动各有一条断言。
|
||||
|
||||
## 八、文档
|
||||
|
||||
- `docs/BUG_HISTORY.md` 新增 BUG-1958,关联 BUG-1936、BUG-1952(只在自己那一节内编辑;不写姓名、出生资料、邮箱、ID)。
|
||||
- `CHANGELOG.md` 一行;`docs/tasks/PROGRESS-rect-self-choice-scenario-20261117.md`,含「`accepted` 被当作已确认的位置」清单和「已知边界」。
|
||||
|
||||
## 验收
|
||||
|
||||
- `PATH=<venv>/bin:$PATH python scripts/run_quality_gate.py --profile quick --skip-frontend-runtime` 通过;
|
||||
- `cd frontend && npx tsc --noEmit` 通过;`npx eslint .` 0 错误;新旧自选测试全部通过;前端全量测试不新增失败;
|
||||
- 验收时会用合成输入实跑引擎走:单线、三条线逐条选、第一条线不确定、就到这里、重放旧请求。
|
||||
Reference in New Issue
Block a user