fix(rectification): bind quality cards to the followup probe

Graduation no longer gets the college-experience question, and identical D24 splits only ask once. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-04 23:47:47 +08:00
parent 73c2a1a51e
commit 40c623edf6
9 changed files with 462 additions and 9 deletions
@@ -8340,3 +8340,35 @@
 - 相关记录：BUG-414、BUG-418
 - 复发自：无
 - 修复版本：待发布
+
+## BUG-540 | 候选区分阶段同一道「上大学」发挥题问两次，第二次绑错证据
+
+- 状态：resolved
+- 首次发现：2026-09-04
+- 最近更新：2026-09-04
+- 影响面：`choice-card.ts::pickProbe`、`ChoiceCardFollowup.probe_id`
+- 用户现象：候选区分阶段连续两张选择卡题干、选项完全相同（「某年某月那次上大学，更接近如愿、将就调剂、发挥失常还是说不清」）。用户两次都作答，第二次答完范围继续收窄。
+- 触发条件：学业域已核实入学与毕业两条事件；引擎对两条各发一条 `known_event_quality`；第二张卡的 followup 指向毕业探针。
+- 根因：`pickProbe` 在 `choice_kind === "event_quality"` 时取池里第一条质量探针就返回，`semantic_key` 匹配写在后面，永远轮不到。`periodFor` 与 `eventQuestionPrompt` 都从这条错探针取日期和题干。用户第二次是对着入学题给毕业探针打分。
+- 修复：匹配顺序改为 `probe_id` → `semantic_key` → 无键时才按种类兜底。有键但找不到对应探针时返回 `null`，不出卡，不再退回同种类第一条。`question_id` 在有键时带上该键，避免两张质量卡共用一个 id。
+- 验证：同域两条质量探针、followup 指向第二条时，`buildChoiceFrame` 的 `question_id`、日期标签、`user_meaning` 全部来自第二条；指向第一条不受影响。有键找不到探针时 `buildChoiceFrame` 为 `null`。`rectification-choice-card` 既有 varga_style / existence 断言仍过。
+- 防复发：不得先按 `choice_kind` 取第一条质量探针再匹配 `semantic_key`。有 `probe_id` / `semantic_key` 时不得退回同种类第一条。
+- 相关记录：BUG-390、BUG-541
+- 复发自：无
+- 修复版本：待发布
+
+## BUG-541 | 毕业等学业 kind 套高考发挥题，同切分质量探针占满名额
+
+- 状态：resolved
+- 首次发现：2026-09-04
+- 最近更新：2026-09-04
+- 影响面：`event_probes.py::_quality_distinguish_probes`
+- 用户现象：毕业事件也被写成「上大学 / 调剂 / 发挥失常」。即便卡面绑对了，第二道仍不带来新切分信息。
+- 触发条件：学业域同时有入学与毕业；两条 `known_event_quality` 的 yes/no 分钟集合相同（同一 D24 星座切分），只有 `semantic_key` / `target_evidence_id` / `candidate_split_hash` 不同。
+- 根因：(1) `_quality_user_meaning` 与 `QUALITY_DISTINGUISH_OPTIONS["education"]` 只看 `domain == "education"`，不看 `event_kind`。采集线会产生 `education_completion`，模板仍是 BUG-390 的高考发挥题。(2) `candidate_split_hash` 掺了年份，同分组拦不住；`MAX_QUALITY_DISTINGUISH_PROBES = 2` 被两条信息相同的探针占满。
+- 修复：质量探针只对 `education_start` / `education_change` / `education_interruption` 发出；`education_completion` 与其它 kind、以及非学业域不发。同域同 yes/no 集合只保留信息增益最高、并列取时间最早的一条；被去掉的不计入名额。不改四选项文案，不改 `candidate_split_hash`，不新造毕业体验模板。
+- 验证：入学 + 毕业 → 一条质量探针且 `target_evidence_id` 指向入学。仅毕业 → 零条质量探针；训练门仍开时仍有 dasha 存在性探针。两条可发事件同分组 → 一条；`_select_quality_distinguish_rows` 不同分组 → 两条，第三条不超过上限 2。`test_probe_question_contract` 四选项合同仍过。
+- 防复发：学业质量探针必须看 `event_kind`（或 `kind`），不得对 `education_completion` 发。同域同 yes/no 集合不得发第二条。不得改 `QUALITY_DISTINGUISH_OPTIONS` 文案或 `candidate_split_hash` 算法来「修」去重。
+- 相关记录：BUG-390、BUG-540
+- 复发自：BUG-390（质量探针只对学业发出，但学业内 kind 未收紧）
+- 修复版本：待发布
@@ -0,0 +1,44 @@
+# PROGRESS · 学业质量探针去重（2026-09-04）
+
+工作树：`.worktrees/rectification-quality-probe-dedupe-20260904`
+分支：`codex/rectification-quality-probe-dedupe-20260904`
+基线：任务书写 `origin/staging` `a75929c1`；开工时 `origin/staging` 已是 `a68fd01f`（含本任务书）。未改 `.gitea/workflows/**`、未动迁移、未升级依赖、未 bump Skill（仍 10.0.14）、未改 `page.tsx`（2041 行）。
+
+| 任务 | 状态 | BUG |
+| --- | --- | --- |
+| 5.1 `pickProbe` 按键选探针 | 完成 | BUG-540 |
+| 5.2 质量探针按事件 kind 发 | 完成 | BUG-541 |
+| 5.3 同域同分组去重 | 完成 | BUG-541 |
+| 5.4 记录 | 完成 | — |
+
+## 编号
+
+开工时 `docs/BUG_HISTORY.md` 最大号 BUG-539。本单 **BUG-540、BUG-541**。未占用并行任务书预留的 BUG-542。
+
+## 实现要点
+
+- `pickProbe`：`probe_id` → `semantic_key` → 无键才按 `choice_kind` 兜底。有键找不到 → `null`，`buildChoiceFrame` 不出卡。`ChoiceCardFollowup` 补 `probe_id`；`makeFollowup` 已有字段，透传即可。
+- `question_id` 在 followup 带 `semantic_key` / `probe_id` 时拼进该键，避免两张质量卡共用 `d5_education:education_style:score`。
+- `_quality_distinguish_probes` 只对 `event_kind ∈ {education_start, education_change, education_interruption}` 的学业事件发；`education_completion` 与其它 kind、非学业域不发。字段读 `event_kind` 或 `kind`。
+- 同域同 yes/no 分钟集合只留信息增益最高、并列取时间最早的一条；被去掉的不计入 `MAX_QUALITY_DISTINGUISH_PROBES`。`candidate_split_hash` 与四选项文案未改。
+
+## 偏离
+
+- 任务书验收「不同分组 → 两条」在 `_quality_distinguish_probes` 里同域事件共用同一套 D24 yes/no，单次调用不会出现不同分组。不同分组与上限 2 的断言写在 `_select_quality_distinguish_rows`（5.3 实际去重函数）。
+- 「仅毕业仍参与普通时间探针」：3 条事件会被 holdout 抽走 1 条，训练门关、整表空。测试补了第四条家人事件让训练门仍开，断言仍有 dasha 存在性探针、零条质量探针。
+- 有键找不到探针 → 不出卡：新测试覆盖；既有 `rectification-choice-card` 夹具没有出现过这种情况。
+- 非学业域的区分质量探针一并停发（与 BUG-390「质量探针只对学业发出」对齐）。既有「事业不发质量卡」测试仍过。
+
+## 测试
+
+| 命令 | 结果 |
+| --- | --- |
+| `.venv/bin/python -m pytest tests/test_rectification_event_probes.py tests/test_probe_question_contract.py -q` | 40 passed |
+| `npx tsx --test tests/rectification-choice-card.test.ts tests/rectification-probe-question-contract.test.ts` | 47/47 |
+| 上两项 + `rectification-eight-method` + `rectification-answer-choice` | 140/140 |
+| `tsc --noEmit` | 0 错 |
+| `npx eslint . --quiet` | 0 error |
+| `page.tsx` | 2041 行，未改 |
+| `run_quality_gate.py --profile quick` 内 `npm test` | 2682 tests / 2673 pass / **9 fail**，全部是 Docker 迁移 `database migration failed`（`database-foundation` / `database-local-business` / redeem / identity / secret-refs / v9×3 / Skill migration）。与本单无关，属既有环境缺口。 |
+
+未跑全量 `npm test`（时间）；未做浏览器真人走查（无登录态）。清单：`docs/testing/rectification-quality-probe-dedupe-20260904.md`。
@@ -50,7 +50,7 @@
 | `TASK-rectification-collect-direction-20260904.md` | `PROGRESS-rectification-collect-direction-20260904.md` | 可评分事件 2 条时盘外核对抢跑到刚拒答的家人领域，Agent 只能改写成不指向任何领域的泛问；缺第三件带年份的事却先问职业 | 已验收：5.1/5.3/5.4 通过；5.2 顺序错位（任务书责任）见修复单 | `codex/rectification-collect-direction-20260904`（BUG-527～530） |
 | `TASK-rectification-collect-direction-fix-20260904.md` | `PROGRESS-rectification-collect-direction-fix-20260904.md` | dated 补采集分支插在方法轮转之前，新案例第二问被家人抢占感情/事业；`7ee7f825` CSS 与合同测试脱节挡住门禁 | 已验收通过（0be51e65），待 staging 部署核对 | `codex/rectification-collect-direction-fix-20260904`（BUG-531～532） |
 | `TASK-rectification-post-adopt-verify-20260904.md` | `PROGRESS-rectification-post-adopt-verify-20260904.md` | 采用后核对题重复已问题；核对卡「这题跳过」等于整案停止、已采用仍念"选一个先用着"、前端"没有拿到下一个问题"；采用旁白承诺的 holdout/OOS 核对与实际计划不同源（原任务书 §4 错误）；家庭采集题带年份前缀自相矛盾 | 待验收 | `codex/rectification-post-adopt-verify-20260904`（BUG-536～539） |
