# PROGRESS · 首页 page.tsx 拆分（2026-09-25）

## 当前结论

T1、T2、T3、T5 完成。T4 让步到 1417 行（允许 ≤1450，未到 ≤1300）。没有新 BUG。没有推 `staging`，没有推 `main`。`?settings=chart` 仍打开星盘资料。

- 工作树：`G:\Ferti\Jyotisha\.worktrees\home-page-split-20260925`
- 分支：`codex/home-page-split-20260925`
- 开工基线：`origin/staging` = `59c23018`（与本分支当时一致）
- 开工后 `origin/staging` 又前进了报告读者版 `3c2f7bd5` 和状态板 `9167d75e`。这两笔不碰首页。本分支没有把它们合进来，也没有快进 `staging`。
- 实现提交在变基到 `9167d75e` 之后是 `da35b3e4`。状态板写这个 SHA。

## 逐项

| 项 | 结果 | 说明 |
| --- | --- | --- |
| T1 | 完成 | `runHomeBootstrap(deps, signal)` 在 `frontend/src/lib/home-bootstrap-run.ts`。内部再拆成 `runAccountPhase` / `resolveLanding`（注入项超过 15）。新文件 0 个 React hook。`Home()` 只留一个 effect 调用它。 |
| T2 | 完成 | `runConsultationRecoveryPoll` 在 `frontend/src/lib/consultation-recovery-poll.ts`。假计时器覆盖 404 第一次只确认、下一次重放一次、第 4 次放弃、reserved 成功把缺失计数清零。 |
| T3 | 完成 | `HomeBootstrapError`、`HomeOnboardingShell`。文案和按钮与拆分前一致。「重试」仍走 `retryHomeBootstrap(...reloadSessionList)`。 |
| T4 | 让步 | `page.tsx` 1417 行（换行计数，与增长合同相同）。目标 ≤1300 未到，任务书允许先到 ≤1450。import 挤行已还原：`^import .*; import ` 对 `page.tsx` 为 0。增长合同 `PAGE_LINE_COUNT_BASELINE` 下调到 1417，上限 1567。`useState` 仍是 34（上限保持 36），`useRef` 仍是 37（上限保持 37），都没有增加。 |
| T5 | 完成 | DESIGN 未改。CHANGELOG 一条「首页内部重构，无用户可见变化」。不新开 BUG。 |

## 还留在 Home() 里的大块

下一步若要压到 1300，还在首页里的是：账户弹窗模型（资料 / 星盘库 / 点数 / 退出）、对话区和 `ChatComposer` 装配、星盘库同步、今日星语、设置深链。设置深链必须留在首页，`query.pane === "chart"` 仍调用 `openAccountDialog("chart-library")`。

## 断言改写

