xuqinmin12/lawless
1
0
派生 0
代码 工单 合并请求 Actions 1 软件包 项目 版本发布 百科 动态
521603a899
lawless/docs/需求文档/PRD-02-境界隔离系统需求文档.md
徐勤民 521603a899
一些检测仍在等待运行
Docs Build / build-and-deploy (push) Waiting to run
详情
refactor(client): 删除游戏核心管理器和场景脚本 
- 移除 ConfigManager 配置管理器类
- 移除 GameManager 全局单例管理器类
- 移除 NetworkManager 网络连接管理器类
- 移除 CharacterData 和 ItemData 数据模型类
- 移除 BagScene、BattleScene、LobbyScene 等场景脚本
- 移除 EncounterBubble 和 EventFeedPanel UI组件脚本
- 更新代理邀请文档中的服务器连接方式
- 更新同步状态表格中的代理任务分配信息
- 添加 MiMo 任务完成总结和审查修复记录
2026-07-03 21:34:51 +08:00

18 KiB
原始文件 Blame 文件历史

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，涵盖出生地隔离、天启触发、准入检查、跨层资源携带、区域聊天广播、回溯与降维护佑、非功能需求及验收标准。