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

2026-06-30-onboarding-flow-system-audit

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

⟦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 slot current 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 的 stale dismissed 风险补核通过;cmd /c npm run build 已再次通过。