docs(rectification): restart note for the surface brief — new baseline 8e214e29, BUG-505+, items superseded by staging
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JUei7K13cYxLHE3Axe4A45
This commit is contained in:
Jesse_Chen
@@ -2,6 +2,20 @@
|
||||
|
||||
基线：**`codex/streaming-ux-20260901`（HEAD `c846c44a`）合入后的 `origin/staging`**。本轮改的文件与那条分支高度重叠（`rectification-agentic-chat.tsx`、`page.tsx`、`globals.css`、`rectification-agentic-entry.test.ts`），**必须在它合入之后开工**。
|
||||
|
||||
## 2026-09-03 重启说明（覆盖上面的基线与部分条目）
|
||||
|
||||
第一次执行（分支 `codex/rectification-ux-20260902` @ `fec000f7`，基于 `4dc0c8c7`）已完成全部条目并经验收，但 staging 随后被其它会话推进 46 个提交（校正问题内嵌、选择卡、采用流、collect 退出等一批 `fix(rectification)`），`rectification-agentic-chat.tsx` 被重写 600+ 行，老分支与之有 5 个文件的内容冲突，**不再 rebase，改为在新基线上重做**。老分支只作参考（`git show fec000f7:<path>` 读，`git diff 4dc0c8c7..fec000f7` 看思路），不要 checkout 它。
|
||||
|
||||
- **新基线**：`origin/staging` @ `8e214e29` 或更新；新分支 `codex/rectification-ux-20260903`。
|
||||
- **BUG 编号从 505 起**（staging 已到 504，开工再确认）。
|
||||
- **已被 staging 解决、本轮删除的条目**：0.3 的"问题槽在对话流内"——`d9404976` 已把每道题内嵌进 assistant 消息，`.rectification-question-slot` 已不存在；不要复活问题槽。0.3 只剩"没有等待快照这一态"（随 0.2 自然成立）。
|
||||
- **部分被解决、只补差额**：1.1 选择卡——`35688015` 已把选中态收进按钮、`d9404976` 加了 `variant="embedded"`；本轮只补 pending 时卡内的 `InlineSpinner` + shimmer「正在记录…」一行，以及选中项的 `Check` 图标（若 staging 已有则跳过并写明）。
|
||||
- **接口变了、按新结构重做**：`send` 现在经 `beginLiveRun(label)` / `rememberLiveActivity(label, tool)` 管 live 行文案；0.5 的 `continuation`（复用同一条 live 行、跳过 busy 守卫）要接进这两个助手，而不是照抄老分支的 `rectificationInitialLiveLabel`。`loadCaseSnapshot` 现在**返回** snapshot（`submitStructuredChoice` 用返回值判断 `willContinue`），保留这个返回。`choiceContinuationPending` + effect 在 staging 仍在，照任务书删除。
|
||||
- **已删除、不得复活**：`onStartConsultation` / consult handoff 按钮（`e8c98c37` 产品决定删除）。0.6 空态的按钮只有「开始提问」。
|
||||
- **仍在 staging 上、本轮照做**：`page.tsx` 的 `-ready/-loading` key；`rectificationCardLabel` 无 loading 分支；「等待服务端更新」两条文案（`showMissingQuestion` / `showUnavailableQuestion` 现在锚在内嵌问题上，四态判定改到那里）；盘面首态文案与收窄；开场 live 文案；402 提示；1.2 用户选择回显（核对 staging 现在怎么渲染持久化的结构化选择 turn，若已回显则跳过并写明）。
|
||||
- **深链 / 刷新 / popstate 对齐**（并入 0.2）：staging 已有两阶段揭幕（`bootstrapPhase: "account" → "prepare"`，`page.tsx` 约 :529–:663）。启动时选中的会话若是校正会话，把 `openRectificationSession` 的 hydration 并入 `prepare` 阶段、揭幕前完成；popstate 回到校正会话时，hydration 完成前不切 `activeSessionId`。4 秒上限常量若 unified-loading 已导出则复用，只留一个。
|
||||
- **老分支里可以直接搬的**（预计无冲突，逐个 `git show fec000f7:<path>` 对照）：`src/lib/rectification-surface-state.ts` 与其 `tests/rectification-surface-state.test.ts`（hydration、四态纯函数、文案常量）、`use-session-management.ts` 的 deferred switch、`starter-home.tsx` / `sidebar-session-row.tsx` 的打开中反馈、`rectification-board.tsx` 首态、DESIGN.md 「Rectification surface」条目（按新状态集合修订）、walkthrough 第 8 节。`tests/rectification-surface-contract.test.ts` 的源码锁要按新结构重写。
|
||||
|
||||
## 与同日其它任务书的关系（先读）
|
||||
|
||||
| 任务书 | 关系 | 结论 |
|
||||
|
||||
Reference in New Issue
Block a user