lawless/docs/需求文档/PRD-02-境界隔离系统需求文档.md

# PRD-02 境界隔离系统需求文档

> **文档类型**：产品需求文档（Product Requirements Document）  
> **版本**：v1.1  
> **日期**：2026-07-06  
> **关联文档**：GDD-01（种族系统）、GDD-02（底层核心机制）、GDD-08（大陆地图与区域开放系统）、GDD-09（种族出生地与新手区域设计）、GDD-11（种族转生与转化系统）、TDD-00（挂机手游技术栈方案）、TDD-04（数据库表结构设计）、GDD-21（数值平衡与联调参数总表）

---

## 1. 需求背景

《洪荒大陆》以「境界升级 = 地图天启」为核心成长轴（GDD-08 ✅D01–D02）。玩家从种族出生地（layer 0，炼气期）出发，通过修炼、渡劫、触发天启事件，逐步解锁洪荒边境、洪荒主陆、洪荒腹地、太古秘境、混沌之渊等更高层级。境界隔离系统是实现以下设计目标的基础设施：

1. **出生地与新手保护**：炼气期为「种族摇篮」，必须从系统底层杜绝跨种族接触，防止高境界玩家或他族玩家破坏新手体验（GDD-08 ✅D03、GDD-09 §2）。
2. **天启仪式感与进程门槛**：区域开放不应由任务链推进，而应由「境界圆满 + 探索/事件 + 关键道具」共同触发，强化概率/机遇驱动的核心循环（GDD-02 ✅37、GDD-08 ✅D11）。
3. **防止高境界碾压**：高境界玩家可回溯低层，但必须在战斗、资源产出、身份显示上受到「降维护佑」与「穿越届壁代价」约束，避免低层经济与社会秩序被顶层玩家碾压（GDD-08 ✅D15 / ✅Q06）。
4. **区域社交沉浸感**：不同层级、不同区域拥有隔离的聊天与广播频道，让玩家感知「身处一方天地」，并随天启逐步解锁跨种族共通语与势力频道（GDD-08 ✅D07、GDD-02 ✅46）。

本 PRD 不另设数值体系，所有境界门槛、消耗、产出上限、降维系数均引用 GDD-21《数值平衡与联调参数总表》。

---

## 2. 功能需求

### 2.1 种族出生地隔离（layer 0）

**目标**：炼气期内，玩家仅与本种族玩家共存于同族出生地，系统级杜绝跨种族接触。

1. **数据层隔离**
   - 每个种族出生地为独立逻辑分区（Shard by Race）。
   - 角色表 `characters` 必须记录 `birth_race_id` + `world_tier`/`realm_tier`，所有按区域查询的玩家列表、附近的人、组队匹配、交易市场均默认追加 `WHERE birth_race_id = $race AND world_tier = $tier` 过滤（TDD-04 §5.1、§10）。
   - 跨种族对象在炼气期不可出现在任何客户端可交互列表中（好友推荐、组队邀请、交易对象、市场挂单、附近的人）。

2. **传送层隔离**
   - 出生地地图不存在通往他族出生地的传送阵或边界门。
   - 唯一出口「天启门」在炼气圆满前为锁闭状态；未圆满玩家尝试交互时提示「尚未达到炼气圆满，无法感知界壁」。

3. **匹配层隔离**
   - 聊天、组队、好友搜索、交易匹配均按 `race_id + layer=0` 过滤。
   - 组队跨层拉人失效：若队长或成员境界已达可离开 layer 0 的条件但尚未天启，或队伍中存在不同种族成员，炼气期成员自动失去传送资格，系统提示「种族结界尚未解开，无法随行」。
   - 好友「闪现到队友」功能对 layer 0 玩家禁用。

4. **体验保障**
   - 出生地内提供完整本族社交闭环（组队、师徒、聊天、师徒、家族），不因隔离导致孤独体验。
   - 允许通过「洪荒史书」「先辈传说」等图鉴**预览**他族存在，但不提供实际接触途径。

