№ · 任务清单
CH.06.30
2026-06-30-onboarding-flow-system-audit
⟦tag:v2|task|2026-06-30-onboarding-flow-system-audit⟧
kind: task
id: 2026-06-30-onboarding-flow-system-audit
objective: 对新加入的新手流程做一轮系统排查与最小修复,重点收按钮黑屏 / 空白 / 无响应、welcome 入口跳转异常、onboarding 状态存档边界,以及刷新 / 继续 / 重开 / 换档 / 切号后的异常重复执行。
scope: src/App.tsx, src/components/welcome/**, src/components/OnboardingCoach.tsx, src/components/tips/FirstRunGuide.tsx, src/utils/onboardingSteps.ts;只有 evidence 需要时,才允许最小触碰 src/utils/accountProfileStorage.ts, src/utils/playthroughSlots.ts, src/utils/playthroughStorage.ts, src/utils/playthroughRuntimeBridge.ts
acceptance:
- 当前可复现的新手流程相关黑屏 / 空白 / 无响应路径被定位并修复,或给出精确 blocker
- onboarding / first-run / welcome intent 的存档 key、作用域、重置条件与读取顺序明确
- 刷新 / 继续 / 重开 / 换档 / 切号后的重复执行边界被校正,或给出精确 residual risk
- 不扩
红点设计、不扩道具模块、不扩账号系统 / 主线系统 cmd /c npm run build通过- 如运行态可用,补最小 click-path 验收:
welcome -> start/continue/restart -> onboarding next/skip -> refresh -> switch slotcurrent state: verified blockers: none next action: archive with⟦tag:v2|session|2026-06-30-onboarding-flow-system-audit-01⟧; only reopen if fresh runtime regression appears or a new truth source explicitly要求补switch-slot / switch-account / restart的跨槽跨账号重复执行矩阵。
summary:
- 这是基于 2026-06-30 新 direct truth source 新开的短工 lane,不续写已
verified的⟦tag:v2|task|2026-06-30-onboarding-flow-stability⟧。 - 旧 lane 只保留历史最小修复结论;本轮重点是系统性复核与运行态残留排查。
- 当前 acceptance 已满足:主故障链
重开 -> 选空槽 -> 仪式/按手印 -> 回 welcome 且 slot 仍为空未再复现;旧槽位 skip onboarding -> 新槽位 restart的 staledismissed风险补核通过;cmd /c npm run build已再次通过。