Jyotisha/docs/tasks/PROGRESS-rectification-in-chat-step1-20261006.md

PROGRESS：生时校正并入对话 · 第一步 — 2026-10-07

产品 2026-10-07 要求直接执行。实现：Claude fork 子代理；分支 codex/rectification-in-chat-step1-20261006（基线 origin/staging 328f919d，代码同 6ec8efd5）。未推送。BUG-1247～1251 均为 fixed-pending-verify。

实现（按任务书）

项	做法
T1 / P3 / C1	删首页「生时校正」pill、rectificationEntryHint、rectificationEntryLabels / resolveRectificationEntryAction；删 isRectificationHandoffQuestion 与发送路径里的交接分支、pendingConsultationQuestion 展示与传参。page.tsx 1357 → 1337 行，useState / useRef 数不变；新增一个 onStartRectification 动作
T2 / C2 / C3	RECTIFICATION_OFFER_RULE 只定义在 consultation-thinking-plan.ts，进首轮、追问与申报时段指令。工具 offer-birth-time-rectification（本命与申报时段两种 agent 都有）：只记录本轮提议；能否出卡由服务端 decideRectificationOffer 决定（本人、产品开关、无进行中 case、feature_pricing 价格）；会话里已提议过且非用户主动要求时拒绝。提议随回答经 complete_consultation_response 存进 messages，run.completed 事件带给浏览器
T3 / C4	打开接口带 sourceSessionId 时把该会话最新一张提议卡绑定到 case；GET /api/rectification/cases/[caseId]/source 在本人最近 20 条咨询里找来源；与校正水合并行读取
T4 / C5 / C6 / C8	POST …/source 由服务端读 accepted_time 判断是否改了时间，追加一次分隔消息、提议卡标 returned；浏览器重读来源会话并切过去。校正面「回到刚才的对话」按钮；verified_idle 或 case 终态时，本视图内做过操作的 case 2.5 s 后自动返回（历史打开的不跳）。分隔线、「按校正前的时间」小字、「按新时间重新看」（走普通 onFollowUp，点了才发）。C8 文案在 BUG-1258 已改为「之后的对话都按这个时间来看」，本单保持
T5 / C7	模型历史跳过分隔消息；改时间前的助手回答与早于改时间的会话摘要前缀「（以下回答按校正前的出生时间，不要沿用其中的盘面判断）」
T6	DESIGN.md、VOICE.md、CONTEXT.md（来源对话、提议卡）、CHANGELOG、BUG-1247～1251、本记录、真机清单 docs/testing/rectification-in-chat-step1-20261006.md

数据库：不改表、不加迁移。关联存在咨询会话自己的 messages JSON 里（rectificationOffer / rectificationReturn），写入用调用者自己的客户端（messages 是本人可更新列，20260715030000 起即有授权）。

偏离与原因

• 任务书 C4 说「刷新后仍在（服务端存）」：来源不单独存，读时在本人最近 20 条咨询里找绑定了该 case 的提议卡（绑定会写该会话，所以它在最近更新里）。代价：若用户之后在 20 条以上别的对话里聊过，再打开这次校正时找不到来源（只是没有返回按钮，不报错）。
• 来源对话的消息改写是读后整写，没有乐观锁：本地 Postgres 兼容层取回的 updated_at 精度不一定能做等值比较。并发风险只在用户同时在来源对话里提问时出现（此时人在校正面）。
• 提议工具成功后的说明，经模型实测改为「正文最后一段必须有一句提到卡片」（原写法 2/2 没提，改后 3/3 提到）。
• 首页卡片专用的 RECTIFICATION_OPENING_LABEL 一并删除（侧栏行的打开中文案是另一个常量，不变）。

验证（Linux + Node 22.14）

项	基线 6ec8efd5	本分支
tsc --noEmit	—	0 错
npm run lint	0 error / 126 warning	0 error / 125 warning
npm test	4973 项 / fail 24	4987 项 / fail 24；失败名单逐条一致（均为无 Docker 的数据库 / 部署类）；测试名逐条比对，无消失，新增 14 条
next build	/ ○ Static，首屏 gzip 567,201 B	/ ○ Static，568,343 B（+0.20%）
Python 快速门	—	py_compile / JSON / 审计 / pytest（329.7 s）通过；其中 npm test 一步因上述 24 条环境失败而红，与基线相同

断言改动 14 个前端测试文件 + tests/test_daily_and_rectification_entrypoints.py，每处写原值 / 新值 / 原因。

模型实测（DeepSeek deepseek-flash，公开名人 golden 盘，脚本在会话临时目录、不入库）：只是不认同解释 2/2 不调用提议工具；「过去的事对不上 + 时间是估的」2/2 调用；家人档案 2/2 调用后被服务端拒、一句话说明；已提议后再说不准 2/2 被拒且不再推；成功后正文提到卡片 3/3。

环境缺口

• 无 Docker：来源绑定 / 返回的真实库读写（chat_sessions.messages 读改写、maybeSingle、order + limit）未真查；只用了本地 Postgres 兼容层已实现的写法。部署后按真机清单第 4–8 步验。
• 无登录态浏览器：卡片、返回、自动返回、按钮不点不发均为渲染与源码合同测试，真机清单 11 步待产品。

Claude 独立验收（2026-10-07）

项	结果
tsc / lint	0 错 / 0 error（125 warning）
npm test	4987 项 fail 24，失败名单与 6ec8efd5 逐条一致
build	/ ○ Static；首屏 gzip 567,201 → 568,343 B（+0.20%）
Python	test_daily_and_rectification_entrypoints.py、隐私标记通过
page.tsx	1357 → 1337 行，未增长
数据库写权限	复核迁移：authenticated 有 update (title, theme, messages, updated_at)（20260715030000），本地 Postgres 兼容层 set local role authenticated 后直接 update public.chat_sessions，写来源对话消息可行；agentic_rectification_chat_sessions_case_guard 只在改 agentic_rectification_case_id 时触发，不拦
断言三栏	抽查 16 个改动文件；consultation-workflow-contract.test.ts 漏写，验收时补上

接受的风险（不阻塞上线，第二步一并处理）：来源靠扫描本人最近 20 条咨询找提议卡；来源对话消息读改写无乐观锁（用户校正时同时在来源对话发问才会冲突）；C2 判断的模型证据来自实现方的 DeepSeek 实测（4 场景各 2 次 + 卡片提示 3/3），验收未另跑。