> 来源：GDD-08 §2、GDD-09 §1、TDD-04 C01。

---

### 2.2 开疆事件触发条件（天启）

**目标**：区域开放不由任务面板驱动，而由「境界圆满 + 探索历程 + 关键道具/事件」自然触发。

1. **天启触发条件（layer N → layer N+1）**
   | 检查项 | layer 0→1 | layer 1→2 及以上 |
   |--------|-----------|------------------|
   | 境界圆满 | 炼气圆满 | 当前大境界圆满 |
   | 本层探索条件 | 完成出生地内自然触发的关键历程节点 | 满足目标层前对应本层核心探索/历程条件 |
   | 天启事件 | 触发并完成种族化天启事件 | 触发并完成天启事件 |
   | 关键道具 | 无消耗 | 持有对应层「天启钥/关键道具」 |

2. **关键道具获取途径**
   - 探索、副本、世界事件、玩家交易、势力拍卖。
   - 首次天启（layer 0→1）不设道具消耗，作为新玩家必经且不可跳过的仪式节点（GDD-08 ✅D11）。

3. **天启事件规则**
   - 事件进行中可随时取消，返回后境界圆满状态保留，下次可直接继续。
   - 无失败惩罚，强制取消仅扣除已消耗的事件物资。
   - 不可叠加其他主线历程（支线/日常委托不受影响）。
   - 事件完成后，服务器原子化更新 `characters.max_world_layer` + `world_tier`，并记录 `world_barrier_break_records`。

4. **首次天启后流程**
   - 触发「天启征兆」（天象/异动）。
   - 「天启门」永久激活，layer 解锁 +1。
   - 进入新区前执行「准入检查」（见 2.3）。
   - 落地后触发「初临该层」览要与首拓奖励判定（GDD-08 §3.8）。

> 来源：GDD-08 §3.2、§3.3、GDD-09 各种族「新手历程节点」。

---

### 2.3 地图层级准入检查

**目标**：任何跨层移动（上行/下行/副本/遗迹）前，服务端必须校验玩家是否满足目标区域准入条件。

1. **准入检查项**
   | 检查项 | 说明 | 失败处理 |
   |--------|------|----------|
   | 层级解锁 | 目标 `layer` ≤ 角色 `max_world_layer` | 拒绝进入，提示「尚未天启」 |
   | 境界门槛 | 角色当前境界 ≥ 目标层最低境界 | 拒绝进入，提示所需境界 |
   | 状态合规 | 非战斗/追杀/SAN崩溃/禁传状态 | 拒绝进入，提示具体原因 |
   | 资源合规 | 携带物是否符合跨区规则 | 超限物转入「随身仓」冻结并提示 |
   | 层5特判 | SAN 值高于进入阈值 | 低于阈值禁入，提示需恢复理智 |

2. **检查入口**
   - 玩家主动跨区域移动、被队伍/势力召唤、进入副本/遗迹、使用传送道具、离线恢复后重新上线。
   - 客户端可预检以提升体验，但**服务端必须为最终校验 authoritative source**，防止外挂绕过。

3. **小境界解锁分区**
   - 在同一世界层级内，升小境界解锁新的小地图分区；分区准入检查仅校验 `minor_realm` 是否达标，不触发跨层规则。

4. **天启遗迹特殊处理**
   - 玩家天启时在旧世界生成的「道韵遗迹」（历史上也常被称作破界遗迹）对旧世界玩家开放，原主角色以残影拓本形式进入，不受自身当前层级准入限制（GDD-08 §4.2.6）。

> 来源：GDD-08 §3.5、TDD-04 §5.10 / §9。

---

### 2.4 跨层资源携带规则

**目标**：遵循「人身随行，物受其域」原则——角色本体、核心养成随行；外部资源受目标层规则限制，防止高层资源冲垮低层经济。

