# PRD-04 巫族十二祖巫分支需求文档

> **文档类型**：产品需求文档（Product Requirements Document）
> **版本**：v1.0
> **日期**：2026-07-06
> **关联文档**：GDD-01-附录A《巫族十二祖巫分支详细设计》、GDD-01《种族系统设计》、GDD-10《隐藏天赋完整表》、GDD-17《技能总库》、GDD-26《功法心法技能详细设计》、PRD-01《核心玩法与系统需求文档》

---

## 1. 需求背景与目标

### 1.1 背景

《洪荒大陆》巫族在 GDD-01 中已完成“12 常规祖巫分支 + 2 特殊战神血脉”的框架设计，包括分支名称、招牌天赋与通用种族天赋。但各分支在**成长阶段可视化、祖巫真身、分支独属技能、隐藏天赋、跨分支协同**等维度仍需细化，才能支撑后续程序实现与数值平衡。

### 1.2 目标

1. 为 12 常规祖巫分支补齐**血肉淬炼阶段、祖巫真身、分支独属技能、分支隐藏天赋**。
2. 明确**刑天/蚩尤特殊战神血脉**的获取、真身、技能与隐藏天赋细节。
3. 定义**跨分支协同与冲突**规则，支撑“祖巫印记冲突”隐藏天赋的落地。
4. 给出服务端/客户端可落地的数据字段与配置接口。
5. 输出可验收的功能清单与验收标准。

---

## 2. 需求范围

### 2.1 包含内容

- 十二常规祖巫分支：帝江、句芒、祝融、蓐收、共工、玄冥、后土、强良、烛九阴、天吴、翕兹、奢比尸。
- 特殊战神血脉：刑天、蚩尤。
- 巫族通用机制：血肉淬炼系统、祖巫真身、无元神特性、能量体系（GDD-23）。

### 2.2 不包含内容

- 巫族通用天赋（已在 GDD-01 完成）。
- 种族转生/转化/残响继承（由 GDD-11 / PRD-01 §3 覆盖）。
- 境界体系与地图层级（由 GDD-08 / PRD-02 覆盖）。
- 战斗公式与数值硬顶（由 GDD-03 / GDD-21 覆盖）。

---

## 3. 功能需求

### 3.1 分支选择与展示

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-01 | 创角选择巫族后，必须展示 12 常规祖巫分支供玩家选择 | P0 | 客户端创角界面显示 12 个分支图标、名称、一句话定位；刑天/蚩尤不显示 |
| R-02 | 每个分支展示“核心属性 + 招牌天赋 + 一句话背景” | P0 | 展示内容与 GDD-01-附录A §四一致 |
| R-03 | 角色面板需显示当前主传承、第二传承虚影（如有）、祖巫真身解锁状态 | P1 | 主传承常驻显示；第二传承仅在掌握「祖巫印记冲突」后显示；真身状态可切换展示 |

### 3.2 血肉淬炼系统

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-04 | 巫族沿用 4 阶段通用淬炼：淬体 → 炼血 → 祖巫觉醒 → 肉身成圣 | P0 | 阶段切换条件与通用规则对齐 GDD-01 §3.0d |
| R-05 | 每个分支在 4 阶段中解锁不同的分支意象与能力 | P1 | 各分支 T1~T4 解锁的能力与 GDD-01-附录A §3.2 / §四一致 |
| R-06 | 分支境界名称展示变体可配置，数值阶段与巫族通用表一致 | P1 | UI/战报可使用分支意象词，但境界经验/属性映射不变 |

### 3.3 祖巫真身

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-07 | 角色达到 T6（祖巫/祖巫之力）并完成觉醒仪式后，解锁对应分支的祖巫真身 | P0 | 真身解锁写入角色状态；未解锁时不展示真身按钮 |
| R-08 | 祖巫真身为主动开启的临时形态，持续消耗能量并有冷却 | P0 | 持续时间 300~600 ticks，冷却 1800~3600 ticks，能量消耗按 GDD-01-附录A §3.2 配置 |
| R-09 | 真身期间大幅提升生命/防御/分支特色属性，并解锁真身技 | P0 | 属性加成与真身技效果与 GDD-01-附录A §四一致 |
| R-10 | 真身期间角色外观/战报标识切换为对应祖巫虚影 | P1 | 文字战报中出现「祖巫真身·XXX」标识；客户端立绘/模型切换（如资源到位） |
| R-11 | 战神血脉（刑天/蚩尤）同样拥有真身形态与真身技 | P1 | 刑天真身解锁「刑天舞干戚」，蚩尤真身解锁「万兵归宗」 |

