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，炼气期）出发，通过修炼、渡劫、触发天启事件，逐步解锁洪荒边境、洪荒主陆、洪荒腹地、太古秘境、混沌之渊等更高层级。境界隔离系统是实现以下设计目标的基础设施：
- 出生地与新手保护：炼气期为「种族摇篮」，必须从系统底层杜绝跨种族接触，防止高境界玩家或他族玩家破坏新手体验（GDD-08 ✅D03、GDD-09 §2）。
- 天启仪式感与进程门槛：区域开放不应由任务链推进，而应由「境界圆满 + 探索/事件 + 关键道具」共同触发，强化概率/机遇驱动的核心循环（GDD-02 ✅37、GDD-08 ✅D11）。
- 防止高境界碾压：高境界玩家可回溯低层，但必须在战斗、资源产出、身份显示上受到「降维护佑」与「穿越届壁代价」约束，避免低层经济与社会秩序被顶层玩家碾压（GDD-08 ✅D15 / ✅Q06）。
- 区域社交沉浸感：不同层级、不同区域拥有隔离的聊天与广播频道，让玩家感知「身处一方天地」，并随天启逐步解锁跨种族共通语与势力频道（GDD-08 ✅D07、GDD-02 ✅46）。
本 PRD 不另设数值体系，所有境界门槛、消耗、产出上限、降维系数均引用 GDD-21《数值平衡与联调参数总表》。
2. 功能需求¶
2.1 种族出生地隔离（layer 0）¶
目标：炼气期内，玩家仅与本种族玩家共存于同族出生地，系统级杜绝跨种族接触。
- 数据层隔离
- 每个种族出生地为独立逻辑分区（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）。 -
跨种族对象在炼气期不可出现在任何客户端可交互列表中（好友推荐、组队邀请、交易对象、市场挂单、附近的人）。
-
传送层隔离
- 出生地地图不存在通往他族出生地的传送阵或边界门。
-
唯一出口「天启门」在炼气圆满前为锁闭状态；未圆满玩家尝试交互时提示「尚未达到炼气圆满，无法感知界壁」。
-
匹配层隔离
- 聊天、组队、好友搜索、交易匹配均按
race_id + layer=0过滤。 - 组队跨层拉人失效：若队长或成员境界已达可离开 layer 0 的条件但尚未天启，或队伍中存在不同种族成员，炼气期成员自动失去传送资格，系统提示「种族结界尚未解开，无法随行」。
-
好友「闪现到队友」功能对 layer 0 玩家禁用。
-
体验保障
- 出生地内提供完整本族社交闭环（组队、师徒、聊天、师徒、家族），不因隔离导致孤独体验。
- 允许通过「洪荒史书」「先辈传说」等图鉴预览他族存在，但不提供实际接触途径。
来源：GDD-08 §2、GDD-09 §1、TDD-04 C01。
2.2 开疆事件触发条件（天启）¶
目标：区域开放不由任务面板驱动，而由「境界圆满 + 探索历程 + 关键道具/事件」自然触发。
-
天启触发条件（layer N → layer N+1） | 检查项 | layer 0→1 | layer 1→2 及以上 | |--------|-----------|------------------| | 境界圆满 | 炼气圆满 | 当前大境界圆满 | | 本层探索条件 | 完成出生地内自然触发的关键历程节点 | 满足目标层前对应本层核心探索/历程条件 | | 天启事件 | 触发并完成种族化天启事件 | 触发并完成天启事件 | | 关键道具 | 无消耗 | 持有对应层「天启钥/关键道具」 |
-
关键道具获取途径
- 探索、副本、世界事件、玩家交易、势力拍卖。
-
首次天启（layer 0→1）不设道具消耗，作为新玩家必经且不可跳过的仪式节点（GDD-08 ✅D11）。
-
天启事件规则
- 事件进行中可随时取消，返回后境界圆满状态保留，下次可直接继续。
- 无失败惩罚，强制取消仅扣除已消耗的事件物资。
- 不可叠加其他主线历程（支线/日常委托不受影响）。
-
事件完成后，服务器原子化更新
characters.max_world_layer+world_tier，并记录world_barrier_break_records。 -
首次天启后流程
- 触发「天启征兆」（天象/异动）。
- 「天启门」永久激活，layer 解锁 +1。
- 进入新区前执行「准入检查」（见 2.3）。
- 落地后触发「初临该层」览要与首拓奖励判定（GDD-08 §3.8）。
来源：GDD-08 §3.2、§3.3、GDD-09 各种族「新手历程节点」。
2.3 地图层级准入检查¶
目标：任何跨层移动（上行/下行/副本/遗迹）前，服务端必须校验玩家是否满足目标区域准入条件。
-
准入检查项 | 检查项 | 说明 | 失败处理 | |--------|------|----------| | 层级解锁 | 目标
layer≤ 角色max_world_layer| 拒绝进入，提示「尚未天启」 | | 境界门槛 | 角色当前境界 ≥ 目标层最低境界 | 拒绝进入，提示所需境界 | | 状态合规 | 非战斗/追杀/SAN崩溃/禁传状态 | 拒绝进入，提示具体原因 | | 资源合规 | 携带物是否符合跨区规则 | 超限物转入「随身仓」冻结并提示 | | 层5特判 | SAN 值高于进入阈值 | 低于阈值禁入，提示需恢复理智 | -
检查入口
- 玩家主动跨区域移动、被队伍/势力召唤、进入副本/遗迹、使用传送道具、离线恢复后重新上线。
-
客户端可预检以提升体验，但服务端必须为最终校验 authoritative source，防止外挂绕过。
-
小境界解锁分区
-
在同一世界层级内，升小境界解锁新的小地图分区；分区准入检查仅校验
minor_realm是否达标，不触发跨层规则。 -
破界遗迹特殊处理
- 玩家天启时在旧世界生成的「道韵遗迹」对旧世界玩家开放，原主角色以残影拓本形式进入，不受自身当前层级准入限制（GDD-08 §4.2.6）。
来源：GDD-08 §3.5、TDD-04 §5.10 / §9。
2.4 跨层资源携带规则¶
目标：遵循「人身随行，物受其域」原则——角色本体、核心养成随行；外部资源受目标层规则限制，防止高层资源冲垮低层经济。
- 携带规则总表
| 资源类型 | 带入更高层 | 带回更低层 | 说明 |
|---|---|---|---|
| 角色本体/境界/属性 | ✅ 完整 | ✅ 完整（回溯受降维护佑约束） | 不衰减 |
| 弟子/灵宠 | ✅ 随行 | ✅ 随行 | 养成线全程跟随 |
| 法宝/本命法器 | ✅ 随行 | ✅ 随行 | 核心战力跨区无损 |
| 功法/神通/法则 | ✅ 随行 | ✅ 随行 | 知识类不受限；高层法则在低层可能无施展场景 |
| 装备 | ⚠️ 受等级压制 | ✅ 可用，无衰减 | 低层装备带入高层因等级差被压制（GDD-08 ✅Q03） |
| 通用货币（灵石等） | ✅ | ✅ | 全区流通 |
| 层级专属资源 | —（产地即高层） | ⚠️ 限制带回 | 不可用于低层合成，仅作仓储/向上消耗 |
| 绑定/区域限定道具 | ❌ | ❌ | 仅限产出区域使用 |
- 随身仓机制
- 当玩家携带超出目标区规则的物品时，不删除，自动转入「随身仓库」冻结。
- 玩家回到合规区域后可取出。
-
随身仓容量、冻结时长、取出手续费由 GDD-21 定义。
-
穿越届壁代价
- 跨层移动（天启事件后首次进入新层除外）每次触发届壁消耗：
- 上行：目标层日均灵石产出 × 10
- 下行：当前层日均灵石产出 × 10
-
下界后限制（✅D15）：
- 本命法宝/法则类技能在低层自动封印；
- 本层专属材料不可带入低层，自动转入随身仓冻结；
- 在低层组织/帮派中显示为「访客」，不享受低层势力分红；
- 连续下界驻留上限 7 天（现实时间），到期自动归位至最高已天启层。
-
混沌污染特例
- 从 layer 5 混沌之渊带出的部分材料带「污染」属性，需在低层「净化」后方可正常使用，否则持有持续微量扣 SAN（GDD-08 §5.3）。
来源：GDD-08 §3.7、§5，TDD-04 §5.6。
2.5 区域聊天与广播隔离¶
目标：按层级与区域隔离信息，强化「身处一方天地」的沉浸感，并随天启逐步开放跨种族交流。
- 频道架构
| 频道类型 | 作用域 | 可见范围 | 备注 |
|---|---|---|---|
| 种族方言频道 | layer 0 出生地 | 本种族本出生地 | 炼气期主频道，带种族特色用语 |
| 区域频道 | 各 layer 当前所在区域 | 同区域玩家 | 进入即自动加入，离开即切换 |
| 洪荒共通语频道 | layer 1+ | 同层跨种族 | 首遇后解锁，跨种族交流主通道 |
| 势力频道 | layer 2+ | 同势力成员 | 跨区常驻，不随地图切换 |
| 队伍/私聊/师徒 | 全局 | 关系链 | 不受区域隔离；炼气期私聊对象仅限本族 |
| 混沌低语频道 | layer 5 | 同区域 | 受 SAN 影响，低 SAN 时显示扭曲/虚假信息 |
- 广播事件作用域
| 广播级别 | 触发事件举例 | 作用域 |
|---|---|---|
| 出生地广播 | 本族玩家炼气圆满天启、稀有本土资源刷新 | 本种族 layer 0 |
| 区域广播 | 世界 BOSS 刷新/击杀、灵潮/天灾事件开启 | 当前区域 |
| 首遇广播 | 玩家首次踏入洪荒边境、跨种族首次贸易 | layer 1 |
| 势力广播 | 领地易主、宗门战开战/结算 | 相关势力/区域 |
| 因果/法则/混沌广播 | 天罚降临、大道之争开启、旧日造物苏醒 | layer 3/4/5 |
| 全服广播 | 首位玩家天启新层、世界级 BOSS 归属 | 全服 |
- 附近的人
- 仅展示游戏内坐标最近的约 30 位玩家，随移动实时刷新。
- layer 0 仅显示本族玩家；layer 5 对 SAN 过低玩家显示混沌标记。
- 支持快捷交互：查看主页、加好友、邀请组队、发起切磋/挑战（受 PVP 规则约束）。
来源：GDD-08 §4、GDD-02 ✅46。
2.6 回溯低层与降维护佑¶
目标：允许玩家自由回溯已解锁低层，但系统必须防止恶意虐杀与经济掠夺。
- 回溯规则
- 已天启层级可随时返回，无需重新完成天启事件。
-
回溯不消耗穿越届壁费用；再次上行进入更高层时触发届壁消耗（GDD-08 §3.6）。
-
降维护佑（天道压制）
- 高境界玩家在低层对低层玩家造成伤害时，伤害按 GDD-21 定义的「降维系数」大幅削减。
- 被攻击的低层玩家获得临时保护增益（减伤、闪避、反伤等，由 GDD-21 定义）。
-
高境界玩家击杀低层玩家仍按低层规则累计戾气/触发追杀令（L2/L3）。
-
产出上限
- 高境界玩家在低层挂机/采集/战斗的产出，按「目标层产出上限」结算，不获取超额资源。
-
稀有资源掉落概率、经验/修为收益受低层上限封顶。
-
下界限制兜底
- 本命法宝与法则类技能在低层自动封印，作为降维护佑的补偿性限制。
-
连续驻留 7 天（现实时间）后，系统自动将角色归位至其最高已天启层；归位前 24 小时通过邮件/弹窗提醒。
-
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 数据层过滤¶
- 数据库隔离字段
characters表必须独立存储world_tier（当前世界层级）与max_world_layer（已解锁最高层），并建立复合索引(world_tier, realm_tier, minor_realm, power DESC)用于排行榜与匹配（TDD-04 §5.1、§10）。-
zone_id+world_tier作为区域查询主键维度，避免跨层数据串区。 -
查询默认过滤
-
所有涉及玩家列表、市场挂单、拍卖、悬赏、排行榜、附近的人、组队匹配的 SQL/API，必须默认追加
world_tier/realm_tier过滤；不允许提供无过滤的全服扫描接口。 -
缓存一致性
- 玩家当前层、已解锁最高层、随身仓状态等高频数据需写入 Valkey 缓存，TTL 与数据库更新事件联动失效。
3.2 实时/异步校验¶
- 实时校验
- 跨层移动、进入副本、传送、组队召唤等操作必须在请求处理链路中同步完成准入检查，响应时延 ≤ 200ms（P99）。
-
聊天/广播消息在 Nakama 频道路由前，根据发送者
world_tier+race_id确定投递范围。 -
异步校验
- 玩家上线、断线重连、跨服迁移后，异步任务校验角色当前位置与层级的合法性；异常位置自动纠正至最近合法安全区并记录审计日志。
- 降维护佑系数、产出上限、连续下界时长等数值每日 08:00（现实时间）统一结算与告警（GDD-02 ✅87）。
3.3 服务器分线策略¶
- 出生地分线
-
layer 0 出生地采用「同族独立实例 + 低容量上限」策略；满员时新建同族出生地副本，玩家无感知（GDD-08 §4.2.1）。
-
主城/坊市分线
-
主城/坊市按独立容量上限分线（如 500 人/线），满员时外区传送请求排队或提示「主城繁忙」。
-
野外大地图
-
野外大地图采用动态容量，环境敌人密度随人数弹性调整；超阈值时增加刷怪量，不强制分线。
-
副本/遗迹
- 副本实例化，每支队伍独立实例；满队直接开新实例，无排队。
来源：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，涵盖出生地隔离、天启触发、准入检查、跨层资源携带、区域聊天广播、回溯与降维护佑、非功能需求及验收标准。 |