From 3973b6c3dcddf4b9da71769cedb906738431a535 Mon Sep 17 00:00:00 2001 From: Jesse_Chen Date: Mon, 7 Sep 2026 15:31:59 +0000 Subject: [PATCH] docs(tasks): duplicate narration fix brief (BUG-584/585) Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_0193vBv6w5MV2cifdTUu9H5P --- docs/tasks/README.md | 1 + ...tification-duplicate-narration-20260907.md | 76 +++++++++++++++++++ 2 files changed, 77 insertions(+) create mode 100644 docs/tasks/TASK-rectification-duplicate-narration-20260907.md diff --git a/docs/tasks/README.md b/docs/tasks/README.md index 69a74f26..23e142ef 100644 --- a/docs/tasks/README.md +++ b/docs/tasks/README.md @@ -72,6 +72,7 @@ | `TASK-rectification-stop-rescore-fix-20260907.md` | `PROGRESS-rectification-stop-rescore-fix-20260907.md` | **P0**：BUG-579 的停止路径用「裸重算」（`rescoreMinuteAfterWindowChange` 不重建 `inference_state`、不重放已答探针、不写 transition），停止后范围变宽、卡片变成引擎裸支持度、采用 RPC 报 `candidate_state_inconsistent`；无框区分题经 `spokenCollectFallbackFollowup` 变成 domain=other 的采集题，再次冒出开场句 `GENERIC_COLLECT_QUESTION`；holdout 采集排在带年月采集之前 | 已验收通过（逻辑）；但同提交含区间卡 tsc 错，整体不可部署 | `ab57d03f`（BUG-581～582） | | `TASK-rectification-range-delivery-card-20260907.md` | `PROGRESS-rectification-range-delivery-card-20260907.md` | 结尾重设计：四张分钟卡 + 相对支持度换成一张区间交付卡（范围、代表分钟、稳定/敏感主题、边界句）+ 只列未问 D9/D10/月宿分歧的 2～3 列对比面板（文案只取类型表），动作只有「按这个范围用 / 再补一件经历」；删交付旁白里三行预测窗口；Skill §9 口径改、bump 10.0.15 | **未通过**：tsc 1 错（判空顺序）；P2 预测窗口句兑现不了；P3 再补经历无提示 | `ab57d03f`；修复单 `TASK-rectification-range-delivery-fix-20260907.md` | | `TASK-rectification-range-delivery-fix-20260907.md` | `PROGRESS-rectification-range-delivery-fix-20260907.md` | 区间卡修复单：`candidateResult` 判空提到最前（tsc 阻断）；预测窗口接到采用后首轮或删句；「再补一件经历」隐藏卡后给采集提示；进度记录须贴 tsc 原文 | 待验收 | `codex/rectification-range-delivery-fix-20260907`（BUG-583） | +| `TASK-rectification-duplicate-narration-20260907.md` | `PROGRESS-rectification-duplicate-narration-20260907.md` | 每轮采集旁白说两遍 + 题干在正文与问题块各一次：`step-answer` 的 set-focus 例外（BUG-533）放行了 set-focus 前后两个 step 的正文并拼接；`detachCollectSpokenAssistantText` 只剥逐字后缀，模型写进正文的问句没有代码守卫（BUG-488 防线只在提示词） | 待执行 | `codex/rectification-duplicate-narration-20260907`（BUG-584～585） | | `TASK-api-not-configured-mislabel-20260904.md` | `PROGRESS-api-not-configured-mislabel-20260904.md` | 16 处路由把数据库瞬断（部署切换窗口）兜底翻译成 503「服务尚未配置」；改为仅配置错误用该文案，其余 `service_unavailable`，收敛为共享 helper | 已验收 | `5483649b`（BUG-542）；2 条子进程测试留 CI Node 22 复核 | | `TASK-rectification-ux-20260902.md` | `PROGRESS-rectification-ux-20260903.md` | 会话面空白假死与交互摩擦 | 已验收 | `d159f08e`（09-03 在新基线重做后合入，BUG-505～509） | diff --git a/docs/tasks/TASK-rectification-duplicate-narration-20260907.md b/docs/tasks/TASK-rectification-duplicate-narration-20260907.md new file mode 100644 index 00000000..e1e10deb --- /dev/null +++ b/docs/tasks/TASK-rectification-duplicate-narration-20260907.md @@ -0,0 +1,76 @@ +# TASK · 生时校正修复单：同一轮旁白说两遍、题干在正文与问题块各出现一次（2026-09-07） + +- 基线：`origin/staging` @ `f3e72702`（代码头 `ab57d03f`，含 BUG-583 未修的 tsc 错；staging 已部署 `84a29754`，事故在多轮实测中稳定复现） +- 分支：`codex/rectification-duplicate-narration-20260907`，基于 `origin/staging`。与 `codex/rectification-range-delivery-fix-20260907`（BUG-583，只改 `rectification-agentic-chat.tsx`）无文件重叠，可并行；谁后合谁 rebase。 +- 执行方：coding agent；验收：Claude +- 涉及文件：`frontend/src/lib/rectification-agentic/v9/step-answer.ts`、`v9/agent-run.ts`、`v9/collect-prompt.ts`、`v9/turn-question.ts`、`frontend/tests/rectification-step-answer.test.ts`、`rectification-collect-prompt.test.ts` +- BUG 编号起点：**BUG-584**（BUG-583 已由区间卡修复单占用；开工时 `grep -o "^## BUG-5[0-9][0-9]" docs/BUG_HISTORY.md | tail -1` 复核） +- 优先级：**P1**（每一轮采集都复现；用户读到两段近似旁白 + 两遍题干，以为系统出错） + +## 1. 事故实证（staging，多次实测；只写结构） + +一条助手消息自上而下是： + +1. 旁白第一段：承接用户刚说的事，说范围/对照情况，**末尾把下一题问了一遍**（自然语言，含年份与领域，以「？」结尾）。 +2. 旁白第二段：换个说法把第一段又说一遍（有时更短，有时又带一遍题）。 +3. 「本轮对照了 …」方法句（客户端 `vargaSentenceFromMethods` 渲染）。 +4. 问题块：服务端 `ConversationFocus.spokenPrompt` 的题干，与第 1 段末尾那句同义或逐字相同。 + +## 2. 根因（两条，叠加） + +### 2.1 BUG-584（P1）：set-focus 前后两个 step 的正文都被放行并拼接 + +`step-answer.ts` 的规则：文本先于 public 工具调用的算「规划稿」，工具调用时 `retractLive` 撤回。但 `KEEP_LIVE_SPOKEN_TOOLS = {rectification-set-focus}` 是例外（`a793edb1`，BUG-533：为了不把开场问候撤掉）——set-focus 之前已直播的中文保留，set-focus `tool-result` 只 `resetBuffers` 不撤回；随后模型在**下一个 step** 看到 set-focus 结果再写一段正文，`step-finish(reason=stop)` 走 `shouldPublishStepText` 正常发布。`agent-run.ts` 的 `publishSpokenStep` 是 `spokenRaw += spoken`，两段正文无分隔、无去重直接拼成 `answerText`，落库为 `assistant_message`。 + +固定这个行为的正是测试 `rectification-step-answer.test.ts::keeps a live opening greeting when the next public tool is set-focus`：它断言 set-focus 之后的第二段也 `live` 发布。开场轮两段短句无伤；证据轮模型在 set-focus 前先总结一遍、拿到结果后又总结一遍，就是用户看到的"说了两遍"。receipt 里每轮两个 `intent.classified` 是同一件事的旁证。 + +附带损失：set-focus 前尚未触发直播（没遇到句末标点）的文本、以及已直播部分之后 `publishedUpTo` 以外的尾巴，在 `tool-result` 的 `resetBuffers` 里被静默丢掉——这是偶发"旁白半句"的来路。 + +### 2.2 BUG-585（P1）：题干去重只认逐字后缀，模型写进正文的问句剪不掉 + +服务端只在 `turn-question.ts::attachQuestionsToTurns` 用 `detachCollectSpokenAssistantText(turn.text, question.prompt)` 剥题干，而它只剥两种形态：正文整体 === 题干，或正文以 `\n\n${题干}` 结尾。模型自己在正文里问出来的句子（同义改写、或逐字但嵌在段落中间）一概保留；问题块再从 focus 渲染一遍 → 同一题两遍。`composeCollectSpokenAssistantText` 里那套「按题干前 12 字剪句」只用于拒答确认句（`answer-choice.ts` L1059），agent 路径根本没走。 + +不让模型提问的约束只有提示词：`SKILL.md` L59「正文……不得自行提出、复述、改写或预告问题」、set-focus 描述「你只写 spokenPrompt」、opening brief「不要提问」。BUG-488 的防复发写的是「不得同时让模型提问又拼接同一句服务端题干」，靠"模型仍不自己提问"兜住；`d9404976` 把题干改成消息内问题块后，这条防线没有任何代码守卫，于是复发。 + +另外 `agent-run.ts` L284 `const collectSpokenEmitted = false` 是常量，只被原样透传进结果，没有任何读者——它就是当年打算做"题干已出、正文别再出"守卫的残骸。 + +## 3. 决策记录 + +1. **有服务端问题的轮次，正文不得含问句；含则服务端剪掉。** 这是把 SKILL.md L59 从提示词升级为代码守卫：`answer.composed` 之前，若本轮 set-focus 成功（focus.askedTurnId = 本轮），对 `answerText` 做 `stripQuestionSentences(body, stem)`：按 `。！？\n` 切句，删掉 (a) 与题干相同、(b) 以题干前 12 字开头、(c) 以「？」/「?」结尾 的句子。剪空则用一句固定承接（`RECTIFICATION_USER_COPY` 新增 `collectHandoff`，对照 `VOICE.md`，不得说"请回答下面的问题"之类机器话）。剪后文本以 `answer.delta replace:true` 再发一次，保证直播与落库一致。选择题轮（`choice_frame`）同样适用——选项由卡片承载，正文不问。 +2. **set-focus 之后不再接受新一段正文。** `step-answer.ts`：set-focus `tool-result` 后置 `state.stemAttached = true`（随 turn 存活，不随 `resetBuffers` 清）；此后 step 的 `text-delta` 只有在本轮此前**没有**发布过任何正文时才放行（保住 BUG-533 的开场问候路径：问候在 set-focus 前，或模型只在 set-focus 后说一句），否则 `discard`。两段都有时保留**前一段**——它是模型对刚才证据的直接回应；后一段只是对工具结果的复述。 +3. **set-focus 前的未直播文本不得静默丢弃。** `tool-call(set-focus)` 时把 `state.text` 未发布部分作为 `publish` 效果发出（它是给用户的话，不是规划稿），再 `resetBuffers`。若该文本没有 CJK（英文规划稿），维持原 discard。 +4. 删除 `collectSpokenEmitted` 常量与其类型字段。 +5. 提示词不动、Skill 不 bump（不是口径变化，是守卫补齐）。不动采用门、确认门、`MIN_SEPARATION_LEAD`、`_relative_support`、`minute_step=1` 指纹；不动 `frontend/src/app/page.tsx`。 + +## 4. 任务分解 + +### 4.1 BUG-584：单段正文 +- `step-answer.ts` 按决策 2、3 改；`StepAnswerState` 加 `stemAttached`、`publishedAny`（后者由 `agent-run.ts` 在首次 `publishSpokenStep` 成功后写回，或由 state 自记）。 +- 改既有测试 `keeps a live opening greeting when the next public tool is set-focus`：原值——set-focus 后第二段 `live` 发布；新值——第二段 `discard`；原因——决策 2。新增：(a) set-focus 前无正文、后有一段 → 后段 `live/publish`（BUG-533 路径仍通）；(b) set-focus 前有未闭合半句「范围已经收到 05:00 到 05:10」（无句末标点）→ `tool-call(set-focus)` 时以 `publish` 发出，不丢；(c) 英文规划稿 + set-focus → 仍 discard。 +- `agent-run` 级：`rectification-v9-agent-run*.test.ts`（现有 mock stream 夹具）构造「文本 → set-focus → 文本 → finish」序列，断言 `answerText` 只含第一段，`answerDeltas` 无第二段，且没有 `replace:true` 的清空事件。 + +### 4.2 BUG-585：正文剪问句 +- `collect-prompt.ts` 新增 `stripQuestionSentences(body, stem)`（复用 `composeCollectSpokenAssistantText` 的切句与前缀规则 + 问号规则），`composeCollectSpokenAssistantText` 内部改调它，行为对拒答句路径不变（既有 `rectification-collect-prompt.test.ts` 全部保持）。 +- `agent-run.ts`：流结束、`answer.composed` 之前，读本轮 focus（`loadV9CaseDossier` 已在 `discriminatorInvariant` 里做过，复用那次读取，不加第二次 RPC）；`askedTurnId === turnId` 且 schema 里有 spokenPrompt → 剪；剪空 → `collectHandoff`；变化时 `emitVisibleSpoken(stripped)`（它自会发 `replace:true`）。 +- `turn-question.ts::attachQuestionsToTurns` 同样改调 `stripQuestionSentences`，让历史消息回看也干净（老数据不迁移）。 +- 验收：单元——(a) 正文「…范围收在 05:00–05:10。你大概哪一年搬过家？有年份就行。」+ 题干「你大概是哪一年搬的家？」→ 剪成「…范围收在 05:00–05:10。」；(b) 正文中段逐字含题干 → 剪掉那句，前后句保留；(c) 正文只有问句 → `collectHandoff`；(d) 无本轮 focus → 原样。合同——`agent-voice-copy-contract` 增加「有 focus 的已结算助手正文不得以『？』结尾的句子出现」（对 `docs/testing` 之外的夹具跑）。 + +### 4.3 记录 +- `docs/BUG_HISTORY.md` BUG-584（关联 BUG-533：其修复放行了第二段）、BUG-585（复发自 BUG-488：防线只在提示词；关联 BUG-461、BUG-471、`d9404976`）；`CHANGELOG.md` 一条；`PROGRESS-rectification-duplicate-narration-20260907.md`；`docs/testing/rectification-scenarios-20260907.md` 加一条「每轮助手气泡只有一段旁白，题干只在问题块出现一次」。 + +## 5. 让步顺序 + +4.2 是用户直接看到的"两遍题"，先做；4.1 次之；决策 3（半句不丢）可后置为 P3 但要在进度记录里写明；4.3 不可省。 + +## 6. 开工前置命令 + +```bash +git fetch origin --prune +git worktree add -b codex/rectification-duplicate-narration-20260907 .worktrees/rectification-duplicate-narration-20260907 origin/staging +cd .worktrees/rectification-duplicate-narration-20260907 +ln -s /workspace/Jyotisha/frontend/node_modules frontend/node_modules +cd frontend && ./node_modules/.bin/tsc --noEmit; npm run lint 2>&1 | tail -1 +ls tests/rectification-*.test.ts tests/agent-voice-copy-contract.test.ts | grep -v database | xargs npx tsx --test 2>&1 | grep -E "^# (tests|pass|fail)" +``` + +开工时 tsc 若仍报 `rectification-agentic-chat.tsx` L1655（BUG-583），先确认 `codex/rectification-range-delivery-fix-20260907` 是否已合入；未合入则本单不修它，进度记录里写清基线含该错。