№ · 任务清单
CH.06.30
2026-06-29-onboarding-flow-stability
⟦tag:v2|task|2026-06-29-onboarding-flow-stability⟧
kind: task
id: 2026-06-29-onboarding-flow-stability
objective: 梳理新加入新手流程的入口、状态与持久化边界,修复按钮点击黑屏等逻辑 bug,并确认新手流程不会异常重复执行。
scope: src/App.tsx, src/utils/onboardingSteps.ts, src/components/welcome/**;若证据需要,才允许最小触碰 src/utils/accountProfileStorage.ts, src/utils/playthroughSlots.ts, src/utils/playthroughStorage.ts, src/utils/playthroughRuntimeBridge.ts
acceptance:
- 当前可复现的新手流程相关按钮黑屏 / 空白态 / 无响应路径被定位并修复,或给出精确 blocker
- 新手流程状态存档位置、重入边界与重置条件明确;刷新 / 继续 / 重开 / 换档 / 切号后的重复执行问题被校正或明确收口
- 不扩
红点设计、不扩道具模块、不把任务扩成整套账号系统 npm run build通过 current state: verified blockers: none next action: none; task verified from code + build + targeted browser acceptance
summary:
- 本卡由 2026-06-29 新增 truth source 直接从候选态提升为执行态,当前只收新手流程稳定性与持久化边界。
- 优先排查
WelcomeGate、onboarding steps、welcome modals 与本地持久化 key,不扩其它新业务线。 - 2026-06-30 监督复核确认:前一日短工线程已结束,但
loginFlowIntent清理闭环与 onboarding / first-run guide 的按profile + slot作用域隔离尚未验收完成,因此按短工日结规则重开新短工续修,不把 2026-06-29 session 继续保留为在途会话。 - 2026-06-30 当前轮已完成最小闭环:缺失 helper 已补,作用域 key 已落地,welcome 确认层/slot picker 叠层问题已修,且
重开 -> 进游戏 -> 刷新回 welcome -> 继续 -> 换档浏览器定向验收通过,因此本 task 收为verified。