| 原值 | 新值 | 原因 |
| --- | --- | --- |
| `new-chat-recovery.test.ts` 把 page.tsx 激活段和 hook 的 restore 放进 vm，断言 active 等于预置本地会话 | 调用 `runHomeBootstrap`，restore 仍是 hook 里的真实函数；new-chat 会新建空咨询，恢复后仍停在这条新会话 | 激活段已搬进函数。直接调用还覆盖「新建落点与 reserved 恢复共存」，比只跑后半段更强 |
| `consultation-recovery.test.ts` 按 page.tsx 恢复 effect 切片匹配 404 / 重放 / 第 4 次放弃 | 直接调用 `runConsultationRecoveryPoll`；逐步假计时器在 `consultation-recovery-poll.test.ts` | 轮询搬出后，源码切片不再落在 page.tsx |
| 从 page.tsx 切 `storedPending` 分支，并用源码顺序断言它先于全局状态 | 调用 `runHomeBootstrap`：本页 pending 覆盖全局 reserved；无 pending 时不删 key 的反例由「有 pending 且 reserved 则不删 key」锁住。写入 `sessionId/requestId/question` 的 effect 仍留在 page.tsx，继续按该 effect 切片 | 启动流程搬走；优先级改由结果锁定，不弱于源码顺序 |
| `homeSurface` 里预留判断、`window.setTimeout(() => void poll(), 1_750)`、完成后的 `fetchSessionDetail` | 预留判断在 `home-bootstrap-run.ts`；1750ms 和详情读取在 `consultation-recovery-poll.ts`，调用变成 `fetchDetail(deps.pendingSessionId, deps.modelCatalog, signal)` | 两段流程搬出首页。状态端点、间隔、完成后拉详情都还在 |
| `restoreConsultationRecovery(recoverySession, reservedConsultation.requestId, storedPending)` 在 homeSurface | 同一调用在 `home-bootstrap-run.ts` | 启动恢复搬走，仍把 stored pending 交给真实 restore |
| page.tsx 直接调用 `resolveStarterHomeLandingSessionId` / `starterHomeLandingNeedsConsultation`，并引用 `HOME_BOOTSTRAP_SLOW_MS` | 这两个调用和 20 秒预算在 `home-bootstrap-run.ts`；`shouldAutoOpenRectificationSession` 仍在 page.tsx | 落点和超时属于启动流程。揭幕阶段的校正会话判断留在首页 |
| `if (bootstrapFailed) setHydrated(true); else setBootstrapPhase("prepare")` 在 page.tsx | 同一分支在 `runHomeBootstrap`，setter 经 `deps.commit` | 失败仍揭幕错误屏，成功仍进入 prepare，不半揭幕 |
| 错误屏 `<main className="app-loading app-loading-error">` 在 page.tsx | 同一段在 `home-bootstrap-error.tsx`。加载中的 polite main 仍在 page.tsx | 错误屏抽成组件，class 与 `role="alert"` 不变 |
| homeSurface 两处「回答已恢复，已显示在对话区末尾。」 | `use-consultation-run.ts` 与 `consultation-recovery-poll.ts` 各一处 | 轮询搬走，两处文案都还在 |
| page.tsx 里 `clearStaleClientReload(sessionStorage)`，以及从 `loadCloudData` 切登录跳转不关超时 | 首页传入 `storage: sessionStorage`，函数内 `clearStaleClientReload(deps.storage)`；登录跳转的 try/finally 在 `home-bootstrap-run.ts`，仍是 `window.clearTimeout(bootstrapTimeout)` 且 `redirectedToLogin` 时提前 return | 清的仍是会话存储。登录跳转仍不取消 20 秒超时 |
| 从 homeSurface 切 `async function loadCloudData()` | 切 `resolveLanding`。`defaultSessionId` 现为 `ready.nextSessions[0].id` | 落点代码原样搬家。清 new-chat URL 仍在 `setActiveSessionId` 之前，默认落点仍不 `push` |
| 从 page.tsx 切 `if (previewMode)` 到 `await sessionListReady` | 预览分支在 `home-bootstrap-run.ts`，结束锚点是 `await deps.sessionListReady`。首页把 `sessionListReady` / `sessionListBoot` 传进去 | 预览仍不写会话 URL。`/` 仍不在首页里 `fetchSessions` |
| `session-list-provider.test.ts` 匹配 page.tsx 的 `await sessionListReady;` | 匹配首页传入的 `sessionListReady`，以及函数里的 `await deps.sessionListReady` | 会话列表仍只由 provider 拉一次 |

## 验证

开工前，下面四份测试 `npx tsx --test`：**28 pass / 0 fail**。

- `frontend/tests/new-chat-recovery.test.ts`
- `frontend/tests/consultation-recovery.test.ts`
- `frontend/tests/home-shell-growth-contract.test.ts`
- `frontend/tests/home-bootstrap-reveal.test.ts`

改完后同一组，加上本单新测试和会被搬家碰到的合同（`chat-session-url`、`stale-client-recovery`、`chat-navigation-a11y-contract`、`session-list-provider`、`home-bootstrap-run`、`consultation-recovery-poll`、`home-bootstrap-screens`、`settings-url`）：**全部通过，没有新增失败**。最后一次合并跑是 81 pass / 0 fail；补上地点卡文案后又跑了 screens + settings-url，7 pass / 0 fail。增长合同与 `tsc --noEmit` 随后再跑，exit 0。

- `npx tsx --test` 使用明确文件路径。没有用全量 `npm test` 当信号。
- `.\node_modules\.bin\tsc --noEmit`：0 错。
- `npm run lint`：0 error，124 warnings。没有去清原本就未使用的 import，也没有为消 warning 改 effect 依赖。
- `npm run build`：**没有通过**。Turbopack 拒绝本工作树的 `frontend/node_modules` junction（指向主检出，超出它认定的文件系统根）。按约束没有删除或重建这个 junction，也没有 `npm install`。因此不能声称 `/` 仍是 Static，也不能报首屏 gzip。

## 没做的验证

- 没有登录浏览器走首页。本单声称无用户可见变化，靠测试锁行为。
- 没有 `next build`，见上。
- 没有推 `origin/staging`，没有推 `main`，没有改 workflow，没有动 DNS。