Jyotisha/docs/tasks/PROGRESS-home-landing-blank-20260927.md

PROGRESS · 登录后 / 裸 / 落空白首页，删除登录返回存根（BUG-1052）· 2026-09-27

• 执行方式：直接执行（产品负责人授权子代理执行；Claude 事后独立验收）
• 基线：origin/staging 5f2e007f 开工；提交前变基到 76924e33（只多一份任务书文档，代码与测试结果不变）
• 分支：codex/home-landing-blank-20260927（本地提交，未推送）
• BUG 编号：1052（开工时最大号 1051）
• 决策：产品 2026-09-27 D1–D4，推翻 BUG-1038 登录返回存根与「裸 / 默认落最近会话」，写在 docs/BUG_HISTORY.md BUG-1052 决策记录

结论

项	结果
根因	与任务单诊断一致：① 登录返回存根（401 / 侧栏次级页与「去登录」链接写入，登录后 replace-selected 写回 ?c= 并打开）——真机「落在旧校正里」只能来自这条；② 默认落点取最近一条，只从生时校正换到「空咨询或任意咨询」，所以裸 / 通常开最近一条旧咨询。暖返回逐条镜像。补充：旧空咨询判定只看 messages.length，未加载消息的列表行也会被当草稿，已收紧
D1 裸 / → 空白首页	完成。none / replace-clear 只复用当前人物的空草稿（isStarterHomeDraft），否则本地新建；冷启动用 replaceUnsavedEmptyConsultations 前插不留重复；暖返回同一套函数
D2 ?c= / ?new=1	不变，有生命周期用例锁住
D3 删除存根	完成。删 persistLoginSessionReturn / readLoginSessionReturn、storedReturnId、clearStoredReturn、replace-selected、lookup 来源参数与 other-subject、暖返回 resumeRectification 依赖；redirectToLogin / leaveChat 不写、startNewChat / openChatBoundToProfile 不清；冷启动无条件 clearLoginSessionReturn() 清旧值。人物范围：空白首页绑定当前人物、只复用本人草稿
D4 对话内刷新	核实成立（URL 带 ?c= → keep），生命周期用例 + Chrome 截图
执行方解读（待验收确认）	裸 / 时若有旧回答在后台生成：恢复继续，但不抢空白首页（landingYieldsToRecovery：只有 keep / lookup 让步），与 BUG-1015 ?new=1 同规则
未改	站内浏览器「返回」退到不带 ?c= 的历史条目（popstate）仍选列表第一条非校正会话；不是整页打开 /，不在 D1 列举内

改动文件

文件	改动
frontend/src/lib/chat-session-url.ts	选择函数去存根；lookup 结果只剩 found / missing / unavailable；删写 / 读存根，保留清理
frontend/src/lib/home-bootstrap.ts	isStarterHomeDraft、新落点规则、landingYieldsToRecovery；LandingSession 加可选 messagesHydrated / archivedAt
frontend/src/lib/home-bootstrap-run.ts	冷落点按当前人物范围、去重前插、无条件清旧存根、恢复让步规则；暖提交删存根分支与 resumeRectification
frontend/src/lib/home-warm-start.ts	去 storedReturnId 与存根分支
frontend/src/lib/home-cloud-sync.ts	redirectToLogin 不写存根；resolveLookupBootstrap 去存根来源
frontend/src/components/app-sidebar.tsx	leaveChat 只关抽屉
frontend/src/hooks/use-session-management.ts	新建对话不再清存根
frontend/src/app/(app)/page.tsx	删暖刷新的 resumeRectification 一行（1370 → 1369 行；Home() useState 33 / useRef 37 不变）

改动的既有断言（原值 / 新值 / 原因均已写在测试行内注释）