1. **携带规则总表**

   | 资源类型 | 带入更高层 | 带回更低层 | 说明 |
   |----------|------------|------------|------|
   | 角色本体/境界/属性 | ✅ 完整 | ✅ 完整（回溯受降维护佑约束） | 不衰减 |
   | 弟子/灵宠 | ✅ 随行 | ✅ 随行 | 养成线全程跟随 |
   | 法宝/本命法器 | ✅ 随行 | ✅ 随行 | 核心战力跨区无损 |
   | 功法/神通/法则 | ✅ 随行 | ✅ 随行 | 知识类不受限；高层法则在低层可能无施展场景 |
   | 装备 | ⚠️ 受等级压制 | ✅ 可用，无衰减 | 低层装备带入高层因等级差被压制（GDD-08 ✅Q03） |
   | 通用货币（灵石等） | ✅ | ✅ | 全区流通 |
   | 层级专属资源 | —（产地即高层） | ⚠️ 限制带回 | 不可用于低层合成，仅作仓储/向上消耗 |
   | 绑定/区域限定道具 | ❌ | ❌ | 仅限产出区域使用 |

2. **随身仓机制**
   - 当玩家携带超出目标区规则的物品时，不删除，自动转入「随身仓库」冻结。
   - 玩家回到合规区域后可取出。
   - 随身仓容量、冻结时长、取出手续费由 GDD-21 定义。

3. **穿越届壁代价**
   - 跨层移动（天启事件后首次进入新层除外）每次触发届壁消耗：
     - 上行：目标层日均灵石产出 × 10
     - 下行：当前层日均灵石产出 × 10
   - 下界后限制（✅D15）：
     - 本命法宝/法则类技能在低层自动封印；
     - 本层专属材料不可带入低层，自动转入随身仓冻结；
     - 在低层组织/帮派中显示为「访客」，不享受低层势力分红；
     - 连续下界驻留上限 7 天（现实时间），到期自动归位至最高已天启层。

4. **混沌污染特例**
   - 从 layer 5 混沌之渊带出的部分材料带「污染」属性，需在低层「净化」后方可正常使用，否则持有持续微量扣 SAN（GDD-08 §5.3）。

> 来源：GDD-08 §3.7、§5，TDD-04 §5.6。

---

### 2.5 区域聊天与广播隔离

**目标**：按层级与区域隔离信息，强化「身处一方天地」的沉浸感，并随天启逐步开放跨种族交流。

1. **频道架构**

   | 频道类型 | 作用域 | 可见范围 | 备注 |
   |----------|--------|----------|------|
   | 种族方言频道 | layer 0 出生地 | 本种族本出生地 | 炼气期主频道，带种族特色用语 |
   | 区域频道 | 各 layer 当前所在区域 | 同区域玩家 | 进入即自动加入，离开即切换 |
   | 洪荒共通语频道 | layer 1+ | 同层跨种族 | 首遇后解锁，跨种族交流主通道 |
   | 势力频道 | layer 2+ | 同势力成员 | 跨区常驻，不随地图切换 |
   | 队伍/私聊/师徒 | 全局 | 关系链 | 不受区域隔离；炼气期私聊对象仅限本族 |
   | 混沌低语频道 | layer 5 | 同区域 | 受 SAN 影响，低 SAN 时显示扭曲/虚假信息 |

2. **广播事件作用域**

   | 广播级别 | 触发事件举例 | 作用域 |
   |----------|--------------|--------|
   | 出生地广播 | 本族玩家炼气圆满天启、稀有本土资源刷新 | 本种族 layer 0 |
   | 区域广播 | 世界 BOSS 刷新/击杀、灵潮/天灾事件开启 | 当前区域 |
   | 首遇广播 | 玩家首次踏入洪荒边境、跨种族首次贸易 | layer 1 |
   | 势力广播 | 领地易主、宗门战开战/结算 | 相关势力/区域 |
   | 因果/法则/混沌广播 | 天罚降临、大道之争开启、旧日造物苏醒 | layer 3/4/5 |
   | 全服广播 | 首位玩家天启新层、世界级 BOSS 归属 | 全服 |

