№ · 任务清单 CH.06.30
主页 · 📃 任务清单 · 2026-06-30-onboarding-flow-regression-audit

2026-06-30-onboarding-flow-regression-audit

📅 2026-06-30 · 📦 2.6 KB · 📃 任务清单 · 📝 MD 文档 🏷️ Buff🏷️ Year1🏷️ 新手🏷️ 时间🏷️ 回归

⟦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 slot current 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 后 FirstRunGuideOnboardingCoach 不再同时出现;cmd /c npm run build 已通过。
  • residual risk 已明确保留:修后未把“关闭首跑说明 -> 完成 onboarding 第 1 步/触发账本 -> 刷新 -> welcome -> 继续”整条链跑完,也未补 switch-slot / restart 的运行态回归矩阵;若后续需要更强运行态闭环,再以新 truth source 重开。