From bdfb9462e283bbf3b8cd9c2ccb7bcc431e9d5d63 Mon Sep 17 00:00:00 2001 From: Jesse_Chen Date: Wed, 9 Sep 2026 11:29:23 +0000 Subject: [PATCH] =?UTF-8?q?docs(tasks):=20window=20cluster=20cap=20P0=20br?= =?UTF-8?q?ief=20=E2=80=94=20tail=20clusters=20dropped,=20cluster-range=20?= =?UTF-8?q?credible=20interval,=20mid-session=20declared=20window=20(BUG-6?= =?UTF-8?q?23~625)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_0193vBv6w5MV2cifdTUu9H5P --- docs/tasks/README.md | 1 + ...ctification-window-cluster-cap-20260909.md | 80 +++++++++++++++++++ 2 files changed, 81 insertions(+) create mode 100644 docs/tasks/TASK-rectification-window-cluster-cap-20260909.md diff --git a/docs/tasks/README.md b/docs/tasks/README.md index b6c6621d..abe9ba4b 100644 --- a/docs/tasks/README.md +++ b/docs/tasks/README.md @@ -89,6 +89,7 @@ | `TASK-consultation-daily-empty-answer-20260909.md` | `PROGRESS-consultation-daily-empty-answer-20260909.md` | 首页「深入看今日」计算完成却 `empty_answer`：入口定的 `timing` 被模型改成 `general`（`canonicalDomainPlan` 以模型为准），分段写作标题与今日格式错位，分段 `maxSteps=1` 且工具仍可调 → 模型在分段里再调工具、零正文；思考流按 chunk 过滤漏出缺词英文 | 待验收 | `codex/consultation-daily-empty-answer-20260909`（BUG-612～613）；走查 `docs/testing/consultation-daily-empty-answer-20260909.md` | | `TASK-rectification-compare-card-polish-20260909.md` | `PROGRESS-rectification-compare-card-polish-20260909.md` | 三列卡两列经历对照 0、三列无未来窗：引擎按引擎前三算 by_time，卡片按推断前三查表，键不匹配（BUG-614）；交付旁白被 BUG-606 裁成一句（BUG-615）；设计减法：相同性格句只写一次、经历对照说人话、删小标题、右栏本命宫位改北印星盘、换升时刻默认折叠 | 待验收 | `codex/rectification-compare-card-polish-20260909`（BUG-614～615） | | `TASK-rectification-history-open-20260909.md` | `PROGRESS-rectification-history-open-20260909.md` | 历史生时校正打不开：`open_agentic_rectification_case_v2` 把 Case 绑定 Skill 身份与当前注册版本做相等比较，两天内 10.0.15→10.0.19 五次 bump 让所有旧 Case 被拒；错误码未映射成 500；错误只画在首页卡下 → 表现为点了没反应。决策：session 打开用绑定身份（v1 取 Case → 读身份 → 注册表核验 → v2），不改迁移 | 待执行 | `codex/rectification-history-open-20260909`（BUG-621） | +| `TASK-rectification-window-cluster-cap-20260909.md` | `PROGRESS-rectification-window-cluster-cap-20260909.md` | **P0** 真实用户：一小时窗口分 17 个签名簇，`select_signature_representatives` 按时间取前 12 个，14:40 之后整簇丢弃（本机复现表）；区间按代表分钟跨度而非簇覆盖；中途说出真实时段无意图无 RPC，助手口头答应未改；intake 无自定义小范围 | 待执行 | `codex/rectification-window-cluster-cap-20260909`（BUG-623～625，Skill 10.0.20） | ### 聊天主链路与首页 diff --git a/docs/tasks/TASK-rectification-window-cluster-cap-20260909.md b/docs/tasks/TASK-rectification-window-cluster-cap-20260909.md new file mode 100644 index 00000000..60fe2bd5 --- /dev/null +++ b/docs/tasks/TASK-rectification-window-cluster-cap-20260909.md @@ -0,0 +1,80 @@ +# TASK · 一小时窗口后三分之一被 12 簇上限静默丢掉，真实出生时间从一开始就不在候选里；用户中途说出更窄的时间段无人接（2026-09-09） + +- 基线：`origin/staging` @ `c41afe26` +- 分支：`codex/rectification-window-cluster-cap-20260909`，基于 `origin/staging` +- 执行方：coding agent；验收：Claude +- 涉及文件：`scripts/rectification/candidate_contrast.py`（`MAX_PUBLIC_CLUSTERS`、`select_signature_representatives`）、`scripts/rectification/decision_policy.py`（`build_candidate_decisions` 候选字段）、`scripts/rectification/api_service.py`、`frontend/src/lib/rectification-agentic/v9/inference-adapter.ts` / `core/build-state.ts` / `core/credible-range.ts`（簇范围）、`frontend/src/app/api/rectification/agent/route.ts`（自由文本分支）、`frontend/src/lib/rectification-agentic/v9/turn-intent-classifier.ts`、`v9/answer-choice.ts`（新卡片）、`v9/tool-service.ts`、新迁移 `frontend/supabase/migrations/2026091001xxxx_rectification_set_case_window.sql`、`frontend/src/lib/birth-time-intake-model.ts` + `components/birth-time-intake.tsx`（自定义范围）、`skills/jyotish-birth-time-rectification/SKILL.md`（不得口头承认改窗口） +- BUG 编号起点：**BUG-623**（`docs/BUG_HISTORY.md` 当前最大 BUG-622） +- 优先级：**P0**（真实用户：intake 填 14:00–15:00，本人知道是 14:45–14:50，系统收到 14:04–14:43 并继续出题；用户说出真实时段后助手口头答应却什么都没改） + +## 1. 事故实证（2026-09-09 真实用户转录 + 本机引擎复现；不写用户资料） + +| 转录 | 事实 | +| --- | --- | +| 第一轮证据写完范围就是 14:02–14:40 | 一小时窗口的第一次 compare 就只给出到 14:40 的候选 | +| 用户："我的出生时间是 14 点 45 到 14 点 50" → 助手（1 步）"明白了，出生时间以你说的 14:45–14:50 为准" | 助手没有任何工具能改搜索窗口（`rectification-v9-tools.ts` 的 15 个工具里没有）；opening brief 还明写"线索仅旁白建议，不得改搜索窗口"（`agent-run.ts` L256）。这是口头答应、实际未改 | +| "继续吧" → "我不太确定这句是不是在回答上面的问题" | 当前焦点是点选题，自由文本进 `classifyRectificationTurnIntent`，枚举里没有"申报时间段"这一意图，落 `unclear` | +| 范围仍 14:04–14:43 | 真实时段从头到尾不在候选集里 | + +**本机复现**（虚构盘 1997-08-08，`minute_step=1`）： + +| 窗口 | 分钟数 | 签名簇数 | 保留簇 | 保留到的最后一分钟 | 被丢掉的簇 | +| --- | --- | --- | --- | --- | --- | +| 14:00–15:00 | 61 | **17** | 12 | **14:39** | 14:40–14:45、14:46–14:51、14:52–14:53、14:54–14:57、14:58–15:00 | +| 14:30–15:00 | 31 | 9 | 9 | 15:00 | 无 | +| 04:45–05:15 | 31 | 9 | 9 | 05:15 | 无 | + +半小时窗口刚好压在 12 以内，所以前面十几次实测（都是 ±15）从未暴露；用户一选"前后半小时"（60 分钟窗）就必然丢后段。 + +## 2. 根因 + +### 2.1 BUG-623（P0）：候选簇按时间排序后取前 12 个，多出的整簇丢弃 + +`candidate_contrast.py::select_signature_representatives`：`cluster_contexts_by_signature` 把簇**按代表分钟时间排序**，循环里 `if len(representatives) >= MAX_PUBLIC_CLUSTERS: break`（`MAX_PUBLIC_CLUSTERS = 12`）。超过 12 簇时，被丢的永远是窗口尾部。这发生在任何证据评分之前，后面所有的"范围收到 …"都只在残缺候选集内进行；旁白与时间轴把 14:04–14:43 说成收敛结果，实际上 14:40 之后从未被考虑过。 + +### 2.2 BUG-624（P1）：可信区间按代表分钟的跨度算，不按簇的实际覆盖算 + +引擎候选只带 `time`（簇里分数最高的那一分钟），不带簇成员；推断层 `cluster_range` 是用换升时刻在代表分钟之间重新聚的，多数是单分钟；`credible-range.ts` 取 still-valid 候选的 `cluster_range` 与 `time` 的跨度。于是即便 14:40–14:45 这一簇活着，若代表分钟是 14:40，区间右端也只写到 14:40，簇内其余五分钟被"视觉淘汰"。 + +### 2.3 BUG-625（P1）：中途申报更窄时段无人接，助手还口头答应 + +没有"申报时间段"意图；没有把窗口改窄的 RPC（`widen_agentic_rectification_case_window` 要求 `v_new_width > v_old_width`）；模型在采集焦点下收到这句话就自己"答应"了。intake 的"家人记得大概时间"只能选 ±15 / ±30 / ±60 / ±120，知道 14:45–14:50 这种小范围的用户没有地方填（`customDeclaredRange` 只给 `period_only`）。 + +## 3. 决策记录 + +1. **去掉按时间截断。** `select_signature_representatives` 不再 `break`；`MAX_PUBLIC_CLUSTERS` 改为安全上限 64（±120 窗口 241 分钟实测簇数写进度记录）；若真超过 64，按**分数**合并相邻低分簇，不丢尾部。公开候选数变多（一小时 ≈17）不影响四选项合同：探针的 `candidate_ids` 本来就是分钟集合。 +2. **候选带簇成员。** `build_candidate_decisions` 每个候选加 `cluster_times: [HH:MM…]`（连续分钟段可写 `cluster_start/cluster_end`）；`inference-adapter.ts` 把它作为 `cluster_range` 的来源（换升聚类只作退化兜底）；`credible-range.ts` 的区间 = still-valid 簇覆盖的并集跨度。时间轴的实心/空心点仍按候选（代表分钟）画，簇范围只影响区间带。 +3. **中途申报时段 → 服务端卡片，不进模型。** `route.ts` 自由文本分支前置一个确定性解析：识别 `HH:MM–HH:MM`、"14 点 45 到 14 点 50"、"14:45 左右" 这类表述 → 不调分类器，直接持久化一张选择卡：题干"把搜索范围改成 14:45–14:50？"，选项 A「改成这个范围」/ B「保持现在的范围」（两选项，不是四选项探针，用 `choice_kind = window_declare`，走 BUG-572 放宽卡同一渲染路径）。A：新 RPC `set_agentic_rectification_case_window(p_start, p_end)`——允许收窄或放宽，但必须落在 intake 窗口内（或与之相交时取交集）、宽度 ≥3 分钟、Case 未采用未终止；使结果失效，`rescoreMinuteAfterWindowChange({keepAnswers:false})`。宽度 ≤5 时下一步直接进交付（现有门允许）。 +4. **模型不得口头承认改时间。** SKILL.md §4 加一句："用户说出出生时间或时段时，不得回答『以你说的为准』或改写搜索窗口；服务端会出确认卡。"并在 `agent-run` 的正文守卫里把"以你说的…为准"列入机器词表删除。 +5. **intake 加自定义范围。** "家人记得大概时间"下方增加"我知道一个更小的范围"：两个时钟选择器 → `customDeclaredRange`，宽度 3–241 分钟；这条路仍是 `minute` 阶段（不是 `period_only` 的时段扫描）。 +6. 不动淘汰阈值、`SCORE_DELTA`、采用/确认门、`_relative_support`、`minute_step`。**新迁移需要 `npm run test:db`（Docker）**：执行方无 Docker 时写 `BLOCKED.md`，DB 用例照写，验收时由我在有 Docker 的环境跑或标环境缺口，不得写成通过。 + +## 4. 任务分解 + +- 4.1 BUG-623：改 `select_signature_representatives`；`tests/test_rectification_v5_services.py` 加"14:00–15:00 虚构盘 17 簇全部保留、候选含 14:46–14:51 簇的代表"；用本单 §1 表格做回归夹具（虚构盘，不含真实资料）。 +- 4.2 BUG-624：`cluster_times` 贯通到 `credible_range`；用例——簇 14:40–14:45 存活、代表 14:40 → 区间右端 14:45。 +- 4.3 BUG-625：解析器 + 卡片 + RPC + 重算；用例——点选焦点下输入"我的出生时间是 14 点 45 到 14 点 50"→ 出现两选项卡、无模型调用；选 A → `candidate_range` 变 14:45–14:50、旧结果 `invalidated_at` 非空、compare 一次、答题账本清空；范围超出 intake 窗口 → 取交集并在卡片题干写明；已采用 Case → 卡片不出、回执"已采用的校正不能再改范围"。 +- 4.4 决策 4：Skill 10.0.20（只加一句）；`agent-voice-copy-contract` 收禁用短语。 +- 4.5 决策 5：intake 自定义范围；`birth-time-intake*.test.ts` 三栏。 +- 4.6 记录：BUG-623（P0，关联 BUG-560 校准记录：以前的"分钟级≈随机"结论是在 ±15 窗口上得出，一小时窗口还叠加了截断）、BUG-624、BUG-625；`CHANGELOG.md`；`PROGRESS-…`；`docs/testing/` 加"±30 窗口下候选必须覆盖整窗；中途说出时段必须出确认卡；助手不得口头答应改时间"。 + +## 5. 让步顺序 + +4.1 当天必做并部署（一行改动止血）；4.2、4.3 必做；4.4 随 4.3；4.5 可后置为 P2；4.6 不可省。 + +## 6. 给当前这位用户的临时办法（产品可直接转告） + +在资料里把出生时间改成 14:47，来源选"家人记得大概时间 · 差不多准"（±15，窗口 14:32–15:02，31 分钟、9 簇，不会触发截断），重新开始校正。或者选"有出生证或医院记录"填 14:47。 + +## 7. 开工前置命令 + +```bash +git fetch origin --prune +git worktree add -b codex/rectification-window-cluster-cap-20260909 .worktrees/rectification-window-cluster-cap-20260909 origin/staging +cd .worktrees/rectification-window-cluster-cap-20260909 +ln -s /workspace/Jyotisha/frontend/node_modules frontend/node_modules +ln -s /workspace/Jyotisha/.venv .venv +.venv/bin/python -m pytest tests/test_rectification_v5_services.py -q +cd frontend && ./node_modules/.bin/tsc --noEmit; npm run lint 2>&1 | tail -1 +ls tests/rectification-*.test.ts tests/birth-time-intake*.test.ts | grep -v database | xargs npx tsx --test 2>&1 | grep -E "^# (tests|pass|fail)" +```