# PRD-10 新手引导系统需求文档

> **文档类型**：产品需求文档（Product Requirements Document）
> **版本**：v1.0
> **日期**：2026-07-08
> **关联文档**：GDD-35《新手引导系统设计》、GDD-02《底层核心机制》、GDD-08《大陆地图与区域开放系统》、GDD-09《种族出生地与新手区域设计》、PRD-01《核心玩法与系统需求文档》

---

## 1. 需求背景与目标

### 1.1 背景

《洪荒大陆》无任务链驱动、无新手教程面板、无分阶段教学。新手引导完全通过「环境线索 + 机遇事件 + 界面提示」自然发生，模拟修仙小说中"修士通过师门传承、游历奇遇、前辈指点等方式学习"的沉浸式体验。

### 1.2 目标

1. **无强制引导**：不强制玩家完成任何特定任务；所有引导均可跳过或忽略。
2. **环境叙事**：通过出生地地形、NPC 对话、环境氛围自然传达核心机制。
3. **保护新手**：炼气期有死亡保护、PVP 保护、资源保护，降低挫败感。
4. **快速上手**：5 分钟内理解核心循环（挂机 → 游历 → 突破），30 分钟内完成首次突破。
5. **留足悬念**：不展示完整系统，让玩家通过探索逐步发现（如隐藏天赋、他族存在、高层区域）。

---

## 2. 功能需求

### 2.1 创角引导（0~5 分钟）

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-01 | 创角界面展示可选种族（仅可创角种族），每个种族展示：种族天赋、可能职业、背景故事、出生地 | P0 | 种族卡片有图标/名称/一句话定位/天赋摘要；不可创角种族灰色显示但可预览 |
| R-02 | 选择种族后展示可选职业/血脉方向（人族 8 职业，他族 1~3 血脉方向） | P0 | 职业卡片展示：核心属性、招牌天赋、一句话描述；可切换查看 |
| R-03 | 选择职业后进入角色命名和外观微调（可选） | P1 | 命名支持 2~8 个汉字；敏感词过滤；随机命名按钮 |
| R-04 | 创角确认前展示「洪荒契约」：一句话总结种族特色 + 核心玩法提示 | P1 | 契约可跳过；首次玩家建议阅读 |
| R-05 | 创角完成后进入出生地，播放简短环境动画（种族特色场景） | P1 | 动画可跳过；展示出生地标志性景观 |

### 2.2 出生地环境引导（5~30 分钟）

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-06 | 出生地有明显「道路」引导玩家向重要地点移动 | P0 | 道路用光效/粒子标记；跟随道路到达第一个 NPC |
| R-07 | 首个 NPC（长老/导师）自动对话，介绍种族背景和核心机制（3 句话内） | P0 | 对话自动播放；可点击跳过；内容：挂机产出、游历触发、能量积累 |
| R-08 | 引导玩家进行第一次挂机：到达资源点 → 点击挂机 → 收取产出 | P0 | 资源点有明显标记；挂机按钮高亮提示；产出后弹出「获得资源」提示 |
| R-09 | 引导玩家进行第一次游历：点击游历 → 自动触发遭遇 → 展示战报 | P0 | 游历按钮高亮提示；遭遇战自动进行；战后展示「能量消耗/战利品/能量上限增长」 |
| R-10 | 引导玩家查看能量进度条：解释「能量上限值 = 修炼进度」 | P0 | 进度条有 tooltip：「能量上限增长即修为提升，达到目标后可突破境界」 |
| R-11 | 首次达到突破条件时，环境出现特殊效果（天象变化/光效）提示 | P0 | 突破按钮高亮；环境效果持续 10 秒；点击后进入突破界面 |
| R-12 | 突破界面展示：成功率、突破奖励、失败风险 | P0 | 成功率按当前状态实时计算；突破后播放成功动画 |