### 3.4 分支独属技能

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-12 | 每个常规分支拥有 3~4 个分支独属技能（含招牌天赋被动、真身技、主动技） | P0 | 12 个常规分支 × 3~4 个技能，具体见 GDD-01-附录A §四 与 GDD-17 附.4a |
| R-13 | 分支独属技能通过 `required_sub_branch` 字段绑定传承，异族/异传承无法满效发挥 | P0 | Skill Schema 包含 `required_sub_branch`；不匹配时技能不可学习或效果打折 |
| R-14 | 战神血脉技能仅刑天/蚩尤传承可用 | P0 | 刑天/蚩尤技能表单独配置，其他传承不可学习 |
| R-15 | 分支技能参与 GDD-17 程序化生成引擎的“独属”类别，可带种族化命名 | P1 | 技能生成时 domain=witch，按传承匹配命名池 |

### 3.5 分支隐藏天赋

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-16 | 12 常规祖巫分支每个分支至少拥有 1 条分支级隐藏天赋 | P0 | 见 GDD-10 v1.7 §三、§七 |
| R-17 | 隐藏天赋遵循“隐患态 → 掌握条件 → 掌握后增益”三要素 | P0 | 每条天赋含明确隐患、掌握条件、掌握后强点 |
| R-18 | 7 条新增分支隐藏天赋（春殇/秋杀/冬寂/雷殛/时蚀/风噬/电弧）通过游历/事件/材料获取 | P0 | 获取途径与 GDD-01-附录A §四 一致 |
| R-19 | 隐藏天赋状态参与转生/转化的残响继承规则 | P1 | 已掌握/隐患态/中断态按 GDD-10 §7.2 处理 |

### 3.6 特殊战神血脉

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-20 | 刑天/蚩尤不在创角池，需巫族玩家境界 ≥ 元婴后在不周山对应区域触发遗迹事件获得 | P0 | 触发区域：不周山东麓·断首台（刑天）、不周山西麓·蚩尤冢（蚩尤） |
| R-21 | 获得战神血脉后，原主传承天赋以“残响”形式保留 30%~60% 强度，7 现实天试炼期内可回退 | P1 | 与 GDD-01 现有规则一致 |
| R-22 | 战神血脉拥有独立的招牌天赋、真身、独属技能与隐藏天赋 | P1 | 详见 GDD-01-附录A §五 |

### 3.7 跨分支协同与冲突

| 需求编号 | 需求描述 | 优先级 | 验收标准 |
|----------|----------|--------|----------|
| R-23 | 掌握隐藏天赋「祖巫印记冲突」后，可同时使用两种祖巫传承能力 | P0 | 第二传承继承其招牌天赋 + 1 个自选分支独属技能；真身以虚影形式附加部分效果 |
| R-24 | 特定分支组合存在协同增益 | P1 | 协同组合与效果见 GDD-01-附录A §6.2 |
| R-25 | 特定分支组合存在叙事冲突与数值惩罚 | P2 | 冲突组合与惩罚见 GDD-01-附录A §6.3；惩罚仅影响同时装备的技能/天赋 |

---

## 4. 数据需求

### 4.1 数据库字段扩展

#### character_race_states.bloodline_data（JSONB）

```jsonc
{
  "main_race_id": "witch",
  "sub_branch_id": "dijiang",          // 12常规 + 2特殊
  "quenching_stage": 4,                // 1-4
  "true_body_unlocked": true,
  "true_body_level": 3,
  "secondary_branch": {                // 祖巫印记冲突掌握后
    "sub_branch_id": "zhurong",
    "active_talent": "zhurong_true_fire",
    "active_skill": "fire_god_wrath"
  }
}
```

#### skills 表

| 字段 | 类型 | 说明 |
|------|------|------|
| `required_race` | string[] | 已存在，必填 ["witch"] |
| `required_sub_branch` | string[] | 新增，绑定祖巫分支，如 ["dijiang"] |
| `is_true_body_skill` | bool | 新增，标记是否仅在真身期间可用 |