文件	用例（原标题 → 新标题）	摘要
chat-session-url.test.ts	new chat intent overrides … plus login return → … invalid c	去 storedReturnId / clearStoredReturn
同上	new chat bootstrap consumes the URL …	clearStoredReturn 条件清 → 无条件清；直接前插 → replaceUnsavedEmptyConsultations
同上	bootstrap reads a listed ?c= session and ignores login storage → bootstrap reads a listed ?c= session	去存根字段
同上	bootstrap restores a stored login return only when the URL has no c → bare / after login never returns to a stored conversation (BUG-1052)	replace-selected → none，源码反向锁
同上	bootstrap clears an illegal or unknown session query	去存根字段（2 处）
同上	default bootstrap selection does not write a session URL	去存根字段；replace-selected 正向 → 反向
同上	401 login redirect stashes the current session id … → 401 login redirect stashes nothing …	正向 persistLoginSessionReturn → 反向
同上	login return storage only accepts a UUID session id → a leftover login-return stash from an older build is only ever cleared	写 / 读 → 只清、隐私模式不抛
chat-navigation-a11y-contract.test.ts	auth redirects stay hard document loads …	persistLoginSessionReturn();\n replace → clearHomeWarmSnapshot();\n replace + 反向
sidebar-contract.test.ts	reaches chart, ephemeris and reports with links …	leaveChat 先存根 → 只关抽屉 + 反向
home-bootstrap-reveal.test.ts	default landing replaces a latest rectification session …	replace-selected → lookup；none 选普通咨询 → 选空草稿
同上	bare home still opens the selected ordinary chat without creating another → bare home with a latest ordinary chat lands on a new blank starter home (BUG-1052)	NeedsConsultation false → true
session-lookup-unlisted.test.ts	lookup results …	去 clearStoredReturn
同上	a looked-up stashed return writes its URL back … → only a ?c= is ever looked up … (BUG-1052)	来源参数删除，源码反向锁
home-warm-snapshot.test.ts	warm landing follows the cold rules: ?c= keeps, stash writes back, … → … bare / is the blank starter home, ?new=1 is a new chat	bare CONS → 新建空对话；新增复用本人草稿 / 不复用他人草稿
new-chat-recovery.test.ts	ordinary home landing still activates and announces … → bare / keeps the blank starter home while … recovers (BUG-1052)	active 旧会话 → 空白首页、notice 清空、storedCleared true；另加 ?c= 仍被接管
new-chat-from-people-lifecycle.test.tsx	侧栏新建对话 ×5、他人存根不落锁死页	离开时存根 RECT → null（落点断言不变）
同上	a stashed session of the same person found beyond the first page opens … → a leftover stash … is ignored and cleared … (BUG-1052)	打开校正并写回 ?c= → 空白首页、不 lookup、清旧值
同上	an in-page new chat drops the stashed return … → an in-page new chat leaves no return trail …	不预置存根，断言新建不写
home-warm-return-lifecycle.test.tsx	a stashed return to a rectification session reopens it … → a warm return to bare / after a rectification session lands on the blank starter home …	写回 ?c= 打开校正 → 空白首页、首帧无加载环
fixtures（非断言）	home-bootstrap-run / session-list-lifecycle / consultation-recovery / new-chat-recovery / home-warm-snapshot	去掉 selection 里的 clearStoredReturn 字段

新增：生命周期 5 条（裸 / 最近普通咨询 / 最近生时校正、?c= + 刷新、校正内刷新、校正内 401 → 重登）、暖返回冷启动裸 / 1 条、纯函数 2 条（未加载消息的行不算草稿、恢复让步规则）、?c= 恢复接管 1 条。改写与新增的生命周期用例放到 origin/staging 代码上跑：12 条失败（?c= 与刷新两条本就应通过，作 D2 / D4 护栏）；修复后全绿。

验证

项	结果
tsc --noEmit	0 错
npm run lint	0 error（128 warning，改动文件无新增与本单标识符相关的 warning）
全量 npm test（Node 22.14）	4078 / 24 fail / 28 skip；基线 4069 / 24 / 28。失败名单与基线逐条一致（全部 Docker/DB）；消失的 12 个用例名全部是改名，三栏说明在行内，新增 21 个名
Python 门禁集合	948 passed / 1 skipped（与基线一致）
npm run build -- --webpack	/、/chart、/ephemeris、/people 均 ○ Static；已删构建产生的 frontend/frontend/
首屏 gzip（rootMainFiles 4 个文件 zlib 默认级别求和）	131,253 B；基线 130,933 B，+0.24%，在 ±2% 内
定向 13 个文件	167 / 0 fail

本地 Chrome（headless，CDP 拦截 /api/* 返回虚构数据）

next start（本单构建）+ Chrome --headless=new，截图在 docs/testing/home-landing-blank-20260927/：

截图	场景	结果
1-bare-latest-rectification.png	列表 = [生时校正（最近）, 普通咨询]，打开 /	空白首页「新对话」、地址 /、无转录、未开校正
2-bare-latest-consultation.png	列表 = [普通咨询（最近，有消息）, 生时校正]，打开 /	空白首页
3-bare-leftover-stash.png	sessionStorage 预置旧存根 = 校正会话，打开 /	空白首页，存根被清
4-c-link-consultation.png	打开 /?c=<咨询>	进该对话、有问答
5-c-link-rectification.png	打开 /?c=<校正>	进校正界面
6-refresh-in-rectification.png	在 5 上刷新	仍在校正界面、地址不变

POST /api/rectification/cases/open 共 2 次，只出现在 5 / 6。右下角「合盘历史暂时无法读取」提示是本 harness 未 mock /api/synastry-reports（404）所致，与本单无关。

环境缺口

• 无受控登录账号：真实邮箱验证码登录、真实 401 过期后重登、iPhone Safari 走查留给 docs/testing/home-landing-blank-20260927.md。
• 无 Docker：24 条 DB/部署测试失败，与基线名单逐条一致。

验收（Claude，2026-09-27）

独立复跑（Node 22.14，基于 76924e33）：tsc 0；lint 0 error；npm test 4078 / 24 fail / 28 skip，失败名单与基线 ct-test.log（4069 / 24）逐条一致；12 个测试改名均有三栏说明；Python 门禁集退出 0；/、/chart、/ephemeris、/people ○ Static；rootMainFiles gzip（level 9）130933 B，±0%。提交无删除、未碰 .gitea/、vendor/、deploy/。截图核对：最近一条是生时校正时，裸 / 落在空白首页，侧栏历史仍在。认可两处执行方判断：裸 / 时后台恢复中的旧回答不再抢占首页（与 BUG-1015 ?new=1 同规则）；站内浏览器后退到无 ?c= 的历史项不在本单范围。真实 OTP 登录、401 过期重登、iPhone 走查按清单待产品走。