### 2.3 界面引导（全程）

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-13 | 主界面核心元素有首次使用提示（tooltip 样式） | P1 | 每个按钮首次点击时显示 tooltip；提示内容简洁（1 句话） |
| R-14 | 能量条始终显示：当前值/上限值/上限天花板 | P0 | 三轨进度条：当前值（蓝色）/ 上限值（金色）/ 天花板（灰色虚线） |
| R-15 | 境界名称显示当前境界 + 小境界 + 距离下一境界百分比 | P0 | 如「炼气期·初期（12%）」；点击展开详细进度 |
| R-16 | 背包按钮有红点提示（新获得物品） | P0 | 红点逻辑：获得新物品 / 待处理邮件 / 待学习技能 |
| R-17 | 设置界面提供「引导开关」：可关闭/重新开启所有引导提示 | P1 | 老玩家可直接关闭；关闭后不再显示任何 tooltip |

### 2.4 新手保护机制

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-18 | 死亡保护：境界 < 筑基期时，死亡不掉落/不损失/原地复活 | P0 | 死亡提示「新手护佑：损失已减免」；复活后满血满能量 |
| R-19 | PVP 保护：出生地禁止 PVP；主城禁止 PVP | P0 | 尝试 PVP 时提示「该区域禁止争斗」；违者立即官方拘押 |
| R-20 | 降维护佑：高境界 vs 低境界伤害大幅压制（差距 1 大境界 ×0.5 / 2 大境界 ×0.25 / 3+ ×0.1） | P0 | 与 GDD-02 ✅165 对齐；被攻击时提示「境界差距过大，伤害已压制」 |
| R-21 | 资源保护：境界 < 筑基期时，采集不被打断/资源不被抢 | P1 | 采集过程免疫战斗打断；其他玩家无法抢夺新手采集点 |
| R-22 | 交易保护：境界 < 筑基期时，交易有价格指导（防骗） | P1 | 市场挂单显示「参考价格区间」；超出区间 50% 时警告 |
| R-23 | 能量 < 5% 时，30% 概率自动撤退（不进入战斗） | P1 | 提示「能量不足，自动撤退」；撤退无惩罚 |

### 2.5 天启引导（长期，境界圆满后）

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-24 | 境界圆满后，环境出现「天启征兆」：天象变化/地图异动 | P1 | 征兆持续 1 游戏天；期间游历触发天启事件概率 +50% |
| R-25 | 天启事件触发时，全服广播 + 个人特殊提示 | P1 | 广播格式：「[玩家名] 触发天启，大陆新层域即将开启」；个人提示：「你感受到界壁松动」 |
| R-26 | 首次进入新层域时，播放「初临」动画 + 层域介绍 | P1 | 动画可跳过；介绍该层特色（PVP 规则/新资源/新种族相遇） |
| R-27 | 新层域前 7 游戏天有「探索加成」：资源产出 +20% | P1 | 加成倒计时显示在界面；鼓励玩家积极探索新区域 |

### 2.6 帮助系统

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-28 | 「洪荒史书」图鉴：收录所有已发现的种族/功法/装备/怪物/地图 | P1 | 自动解锁已接触内容；未接触内容显示为「???」 |
| R-29 | 「先辈传说」：NPC 对话中穿插游戏机制讲解（如"突破需谨慎，能量不足时切莫强行渡劫"） | P1 | 对话自然融入叙事；不跳出游戏世界 |
| R-30 | 帮助搜索：支持关键词搜索游戏机制（如"渡劫失败会怎样"） | P2 | 搜索结果引用 GDD 相关内容；用游戏内叙事语言表述 |

---

## 3. 非功能需求

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| N-01 | 引导提示可关闭/重新开启；关闭后不再打扰 | P0 | 设置界面有开关；开关状态持久化 |
| N-02 | 引导提示响应时间 < 100ms，不阻塞玩家操作 | P0 | tooltip 异步加载；不卡顿 |
| N-03 | 首次引导全流程可控制在 15 分钟内完成 | P1 | 核心引导（挂机+游历+突破）5 分钟；完整引导 15 分钟 |
| N-04 | 引导进度云端保存，换设备后从上次进度继续 | P1 | 引导状态写入角色数据；不依赖本地存储 |

---

## 4. 版本记录

- **v1.0**（2026-07-08）：初始版本，覆盖创角、出生地、界面、保护、天启、帮助
