fix: restore conversational rectification history

2026-07-23 14:26:35 +08:00
parent 08a49aa50f
commit 685f322981
13 changed files with 396 additions and 54 deletions
@@ -617,3 +617,19 @@
 - 相关记录：BUG-034、BUG-035
 - 复发自：无
 - 修复版本：待提交
+
+## BUG-037 | 生时校正刷新后把真实对话重建成“已记录”模板
+
+- 状态：resolved
+- 首次发现：2026-07-23
+- 最近更新：2026-07-23
+- 影响面：生时校正历史持久化、刷新/重新进入恢复、Agent 一问一答呈现
+- 用户现象：同一轮实时回答时 Agent 会针对经历自然追问，但刷新页面或重新进入生时校正后，旧回复全部变成“已记录这段经历：……”；用户原话也被日期和事件摘要替代，看起来像 Agent 又退回固定模板。
+- 触发条件：已有两轮以上生时校正回答后刷新网页、从首页重新进入，或在当前页面同步一个更新的持久化案例。
+- 根因：数据库已保存每轮 Agent `narrative`，但恢复 RPC 只返回 `latest_turn`；前端为了补齐历史，使用 `evidenceRecap` 机械合成用户气泡和“已记录”助手气泡。实时链路使用内存中的原话与真实 narrative，恢复链路却使用另一套有损数据源，导致刷新前后表现不一致。
+- 修复：为校正 turn 向前新增受约束的 nullable `user_message`，answer 保存事务同时持久化用户原话；新增仅限 `service_role` 的 history load/save/completion wrapper RPC，按轮次返回最近 200 轮 `userMessage + narrative`；客户端响应契约支持恢复历史，首次加载和同案例重新同步均直接渲染原始一问一答。旧记录只在有明确原始 evidence 时回填用户文本；无法恢复的旧轮次只显示真实最新 Agent narrative，不再伪造模板。
+- 验证：控制器回归覆盖首次恢复、旧数据 fallback、同案例重新同步和“不得出现已记录这段经历”；聚焦校正测试 90/90 通过；本地 PostgreSQL 从头应用全部迁移成功，并验证新列与 history RPC 的 `service_role`/`authenticated` 权限边界。测试内容均为虚构经历，不写入真实用户资料。
+- 防复发：任何对话历史必须从持久化的原始 user/assistant turn 恢复；事件摘要只能用于进度和评分，不得反向伪造聊天内容。网页验收必须同时检查实时回答和刷新后的同一历史。
+- 相关记录：BUG-032、BUG-034、BUG-036
+- 复发自：BUG-032
+- 修复版本：待提交