№ · 任务清单
CH.06.30
2026-06-30-onboarding-flow-regression-audit
⟦tag:v2|task|2026-06-30-onboarding-flow-regression-audit⟧
kind: task
id: 2026-06-30-onboarding-flow-regression-audit
objective: 对新加入的新手流程做一轮 fresh 回归排查与最小修复,重点收按钮点击黑屏 / 空白 / 无响应、新手流程状态是否存档,以及刷新 / 继续 / 重开 / 换档后的异常重复执行。
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-regression-audit-01⟧; only reopen if fresh runtime regression appears or a new truth source explicitly要求补“关闭首跑说明 -> 账本第 1 步 -> 刷新 -> welcome -> 继续”闭环复核,或补switch-slot / restart作用域切换验证。
summary:
- 这是基于 2026-06-30 新 direct truth source 新开的短工 lane,不续写已
verified的⟦tag:v2|task|2026-06-30-onboarding-flow-system-audit⟧。 - 旧 onboarding 相关 lane 只作为历史证据保留;本轮重点是 fresh 黑屏回归、状态存档边界与重复执行矩阵。
- 当前 acceptance 以“最小修复 + 精确 residual risk”方式收口:
continue主链与确认框未复现真实黑屏;src/App.tsx已补 onboarding 条件态的 scoped 持久化与restart重置;fresh continue 后FirstRunGuide与OnboardingCoach不再同时出现;cmd /c npm run build已通过。 - residual risk 已明确保留:修后未把“关闭首跑说明 -> 完成 onboarding 第 1 步/触发账本 -> 刷新 -> welcome -> 继续”整条链跑完,也未补
switch-slot / restart的运行态回归矩阵;若后续需要更强运行态闭环,再以新 truth source 重开。