Jyotisha/PROGRESS-home-split-batch2-20260901.md

# PROGRESS · 拆分首页巨石组件·第二批：聊天主链路（2026-09-01）

工作树：`.worktrees/contract-repairs-20260901`  
分支：`codex/contract-repairs-20260901`  
基线：小刀轮未推送，故未另开 `codex/home-split-batch2-20260901`；产品代码从 `a6148af8` + 小刀轮改动继续。

不要写成 `PROGRESS.md`。交付为快进推 `origin/staging`。

React Compiler 仍关（`BLOCKED.md` 2026-08-17）。未引入 context/store。无手写 `useCallback`/`useMemo`。自定义 hook 按任务书决策记录 1 允许。`site-styles` import 仍在 `page.tsx` 顶。`const BirthTimeRectification = dynamic(...)` 未动。

## 度量

| 项 | 拆前（第一批后 3505 / 小刀后约 3510） | 拆后 | 说明 |
| --- | ---: | ---: | --- |
| `frontend/src/app/page.tsx` 行数 | 3505 | 2445 | 目标 ≤2600，达标 |
| `useState(` Home / session hook / consult hook | 26 / — / — | 26 / 0 / 0 | 独占 state 未下移，见 hook 顺序 |
| `useRef(` Home / session / consult | 19 / — / — | 19 / 0 / 0 | 同上 |
| `useEffect(` Home / session / consult | 20 / — / — | 20 / 0 / 0 | 拉取/恢复 effect 仍在 Home |
| `/` 路由 | `○ Static` | `○ Static` | webpack `next build --webpack` |
| 首屏 JS gzip -9 | 第一批后 501315 B | 501104 B = 489.4 KB | −211 B / **−0.04%**（±2% 内） |
| 前端测试 | 小刀后 2428 | 2428 | 见验证 |

剩余未达标块（第三批）：onboarding/profile（`refreshAccount`…`signOut`）、rectification 胶水（`refreshRectificationEntrySummary`…`handleRectificationMessagesChange`）、合盘草稿、composer `submit`。

## Hook 调用顺序（红线 1）

搬前 `Home` 内真正的 React hook 序列（`a6148af8`）：

`useRouter` → `useState`×26 → `useRef`×19 → `useBirthTimeGuidedJourney` → `useEffect`×8 → `useConversationScrollAnchor` → `useEffect`×12

咨询/会话的 `useState`/`useRef` **不是连续块**：中间夹着校正会话、引导草稿、星盘库、合盘等。若只把「引擎独占」的那几项抠进 hook，会改变 `Home` 里 hook 的相对次序。

因此本轮两个新 hook **内部零 `useState`/`useRef`/`useEffect`**，只搬函数体与 `.current =` 赋值。串接后 `useState`/`useRef`/`useEffect` 次序与搬前逐一相同；新增的只是两个无内部 hook 的调用点：

| 调用点 | 位置 | 原因 |
| --- | --- | --- |
| `useSessionManagement(...)` | `useBirthTimeGuidedJourney` 之后、**第一条 `useEffect` 之前** | 紧随其后的 effect 调用 `ensureSessionMessages` |
| `useConsultationRun(...)` | `useConversationScrollAnchor` 之后、其余 `useEffect` 之前 | `send` 需要 `conversationAnchor.anchorToLatest()` |

依赖方向：session hook 先返回 `persistSession` / `updateSession` / `startNewChat` / `continueInNewChat`，由 Home 传入 consult hook。两文件 **不得、也没有** 互相 import。

`setDraft` / `setDraftTheme` / `setDraftEntrypoint` / `refreshAccount` / `openAccountDialog` / `openRectificationFromHomepage` / `openRectificationSession` 仍是 `Home` 内 **function declaration**（JS 提升），所以可以出现在 hook 调用点之上的参数列表里。这不是 React hook 顺序问题。

核对方式：对 `export default function Home` 之后的 `useRouter|useState|useRef|useEffect|useBirthTimeGuidedJourney|useConversationScrollAnchor|useSessionManagement|useConsultationRun` 计数；两 hook 文件内上述符号计数为 0。

## 任务 1–2 · 搬家

新文件（函数体与 `a6148af8` 的 `page.tsx` 逐行一致；允许差异仅缩进、`export`、经参数/返回值改道的标识符。popstate 以小刀轮为准，不回退到 `a6148af8`）：

| 文件 | 行 | 内容 |
| --- | ---: | --- |
| `frontend/src/hooks/use-session-management.ts` | 443 | `updateSession` … `selectSessionModel` + 小刀修过的 `applySessionPopStateRef.current` |
| `frontend/src/hooks/use-consultation-run.ts` | 1073 | `restoreConsultationRecovery` + recovery/replay 赋值、`requestCancellation` / `confirmCancellation` / `stopResponse` / `completeConsultationInterface` / `send` / `regenerateLatestAnswer` |

