Jyotisha/docs/tasks/PROGRESS-rectification-opening-plain-20260926.md

# PROGRESS · 生时校正开场改大白话 + 步骤回执去重（2026-09-26）

- 模式：直接执行（产品授权 subagent 实现；无单独任务书，决策 D1/D2 由 Claude 转述）
- 基线：`origin/staging` `e53052a2`
- 分支 / worktree：`codex/rectification-opening-plain-20260926` / `.worktrees/rectification-opening-plain-20260926`（本地提交，未推）
- BUG：BUG-1049（开场无例子 + 行话，复发自 BUG-504）、BUG-1050（步骤回执内部名 + 重复）
- Skill：10.0.30 → 10.0.31

## 诊断核对

Claude 的诊断成立，补充两点：

1. 例子丢失是两步叠加：`aa7ccb30`（09-09，BUG-604）把例子从 `GENERIC_COLLECT_QUESTION` 挪进正文第三句，同时把 BUG-504 的断言改成反向（题干**不含**「比如」）；`dd8f35f7`（09-11，BUG-646～648）把第三句改写成以题干前 12 个字开头，BUG-585 的前缀去重（`4e0db55f` 起）因此把它删掉。09-11 起刷新路径看不到例子，BUG-1045（`e4c1c7a3`）后实时路径也看不到。BUG-504 的测试没拦住，是因为它被 BUG-604 有意改反了，而接替它的正文检查只测正文字符串，没有走 GET 组装 / 客户端合并。
2. 模型写的开场正文在服务端也先被同一去重剥掉例子句 → 不满足「至少五类」→ 换兜底正文。所以真机看到的是兜底正文去掉第三句，而不是模型的原话。
3. 步骤重复：持久化回执按工具去重，但实时轨迹每次调用一行，结算后保留实时轨迹；「已完成 3 步」数的是调用次数。刷新后才变两行。

## 决策落地

| 决策 | 实现 |
| --- | --- |
| D1 正文 | `openingSpokenBody`：两句，逐字按产品文案；无窗口时省掉「现在先在…之间找」。`buildOpeningBrief` 与 `agentic-rectification.ts` 开场说明同一意思。模型正文验收 `isAcceptableOpeningBody(body, range)`：须含「星盘」「年月」与窗口两端，≤3 句，无问号 / 年份 / 行话（`OPENING_BODY_JARGON`：大运、盘面、分盘、代表分钟、精确到秒、候选、区间、Dasha），最多提 2 个例子；否则换兜底。 |
| D1 题干 | `GENERIC_COLLECT_QUESTION` 逐字按产品文案（74 字，低于 `SPOKEN_PROMPT_MAX` 120）。**新增**：零证据开场题干由服务端固定——`rectification-set-focus` 仍校验模型的 `spokenPrompt`（坏调用照旧失败、照旧计数，BUG-586 的「两次无效不落库」不变），校验通过后存 `GENERIC_COLLECT_QUESTION`，不存模型改写。判定抽成 `isOpeningCollectFollowup`（与 `spokenFollowupForUser` 原 `openingOther` 条件相同）。理由：只靠提示词让模型照抄题干，例子迟早会被改写掉，这正是 BUG-504 这一类的防线。brief 因此改成「spokenPrompt 写『先说一两件你记得的大事』即可，题干由服务端固定」，brief 本身仍不含年份（既有断言）。 |
| D1 题干其他用途 | `GENERIC_COLLECT_QUESTION` 只在零证据开场使用（`spokenFollowupForUser` 的 `openingOther` 分支）；另两处是文案清单 `listUserVisibleCopy` 与事故回放夹具 `accidentCaseHardcodedTurns.openingCollect`，都代表开场。无需拆分。 |
| D1 年份 | 示例回答里的 2015 只在题干；正文仍禁止年份（`OPENING_YEAR` 只作用于正文）；题干没有年份校验路径（`validateSpokenPrompt` 的年份校验只对 `choice_frame` 题）。「不得用生日推年份」不受影响，Skill 里注明示例年份是固定文案。 |
| D1 去重 | `isQuestionSentence`：正文句与题干整体或题干任一句相同（去空白、句末标点），或字符二元组 Dice ≥ 0.8（`STEM_NEAR_EQUAL_THRESHOLD`）才算复述；以问号结尾照旧删除；删去 12 字前缀规则。BUG-584/585/1045 相关测试全部照旧通过。 |
| D1 范围句 | 开场不再说「最后给区间和代表分钟，不给精确到秒」。检查过：VOICE / DESIGN 没有要求开场必须说；Skill §4 原来要求（已改）；交付卡 `REPRESENTATIVE_MINUTE_DISCLAIMER` 未动。 |
| D2 标签 | `rectification-activity-labels.ts` 十四个完成名、十四个进行中句、六个点选活动句全部改大白话（对照表在 VOICE「生时校正开场与步骤名」）。进行中句复用 BUG-1047 已批准的三句。慢步骤句改为「还在 + 进行中句」（原先拼接完成名，改成过去式后读不通）。 |
| D2 去重 | `rectificationTimelineRows` 对已完成步骤按显示名去重（保留第一行；进行中、失败行不动），`rectificationCompletedTrail` 同样去重。失败行改为「进行中句去掉『正在…』+ 未完成」（「重新对照盘面未完成」），避免「重新对照了盘面未完成」。BUG-1047 阶段句逻辑未动。 |