3. **附近的人**
   - 仅展示游戏内坐标最近的约 30 位玩家，随移动实时刷新。
   - layer 0 仅显示本族玩家；layer 5 对 SAN 过低玩家显示混沌标记。
   - 支持快捷交互：查看主页、加好友、邀请组队、发起切磋/挑战（受 PVP 规则约束）。

> 来源：GDD-08 §4、GDD-02 ✅46。

---

### 2.6 回溯低层与降维护佑

**目标**：允许玩家自由回溯已解锁低层，但系统必须防止恶意虐杀与经济掠夺。

1. **回溯规则**
   - 已天启层级可随时返回，无需重新完成天启事件。
   - 回溯不消耗穿越届壁费用；再次上行进入更高层时触发届壁消耗（GDD-08 §3.6）。

2. **降维护佑（天道压制）**
   - 高境界玩家在低层对低层玩家造成伤害时，伤害按 GDD-21 定义的「降维系数」大幅削减。
   - 被攻击的低层玩家获得临时保护增益（减伤、闪避、反伤等，由 GDD-21 定义）。
   - 高境界玩家击杀低层玩家仍按低层规则累计戾气/触发追杀令（L2/L3）。

3. **产出上限**
   - 高境界玩家在低层挂机/采集/战斗的产出，按「目标层产出上限」结算，不获取超额资源。
   - 稀有资源掉落概率、经验/修为收益受低层上限封顶。

4. **下界限制兜底**
   - 本命法宝与法则类技能在低层自动封印，作为降维护佑的补偿性限制。
   - 连续驻留 7 天（现实时间）后，系统自动将角色归位至其最高已天启层；归位前 24 小时通过邮件/弹窗提醒。

5. **PVP 规则跨层映射**
   - layer 0 全面禁战；layer 1 缓冲禁战（仅友好切磋）；layer 2+ 按戾气/因果规则开放。
   - 追杀令跨层流转：L2/L3 触发的追杀令在全可达层级通缉，但进入 L0/L1 时通缉冻结，离开后恢复（GDD-08 §6.5）。

> 来源：GDD-08 §3.6、§6.4、§6.5、GDD-02 ✅25 / ✅42。

---

## 3. 非功能需求

### 3.1 数据层过滤

1. **数据库隔离字段**
   - `characters` 表必须独立存储 `world_tier`（当前世界层级）与 `max_world_layer`（已解锁最高层），并建立复合索引 `(world_tier, realm_tier, minor_realm, power DESC)` 用于排行榜与匹配（TDD-04 §5.1、§10）。
   - `zone_id` + `world_tier` 作为区域查询主键维度，避免跨层数据串区。

2. **查询默认过滤**
   - 所有涉及玩家列表、市场挂单、拍卖、悬赏、排行榜、附近的人、组队匹配的 SQL/API，必须默认追加 `world_tier`/`realm_tier` 过滤；不允许提供无过滤的全服扫描接口。

3. **缓存一致性**
   - 玩家当前层、已解锁最高层、随身仓状态等高频数据需写入 Valkey 缓存，TTL 与数据库更新事件联动失效。

### 3.2 实时/异步校验

1. **实时校验**
   - 跨层移动、进入副本、传送、组队召唤等操作必须在请求处理链路中同步完成准入检查，响应时延 ≤ 200ms（P99）。
   - 聊天/广播消息在 Nakama 频道路由前，根据发送者 `world_tier` + `race_id` 确定投递范围。

2. **异步校验**
   - 玩家上线、断线重连、跨服迁移后，异步任务校验角色当前位置与层级的合法性；异常位置自动纠正至最近合法安全区并记录审计日志。
   - 降维护佑系数、产出上限、连续下界时长等数值每日 08:00（现实时间）统一结算与告警（GDD-02 ✅87）。

### 3.3 服务器分线策略

1. **出生地分线**
   - layer 0 出生地采用「同族独立实例 + 低容量上限」策略；满员时新建同族出生地副本，玩家无感知（GDD-08 §4.2.1）。