函数体公证（对 `a6148af8` 去缩进后逐行）：

`updateSession` 3、`persistSession` 25、`ensureSessionMessages` 24、`continueInNewChat` 7、`renameSession` 11、`deleteSession` 20、`togglePinnedSession` 10、`toggleArchivedSession` 22、`shareSession` 28、`startNewChat` 33、`startConsultationAfterRectification` 5、`selectSession` 28、`selectSessionModel` 52、`restoreConsultationRecovery` 53、`requestCancellation` 27、`confirmCancellation` 19、`stopResponse` 129、`completeConsultationInterface` 9、`send` 567、`regenerateLatestAnswer` 23；`consultationRecoveryCheck.current` / `consultationReplay.current` 赋值块亦相同。

改名清单：**零**（无业务标识符重命名）。

`applySessionPopStateRef` 相对 `a6148af8` 的差异即小刀轮任务 3，原样搬进 session hook。

## 合同测试路径（同一 token，只换读取面）

拼接件 `frontend/tests/home-surface.ts` / Python `_home_surface()`：第一批文件 + 可选 `use-session-management.ts` / `use-consultation-run.ts`（`existsSync` / `Path.exists()`）。hook 落地后自动拼进。

| 测试 | 原路径 | 新路径 |
| --- | --- | --- |
| `sidebar-contract.test.ts`「keeps the page session selection callback…」 | `page.tsx` 正则 `selectSession` | `homeSurface`（函数已搬走；断言内容未改） |
| `consultation-birth-time-mode.test.ts` homepage `consultationMode:` | `page.tsx` | `homeSurface`（token 在 `send`） |
| `tests/test_supabase_user_data_contract.py` | 已是 `_home_surface()` | 可选 hook 列入清单（`persistSession(completedSession)` 等在 consult hook） |
| `rectification-agentic-entry.test.ts` refreshAccount 切片 | `function updateSession` 作终点 | `function openAccountDialog`（`updateSession` 已搬走；若终点落在拼接后的 hook 文件，切片会吞进仍留在 page 的 `persistProfile`/`setProfileDraft`。断言内容未改） |
| `profile-state.test.ts` 同一切片 | 同上 | 同上（该文件仍只读 `page.tsx`，终点改为仍相邻的 `openAccountDialog`） |
| `chat-stream-layout.test.ts` 活动/ndjson/`regenerateLatestAnswer` | `page.tsx` | `homeSurface`（token 在 `send` / consult hook） |
| `evidence-audit-panel.test.ts` workflow receipt headers | `page.tsx` | `homeSurface` |
| `chat-notice-and-scroll-contract.test.ts` send 切片 | `page.tsx` 的 `updateSession(sessionId, () => userSession)` | `homeSurface`（仅该条；JSX/poll 仍读 `page.tsx`） |

其余已走 `homeSurface` 的聊天主链路测试（`chat-session-url` / `consultation-recovery` / `consultation-entrypoint` / `composer-isolation` / `chat-session-authority` 等）无需再改：切片标记仍在 hook 文件内且相邻。

锁 JSX/仍留在 `page.tsx` 的测试继续只读 `page.tsx`（`site-style-isolation`、`rectification-lazy-loading`、`chat-notice-and-scroll` 的 poll timer、profile/onboarding 等）。

小刀轮两个 Python 文件保持全绿（见小刀 PROGRESS）。

## 验证

- `./node_modules/.bin/tsc --noEmit`：通过。
- 聚焦合同：`consultation-recovery` / `chat-session-*` / `composer-isolation` / `consultation-entrypoint` / `starter-questions` / `chat-navigation-a11y` / `settings-mvp` / `sidebar-contract` / `consultation-birth-time-mode` / `rectification-agentic-entry` / `profile-state` 全绿。
- 全量 `npm test`：2428 pass / 0 fail / 0 skipped。
- `./node_modules/.bin/next build --webpack`：`┌ ○ /` Static。首屏 JS gzip-9 501104 B vs 第一批后 501315 B（−211 B / −0.04%）。
- 行为抽查：无登录态浏览器点选会话 / 发送咨询。由合同测试覆盖抽取正确性；popstate 行为变化已在小刀轮用源码合同锁住。

未改 `.gitea/workflows/**`。未动数据库。未提升 `main`。未重开 React Compiler。

## 明确未做

- onboarding/profile 簇与 rectification 胶水（第三批）。
- 未把 streaming/pending 等 state 下移进 hook（为保住 hook 顺序）。
- 未修任何行为（popstate 已在小刀轮完成）。