-| `TASK-rectification-quality-probe-dedupe-20260904.md` | — | 候选区分阶段同一道"上大学"题问两次：`pickProbe` 按种类取第一条质量探针无视 `semantic_key`（第二次答案绑到错的证据）；引擎对毕业等学业 kind 也套"高考发挥"模板；同域同分组质量探针不去重 | 待执行 | `codex/rectification-quality-probe-dedupe-20260904`（BUG-540 起） |
+| `TASK-rectification-quality-probe-dedupe-20260904.md` | `PROGRESS-rectification-quality-probe-dedupe-20260904.md` | 候选区分阶段同一道"上大学"题问两次：`pickProbe` 按种类取第一条质量探针无视 `semantic_key`（第二次答案绑到错的证据）；引擎对毕业等学业 kind 也套"高考发挥"模板；同域同分组质量探针不去重 | 待验收 | `codex/rectification-quality-probe-dedupe-20260904`（BUG-540～541） |
 | `TASK-api-not-configured-mislabel-20260904.md` | — | 16 处路由把数据库瞬断（部署切换窗口）兜底翻译成 503「服务尚未配置」；改为仅配置错误用该文案，其余 `service_unavailable`，收敛为共享 helper | 待执行 | `codex/api-not-configured-mislabel-20260904`（BUG-542 起） |
 | `TASK-rectification-ux-20260902.md` | `PROGRESS-rectification-ux-20260903.md` | 会话面空白假死与交互摩擦 | 已验收 | `d159f08e`（09-03 在新基线重做后合入，BUG-505～509） |

