新内容引导 v1.0 · 活跃设计

整理时间:2026-07-01 18:56 +08:00 整理人:Mavis(PM 视角) 依据:

docs/handoff/sessions/2026-06-30-onboarding-flow-*.md(6.30 新手流程 3 个 verified 收口)

docs/design/active/产品需求总览-v1.md § 1.3(玩家目标)

docs/design/active/Phase1实施切片-v1.md(9 档品质 + 5 类词条)

docs/design/active/联机P2P房间骨架-v1.md(联机房间入口)

docs/design/active/胜利终局-truth-source-v1.md § 2(收束页结构)

docs/plans/backlog/remaining-ui-requirements-2026-06-24.md(UI 引导需求池)

docs/uirefactor/2026-06-24-UI重构资料.md(UI 重构引导) 本文档作用:5 日内 R1 装备 + R3 联机 + R2 胜利收束 3 个新东西的"玩家首次接触"路径,避免新内容上线后玩家不知道 / 不会用。 本版本只拍路径,不算实现:不写引导 UI / 不动 OnboardingCoach.tsx / 不动 tips/FirstRunGuide.tsx / 不动 welcome/**。

0. TL;DR(60 秒版)

3 个新东西 = 9 档品质(R1)+ 联机 P2P 房间(R3)+ 胜利收束页(R2)
每个新东西 都拍 3 件事:触发时机 / 引导形式 / 退出方式
3 种引导形式:轻提示(Tips 弹窗)/ 任务引导(主线任务推进)/ UI 微提示(首屏高亮)
3 个不变量:玩家可跳过引导 / 引导不阻塞主线 / 引导不重复
跟 6.30 onboarding flow 3 个 verified 收口的接续:6.30 收口已实现"OnboardingCoach + FirstRunGuide"主流程;本 v1.0 不改主流程,只新增 3 个新东西的"首次接触"路径
不在本 v1.0:玩家手动关引导 / 引导历史回看 / 多语言引导(留 v1.1)

1. 现状盘点(2026-06-30 onboarding flow 3 verified 收口)

1.1 已有引导组件

1.2 6.30 收口的边界

主流程(开张 / 接待 / 巡夜 / 满月小结)引导已 verified
主菜单进入 + 继续/重玩/换档 + slot 选择已 verified
restart 重置 + scoped 持久化已 verified
残余风险:整条刷新闭环 + switch-slot / restart 矩阵未端到端验

1.3 本 v1.0 的边界

不改 6.30 收口的 OnboardingCoach / FirstRunGuide
不动 Tab 解锁 / 揭幕漂移组件(继续按漂移信号处理)
只新增 3 个新东西的"首次接触"路径

2. 新东西 1:9 档品质(R1 Phase 1)

2.1 触发时机

2.2 引导形式

| 形式 | 时机 | 内容 | 退出 | | :--- | :--- | :--- | :--- | | 轻提示 1 | 首次打开背包页 | "色板 9 档从白板到不朽" 1 句 + 9 档渐变示意 | 玩家点"知道了"或 3 秒自动关 | | 轻提示 2 | 首次获得 epic+ | "史诗以上装备自带词条" 1 句 | 玩家点"知道了"或 3 秒自动关 | | UI 微提示 | 首次打开装备详情 | 词条 chip 旁小箭头"roll 区间 0.0~1.0" | 玩家点 chip 自动消失 |

2.3 退出方式

玩家点"知道了" → 立即退出 + 标记 dismissed-9tier: true
3 秒自动关 → 同样标记
玩家不主动关 → 仍 3 秒后自动关(不阻塞背包操作)

2.4 跟 6.30 onboarding 的接续

6.30 主流程引导(开张 / 接待 / 巡夜 / 满月)不包含 9 档品质
9 档品质引导新增到 OnboardingCoach.tsx 的"开张后第一步"段(在 开张大吉 任务完成后触发)
6.30 已收口不改动,只在 OnboardingCoach.tsx 加 1 个新 step

3. 新东西 2:联机 P2P 房间(R3)

3.1 触发时机

3.2 引导形式

| 形式 | 时机 | 内容 | 退出 | | :--- | :--- | :--- | :--- | | 任务引导 | 首次进入第 7 天 | "江湖初闻:跟其他客栈老板 PK 一下" 1 句 + 联机入口高亮 | 玩家点联机入口或 7 天后自动关 | | 轻提示 1 | 首次点联机入口 | "5 态状态机:等待 → 竞价 → 结算" 1 句 | 玩家点"知道了"或 5 秒自动关 | | 轻提示 2 | 首次进房间 | "房主 = 权威节点,客机可加入" 1 句 + 4 席位示意 | 玩家点"知道了"或 5 秒自动关 |

3.3 退出方式

玩家点"知道了" → 立即退出 + 标记 dismissed-p2p: true
自动关 → 同样标记
玩家不进联机 → 任务引导不强制,可完全跳过(联机是可选玩法)

3.4 跟 6.30 onboarding 的接续

6.30 主流程不包含联机入口
联机引导新增到 OnboardingCoach.tsx 的"江湖初闻"段(在 解锁吕秀才 任务同期触发)
6.30 已收口不改动

4. 新东西 3:胜利收束页(R2)

4.1 触发时机

4.2 引导形式

| 形式 | 时机 | 内容 | 退出 | | :--- | :--- | :--- | :--- | | 任务引导 | 首次进入第 350 天 | "再撑 10 天,胜利收束页即将解锁" 1 句 | 玩家点"知道了"或第 360 天自动关 | | 轻提示 1 | 首次进入收束页 | "4 块拼装:结算 + 关系 + 名声 + 阅历" 1 句 | 玩家点"知道了"或 5 秒自动关 | | 轻提示 2 | 首次点"开新周目" | "新周目 = 阅历累加 + 传承商店" 1 句 | 玩家点"知道了"或 5 秒自动关 |

4.3 退出方式

玩家点"知道了" → 立即退出 + 标记 dismissed-victory: true
自动关 → 同样标记
玩家点"继续"或"返回主菜单" → 引导不重复

4.4 跟 6.30 onboarding 的接续

6.30 主流程不包含胜利收束页
胜利引导不写到 OnboardingCoach.tsx,新增到 tips/FirstRunGuide.tsx 的"特殊场景"段(在 currentDay === 350 触发)
6.30 已收口不改动

5. 3 个不变量(任何时候都不能破坏)

| # | 不变量 | 为什么 | | :--: | :--- | :--- | | M1 | 玩家可跳过引导 | 6.30 onboarding flow 3 verified 已承诺"玩家可跳过" | | M2 | 引导不阻塞主线 | 引导 = 轻提示 + 任务引导,不强制 | | M3 | 引导不重复 | dismissed-9tier / dismissed-p2p / dismissed-victory 3 个 dismissed 标记 |

派生短工 在 R1 / R2 / R3 派生时,必须遵守这 3 个不变量。违反任一 = 该新东西不算正式上线。

6. 跟 R6 内容池扩展的接续(预留)

7. 验收口径

R4 新内容引导派生短工后(5 日计划外,但 R1/R2/R3 派生时一并参考),完成标准 = 全部满足:

本文档 § 1-6 全部拍清
3 个新东西(9 档 / 联机 / 胜利收束)各自拍 3 件事(触发时机 / 引导形式 / 退出方式)
3 种引导形式(轻提示 / 任务引导 / UI 微提示)各自拍清
3 个不变量 M1-M3 全部遵守
6.30 onboarding flow 3 verified 已收口不被改动
OnboardingCoach.tsx / FirstRunGuide.tsx 只新增 step,不改已有 step
TabUnlockToast.tsx / CinematicUnveilModal.tsx 等漂移组件不被强制激活

7.1 不算收口的情形

❌ 3 个新东西任一缺触发时机 / 引导形式 / 退出方式
❌ 玩家不能跳过引导
❌ 引导阻塞主线
❌ 引导重复(无 dismissed 标记)
❌ 改了 6.30 已收口的组件

7.2 可保留的 residual risk

✅ 玩家手动关引导(留 v1.1)
✅ 引导历史回看(留 v1.1)
✅ 多语言引导(留 Phase 7)
✅ 漂移组件(TabUnlockToast 等)正式吸收(留 v1.1)

8. 不在本 v1.0 的事项汇总(明确划走)

❌ 改 6.30 已收口的 OnboardingCoach / FirstRunGuide
❌ 改 tabUnlockConfig.ts / unveilTriggers.ts 漂移组件
❌ 强制激活 TabUnlockToast / CinematicUnveilModal
❌ 玩家手动关引导按钮
❌ 引导历史回看
❌ 多语言引导
❌ 引导跳过后的"回头看"机制
❌ 引导 A/B 测试(留 Phase 7)

9. 参考入口

10. 版本与变更记录

| 版本 | 时间 | 整理人 | 关键变更 | | :---: | :---: | :--- | :--- | | v1.0 | 2026-07-01 18:56 | Mavis(PM 视角) | 首版:3 个新东西(9 档品质 / 联机房间 / 胜利收束)各自拍 3 件事(触发时机 / 引导形式 / 退出方式);3 种引导形式 + 3 个不变量;6.30 onboarding 收口不改动;漂移组件不强制激活 | | v1.1(待) | — | — | 待 R6 v1.1 多周目 + 跨周目引导 + 多语言引导 3 条需求落地后,补本 v1.1 |