## 改动的既有断言（均带原值 / 新值 / 原因注释）

- `agent-voice-copy-contract.test.ts`「opening body lists domains…」：正文 ≥5 例子 → ≤2 且六个例子都在题干；正文含范围句 → 不含范围句与行话；题干不含「比如」→ 新题干逐字、含「比如」「例如」。
- `rectification-server-focus.test.ts`：题干匹配 /先说你最容易想起的一两件/ → /先说一两件你记得的大事，比如/；「GENERIC_COLLECT_QUESTION invites…」逐字与源码锁改为新题干，年份断言由「无年份」改为「唯一年份是示例里的 2015」。
- `rectification-v9-agent.test.ts` brief 断言：旧题干 → brief 写明题干服务端固定、两句正文、不重复例子、不含范围句与旧题干（仍不含年份）。
- `agent-activity-progress.test.ts`、`rectification-adopt-flow-20260902.test.ts`、`rectification-agentic-entry.test.ts`、`rectification-timeline-adapter.test.ts`、`rectification-latency-20260926.test.tsx`：旧步骤名 → 新步骤名（后两处另加断言，不弱化）。
- 版本号：`skill-registry.test.ts`（sha `51a91251…13c1`）与 16 个测试文件里的 `10.0.30` → `10.0.31`（18 处字面量 + 4 处 `version:` 正则）。遥测夹具里的 `10.0.30` 是任意样例值、不绑定当前版本，未改。

## 新增测试

- `frontend/tests/rectification-opening-plain-20260926.test.ts`（7 条）：(a) 零证据题干含比如 / 例如 / 六例 / 唯一年份 2015；带日期经历或重问时不用；模型改写 spokenPrompt 时 set-focus 存服务端题干。(b) 服务端拼接、GET 组装、客户端合并三路正文两句都在、题干 1 次；09-26 staging 旧正文例子句在新去重下保留；逐句 / 近似复述仍删。(c) 正文无行话、旧兜底与一句招呼不被接受、窗口不对不被接受。(d) read-case + set-focus×2 → 两行、「已完成 2 步」；共用名字只一行；全部步骤名无内部词。
- `frontend/tests/rectification-opening-plain-20260926.test.tsx`（2 条）：真实 `RectificationAgenticChat` 自动开场（流式 → 结算 → 快照合并），正文与题干各种存法下都只显示一次题干、六例各 1 次、开场这一轮无行话、回执「已完成 2 步」。

修复前验证：把 `e53052a2` 的 `collect-prompt.ts` 单独取出实跑，旧兜底正文 + 旧题干经 `stripQuestionSentences` 的输出恰好是真机看到的两句（例子句被删），与真机一致。另两项按代码推断、未在旧代码上实跑：旧 set-focus 直接存模型的 `spokenPrompt`（`withSpokenPrompt(…, spoken.prompt)`）；旧 `rectificationTimelineRows` 逐条映射实时轨迹，read-case + set-focus×2 得三行「已完成 3 步」。

## 验证（Node 22.14，`/exec-daemon`）

| 项 | 结果 |
| --- | --- |
| `tsc --noEmit` | 0 错 |
| `npm run lint` | 0 error，128 warning（与基线同一批文件、同数） |
| `npm test` | 4054 tests / 4002 pass / 24 fail / 28 skip；基线 4045 / 3992 / 25 / 28。失败名单 0 新增；基线的「Gitea quality gate validates before publishing an immutable ACR manifest」在本分支通过（`e53052a2` 恢复了 upload-artifact 文件，基线日志取自其前）；24 条均为 Docker/DB。测试名 0 消失、9 条新增 |
| Python 门禁集 | 948 passed / 1 skipped |
| `npm run build -- --webpack` | `/` ○ Static；rootMainFiles gzip 130933 B（基线 130933，0%） |
| 浏览器 | `next start` + Chrome 无头 + CDP 虚构接口，自动开场：题干 1 次、正文两句各 1 次、「已完成 2 步」、行「看了你的资料」「准备好下一个问题」、开场这一轮无行话；截图 `docs/testing/rectification-opening-plain-20260926/`（390 / 1280，收起 / 展开） |

## 环境缺口

- 无登录态真机、无模型凭据：模型实际写出的开场正文是否通过新验收（否则用兜底）、真实开场的步骤序列，留给 `docs/testing/rectification-opening-plain-20260926.md`。
- 未推送、未部署。

## 验收（Claude，2026-09-26）

独立复跑（Node 22.14，基于 `e53052a2`）：tsc 0；lint 0 error；`npm test` 4054 / 24 fail / 28 skip，对照 `cs-test.log`（4045 / 25）失败名单仅少一条（「Gitea quality gate validates before publishing an immutable ACR manifest」因 e53052a2 恢复 vendored 文件转绿），无新增失败、无消失测试名；Python 门禁集退出 0；`/` ○ Static，rootMainFiles gzip 130933 B（±0%）；提交无删除、未碰 `.gitea/`、`vendor/`。截图核对：开场正文两句大白话、题目带六个例子和答法示例且只出现一次、步骤栏「已完成 2 步：看了你的资料 / 准备好下一个问题」。真实模型开场通过率待真机清单。