@@ -0,0 +1,28 @@
+# Staging 人肉复核 · 学业质量探针去重（2026-09-04）
+
+给产品负责人。实现者无法在真实校正会话里点选。测之前先做第 0 条。
+
+本单对应 BUG-540、BUG-541。不要把真实案例里的年份、事件或候选分钟写进任何记录。
+
+## 0. 确认测的是新版本
+
+浏览器打开 `https://staging.jyotisha.chat/api/health`，看 `deployment.gitCommit` 前 8 位是否等于本单合入 staging 后的提交。不一致 = 先别测。
+
+## 1. 入学 + 毕业最多一道「上大学」发挥题（P0 · BUG-540 / BUG-541）
+
+1. 新建生时校正。
+2. 采集阶段录入两条学业事件：一条入学、一条毕业（相隔几年即可），并补齐其它领域，走到**候选区分**（出现发挥/体验点选卡的那一段，不是采用后核对）。
+- ✅ 预期：最多出现一次「那次上大学，更接近如愿、将就调剂、发挥失常还是说不清」。题干年份 = **入学**年份，不是毕业年份。
+- ❌ 改造前：同一张入学发挥卡连出两次；第二次计分其实绑在毕业事件上。
+
+## 2. 题干与选项对得上当前这一问（P0 · BUG-540）
+
+若第 1 条出现了发挥卡：
+- ✅ 预期：日期标签、题干、「上大学」这句都指向同一年（入学那年）。不会一边写入学年、一边打分到毕业。
+- ❌ 改造前：卡面是入学题，后台 `probe_id` 却是毕业。
+
+## 3. 只有毕业、没有入学时（P1 · BUG-541）
+
+新案例只记毕业、不记入学，走到区分阶段：
+- ✅ 预期：不会出现套在毕业上的「上大学 / 调剂 / 发挥失常」题。仍可问其它带年份的存在性区分题。
+- ❌ 改造前：毕业也会被写成高考发挥题。