6.4 KiB
PROGRESS · 校正会话已结算行记忆化（2026-09-15）
工作树：.worktrees/rectification-settled-render-split-20260915
分支：codex/rectification-settled-render-split-20260915
开工基线：origin/staging @ a8d29d1b（任务书写的 6b3248bf 已被后续合入；以当前 origin/staging 为准）
开工后远端又快进 1 个纯文档提交 11893c7f（普通聊天审计三单），本分支 rebase 到其上。
BUG 编号： 本树最大号仍是 BUG-720。721–724 / 726 未进本树，BUG-725 无冲突，未顺延。
未改 docs/tasks/README.md 状态列。未 git push origin HEAD:staging。未碰 page.tsx、route.ts、Python 引擎、React Compiler、React.lazy。未改 DESIGN.md（无可见样式变化）。未新写第二套输入框 / 滚动跟随 / 加载动画。
改前红 / 改后绿
5.4 结算态 Markdown 解析次数
同一段文本连续 renderToString 两次，可计数桩 renderer：
# 改前（StableMarkdownPrefix 已 export，尚无内容缓存）
not ok 5 - settled markdown parses the same text only once across consecutive renders
Expected values to be strictly equal:
2 !== 1
# 改后（rememberedProse + 结算口语/报告走 StableMarkdownPrefix）
ok 5 - settled markdown parses the same text only once across consecutive renders
# tests 5
# pass 5
# fail 0
5.5 按帧渲染计数
# 改前（行组件文件尚不存在）
Error [ERR_MODULE_NOT_FOUND]: Cannot find module
'.../frontend/src/components/rectification-message-entry.tsx'
not ok 1 - tests\\rectification-settled-render-split.test.ts
# 改后
ok 1 - the chat container no longer derives per-row timeline, varga, or choice cards
ok 2 - the extracted row is memoised and takes no function props except actionsRef
ok 3 - the split architecture renders settled rectification rows once while streaming tokens
# tests 3
# pass 3
# fail 0
手驱动 4 条已结算 + 5 个流式帧：拆分路径 settledRowRenders = 4、streamingRowRenders ≤ 5；未拆分对照 unsplitListRenders = 5、settledRowRenders = 25。拆分计数严格小于对照。
做了什么
| 任务 | 状态 | 落点 |
|---|---|---|
| 5.4 结算态 Markdown 记忆化 | 完成 | chat-message-content.tsx：StableMarkdownPrefix 加按文本解析缓存；结算口语层与报告层都走它 |
5.1 抽出 RectificationMessageEntry + memo |
完成 | 新文件 rectification-message-entry.tsx；时间轴 / varga / choiceCard / afterAnswer 全部在组件内 |
5.2 actionsRef |
完成 | 容器 useEffect 每帧写 .current（与咨询面 page.tsx 相同，避免渲染期写 ref 撞 react-hooks/refs） |
5.3 ChatMessageRow memo |
完成，未砍 | 咨询面同样受益 |
| 5.5 渲染计数断言 | 完成，未砍 | tests/rectification-settled-render-split.test.ts |
| 5.6 BUG-725 | 完成，未砍 | 关联 BUG-473、BUG-249 |
交付卡 / 只读范围仍在容器 messages.map 里（标量 host 判定 + 既有 candidateResult state），不把每帧新建的 JSX 当行 props。
验收命令
| 命令 | 结果 |
|---|---|
./node_modules/.bin/tsc --noEmit |
退出 0，无输出 |
npm run lint |
0 error，119 warning（既有，本单未新增、未顺手修） |
npx tsx --test tests/rectification-*.test.ts tests/home-streaming-render-split.test.ts tests/chat-markdown-split.test.ts tests/stream-frame-buffer.test.ts 及本单改过的合同文件 |
定向套件 fail=0 |
npm test |
3108 条（含本单新增 4 条：结算 Markdown 1 + 行拆分 3）。pass 3021 / fail 73 / skipped 14。失败清单见下，均为环境缺口，不是本单回归 |
npm run build |
默认 Turbopack 因 worktree node_modules junction 指向主仓而 panic（points out of the filesystem root） |
next build --webpack |
Compile + TypeScript 通过（3.7 min + 46 s）。Collecting page data 在 /api/birth-time-guide 因 Windows EPERM 无法为 SKILL.md 建 runtime symlink 而失败。本机看不到 ○ / 路由表。page.tsx / layout.tsx / globals.css 未改，首屏源码差为 0 |
全量失败清单（环境缺口，与本单无关）
Windows、无 Docker、无 Git Bash、skill runtime 不能建 symlink。典型几类：
database-*.test.ts/ 迁移 / RLS / Better Auth：无 Dockerskill-binding/rectification-v9-agent/rectification-v9-stream/rectification-exhaustion-exit等整文件：SkillPackageRegistryErrorEPERM: symlink*.sh/ staging sync / compose env / is-docs-only-range：Windows 无 POSIX shellevery color token used as a Tailwind utility is exposed through @theme：既有 warning 级合同，本单未改 CSS
本单引起、后来已修的合同红（改 token 路径，三栏见各测试注释）：chat-answer-detail、chat-bundle-splitting-contract、rectification-agentic-entry、rectification-spoken-collect、rectification-surface-contract、chat-composer-queue、rectification-adopt-flow、rectification-delivery-ui-simplify、rectification-targeted-card-live、rectification-timeline-adapter、chat-stream-layout、agent-voice-copy-contract、rectification-question-in-message、rectification-varga-style-copy、rectification-walkthrough-polish。修完后这些在定向重跑里全绿。
既有断言三栏（摘要）
| 文件 | 原值 | 新值 | 原因 |
|---|---|---|---|
chat-markdown-split.test.ts |
: renderProse(spoken, renderMarkdown) |
: <StableMarkdownPrefix text={spoken} … /> |
BUG-725 结算口语层记忆化 |
chat-bundle-splitting-contract.test.ts |
renderProse(spoken/report) 计数 2 |
StableMarkdownPrefix 结算两层计数仍为 2；尾块仍 renderProse(split.tail) |
同上，计数不放宽 |
chat-answer-detail.test.ts |
{renderProse(report, renderMarkdown)} |
<StableMarkdownPrefix text={report} … /> |
报告层同样记忆化 |
| 若干校正源码合同 | token 在 rectification-agentic-chat.tsx 的 messages.map |
同一 token 在 rectification-message-entry.tsx |
5.1 抽出行组件 |
真人验收
docs/testing/rectification-settled-render-split-20260915.md。本环境无登录态、无 Chrome，长会话是否还卡未测，不要写成通过。
明确未做
- 把流式文本从
messages搬进独立 state（任务书 §3.4 否决） - React Compiler
- 首屏包体积（584 KB gzip 是全站壳，另议；本单未改首屏源）
- 校正面任何交互缺陷