2. **主城/坊市分线**
   - 主城/坊市按独立容量上限分线（如 500 人/线），满员时外区传送请求排队或提示「主城繁忙」。

3. **野外大地图**
   - 野外大地图采用动态容量，环境敌人密度随人数弹性调整；超阈值时增加刷怪量，不强制分线。

4. **副本/遗迹**
   - 副本实例化，每支队伍独立实例；满队直接开新实例，无排队。

> 来源：TDD-00 §2.3、GDD-08 §4.2.1。

---

## 4. 验收标准

| 编号 | 验收标准 | 验证方式 |
|------|----------|----------|
| AC-01 | 任意两名不同种族的炼气期玩家，无法在 layer 0 互相查看资料、组队、交易、私聊、出现在附近的人列表 | 黑盒测试：创建 A/B 两族炼气角色，遍历社交/交易/组队接口 |
| AC-02 | 炼气期玩家未圆满时，点击/交互「天启门」收到「尚未达到炼气圆满」提示，且服务端拒绝所有跨层移动请求 | 接口测试：调用 zone/enter 接口，断言返回码与提示文案 |
| AC-03 | 角色达到炼气圆满并完成本族天启事件后，`max_world_layer` 原子化 +1，首次进入 layer 1 触发首拓奖励与「初临该层」览要 | 自动化测试：模拟圆满 → 触发事件 → 校验数据库字段与奖励发放 |
| AC-04 | 角色从 layer 2 携带本层专属材料下行至 layer 1 时，专属材料自动进入随身仓冻结，无法在低层使用或交易 | 背包/随身仓测试：校验物品状态位与使用接口返回值 |
| AC-05 | 高境界玩家回溯低层后，对低层玩家造成伤害按 GDD-21 降维系数削减，且低层玩家获得保护增益；击杀仍按低层规则累计戾气 | 战斗沙盒测试：固定属性输入，校验伤害公式与戾气结算 |
| AC-06 | 连续下界驻留 7 天（现实时间）后，系统自动将角色传送回最高已天启层，并发送归位提醒邮件 | 时间推进模拟：修改系统时间或 Cron 触发，校验位置与邮件 |
| AC-07 | layer 0 聊天消息仅同种族玩家可见；layer 1+ 洪荒共通语频道可见跨种族消息；区域频道仅同区域玩家可见 | 聊天投递测试：多客户端并发收发，断言消息可达范围 |
| AC-08 | 所有排行榜、市场、悬赏列表查询默认按 `world_tier`/`realm_tier` 过滤，无法通过接口参数绕过隔离 | 安全测试：构造异常请求参数，断言服务端拒绝或结果集受限 |

---

## 5. 附录：术语与引用

| 术语 | 说明 | 来源 |
|------|------|------|
| layer 0~5 | 地图显示层级：0 出生地、1 洪荒边境、2 洪荒主陆、3 洪荒腹地、4 太古秘境、5 混沌之渊 | GDD-08 |
| realm_tier 1~9 | 大境界：1 炼气、2 筑基、3 金丹、4 元婴、5 化神、6 合体、7 大乘、8 渡劫、9 飞升 | TDD-04 |
| 天启 | 晋级世界的唯一术语，触发后永久解锁下一层 | GDD-08 ✅D02 |
| 穿越届壁 | 跨层移动时消耗灵石并触发下界限制 | GDD-08 ✅D15 |
| 降维护佑 | 高境界玩家在低层造成的伤害被天道压制，防止虐杀 | GDD-08 ✅Q06 |
| 随身仓 | 超限资源临时冻结仓库，回到合规区域可取出 | GDD-08 §5.3 |

---

## 6. 版本记录

| 版本 | 日期 | 作者 | 变更说明 |
|------|------|------|----------|
| v1.0 | 2026-06-30 | Kimi Code CLI | 初稿：完成境界隔离系统 PRD，涵盖出生地隔离、天启触发、准入检查、跨层资源携带、区域聊天广播、回溯与降维护佑、非功能需求及验收标准。 |