### 4.2 配置表需求

| 配置项 | 位置 | 说明 |
|--------|------|------|
| 分支招牌天赋参数 | Nacos `honghuang-race.yaml` | 触发率、数值系数 |
| 祖巫真身数值 | Nacos `honghuang-combat.yaml` | 属性加成、能量消耗、CD、持续时间 |
| 分支境界展示名 | Nacos 文案配置 / Asset Bundle | UI/战报展示用 |
| 分支技能生成积木 | GDD-17 引擎配置 | domain=witch，按分支组合 |

### 4.3 客户端资源需求

| 资源 | 说明 | 优先级 |
|------|------|--------|
| 12 常规分支 + 2 战神真身立绘/虚影 | 创角展示、角色面板、战报标识 | P1 |
| 分支图腾/材料图标 | 用于技能、材料、洞府装饰 | P2 |
| 分支技能特效文案 | 文字战报中的种族化命名（GDD-17 附.7.7） | P0 |

---

## 5. 非功能需求

### 5.1 性能

- 祖巫真身状态需在战斗快照中缓存，避免每 tick 重新计算。
- 分支隐藏天赋的触发判定应使用事件驱动，避免轮询。

### 5.2 平衡性

- 所有分支天花板战力处于同一数量级（±15%），符合 GDD-01 §五。
- 战神血脉获取难度与强度需显著高于常规分支，但不得碾压。
- 双传承组合收益需经 GDD-21 压力测试，避免超模。

### 5.3 文案与本地化

- 分支名称、技能名、天赋名需统一使用 GDD-01-附录A 中的命名。
- 所有“待平衡测试”数值在落地前需由策划确认。

---

## 6. 验收标准

### 6.1 功能验收

- [ ] 12 常规分支可在创角界面正常选择并展示。
- [ ] 每个分支的招牌天赋在战斗中按设计触发。
- [ ] 祖巫真身达到条件后解锁，开启后属性与真身技生效。
- [ ] 每个分支的独属技能可被对应传承角色学习并正常释放。
- [ ] 12 个分支隐藏天赋均可在游戏中按条件获取与掌握。
- [ ] 战神血脉事件在不周山对应区域可触发，转传承后技能与天赋生效。
- [ ] 掌握「祖巫印记冲突」后可激活第二传承能力。

### 6.2 数据验收

- [ ] `character_race_states.bloodline_data` 正确记录分支、淬炼阶段、真身状态、第二传承。
- [ ] `skills` 表 `required_sub_branch` 字段对巫族分支技能正确填充。
- [ ] Nacos 配置可热更新分支天赋系数、真身数值、境界展示名。

### 6.3 文档验收

- [ ] GDD-01-附录A、GDD-10 v1.7、GDD-17 v2.7、PRD-04 已同步并提交 Git。
- [ ] mkdocs.yml 已加入新增文档导航。

---

## 7. 风险与依赖

| 风险 | 影响 | 缓解措施 |
|------|------|----------|
| 双传承组合可能过强 | 平衡性 | 先实现后由 GDD-21 做压力测试，必要时削弱第二传承继承比例 |
| 真身持续耗能可能导致 PVE 体验差 | 体验 | PVE 与 PVP 分别配置能耗系数，或提供低能耗“外观模式” |
| 战神血脉事件触发概率过低 | 获取感 | 设置保底累计值/碎片合成，避免玩家长期无法触发 |
| 新增 7 条隐藏天赋事件/材料未在 GDD-09 落地 | 内容缺失 | 与 GDD-09 作者确认事件/地图/材料设计，或在 PRD 中标记待补充 |

---

## 8. 变更记录

| 版本 | 日期 | 变更内容 |
|------|------|----------|
| v1.0 | 2026-07-06 | 初始版本：从 GDD-01-附录A 导出产品需求，覆盖 12 常规分支 + 2 战神血脉的功能、数据、验收标准与风险 |

---

*PRD-04 v1.0 | 2026-07-06 | 巫族十二祖巫分支需求文档，同步 GDD-01-附录A、GDD-10 v1.7、GDD-17 v2.7、GDD-01 v2.17*
