伟大航路反推来源清单 ¶
目标 ¶
本清单用于完成 OpenSpec 任务 1.1、1.2、1.3，把客户端、服务端、配置、测试和规则文本中的证据源统一收口，后续所有“服务端应实现什么”的判断都必须回溯到这里列出的来源。
一、客户端来源 ¶
1. 入口、阶段、规则与界面 ¶
| 来源 | 作用 | 反推出的服务端含义 |
|---|---|---|
client/assets/game/scripts/LegionEntranceDialog.js |
军团战入口分流 | 客户端区分普通军团战、ExLeague、GoldenLeague，服务端必须返回能驱动入口态的阶段信息 |
client/assets/game/scripts/LegionWarExLeagueDialog.js |
伟大航路规则页与阶段页 | 服务端必须支持五岛阶段展示和对应赛程态 |
client/assets/game/scripts/LegionWarExLeagueStage0.js |
初始阶段页面 | 服务端需要提供阶段、晋升、规则相关基础数据 |
client/assets/game/scripts/LegionWarExLeagueStage1.js |
中间岛屿阶段页 | 服务端需要提供岛屿阶段、排行、晋升提示所依赖的数据 |
client/assets/game/scripts/LegionWarExLeagueStage2.js |
黄金相关页面 | 服务端需要支持黄金联赛/黄金天宫阶段 |
client/assets/game/scripts/LegionWarExLeagueGoldenRankScoreDialog.js |
黄金积分与排行展示 | 服务端需要提供黄金积分和排行查询能力 |
client/assets/game/scripts/LegionWarEndedState.js |
战场结束后的收束逻辑 | 服务端返回的结束态必须能区分黄金 PvP、黄金 PvE、普通盐场态 |
2. 客户端协议与模块依赖 ¶
| 来源 | 作用 | 反推出的服务端含义 |
|---|---|---|
client/assets/game/scripts/data-index.js |
服务定义注册 | 存在 SaltRoadService，说明伟大航路不是纯文案，服务端应补齐相关接口 |
client/assets/game/scripts/LegionWarModule.js |
军团战主模块 | 服务端必须返回 battlefieldType、legionWarType、legionWarMapType 等字段 |
client/assets/game/scripts/LegionWarPlayer.js |
玩家精力、复活等本地状态消费 | 服务端需维护精力、复活次数、复活时间、状态迁移 |
client/assets/game/scripts/LegionWarPanel.js |
战场主面板 | 服务端需提供保护期、混战期、时间窗等字段 |
client/assets/game/scripts/SourceMap.js |
地图寻路与特殊地块逻辑 | 服务端需保证建筑类型、地块类型、盐场核心规则与客户端一致 |
client/assets/game/scripts/Tile.js |
单格 UI 逻辑 | 服务端需保证特殊建筑中心点、可点击性和状态展示字段正确 |
3. 枚举、阶段、地图类型 ¶
| 来源 | 作用 | 反推出的服务端含义 |
|---|---|---|
client/assets/0scripts/Configs.js |
LegionWarType、LegionWarMapType、阶段枚举 |
服务端至少要识别灰盐岛、青铜岛、秘蓝岛、月宫、黄金天宫及其周赛/月赛/胜者/败者/决赛类型 |
client/assets/game/scripts/types-tiled.js |
MapIDType、建筑类型、地图资源映射 |
服务端地图类型与建筑配置必须和客户端 tileset 口径一致 |
client/assets/0scripts/types-common.js |
LegionWarMapMapping 等开关枚举 |
服务端若部分开启伟大航路，必须与客户端开关口径兼容 |
4. 客户端规则文本与展示文案 ¶
| 来源 | 作用 | 反推出的服务端含义 |
|---|---|---|
client/assets/config/language.json |
伟大航路总规则、五岛规则、黄金联赛规则 | 服务端至少要覆盖文案中明确暴露的赛程、阶段、奖励与晋升淘汰结果 |
client/assets/game/scripts/language-codes.js |
文案 key 绑定 | 可用于定位客户端真正依赖的规则段落 |
5. 地图资源与特殊建筑 ¶
| 来源 | 作用 | 反推出的服务端含义 |
|---|---|---|
client/assets/IntroMap_02/map01.tmx |
旧盐场/灰盐岛主题 hex 地图 | 服务端建筑初始化、占点、寻路、盐场核心坐标体系需与 TMX 一致 |
client/assets/IntroMap_01、IntroMap_03、IntroMap_04、IntroMap_05 |
秘蓝岛、青铜岛、月宫、天宫主题地图 | 服务端至少要支持多 mapType 对应不同 mapId 和建筑配置 |
二、服务端来源 ¶
1. 赛程与查询 ¶
| 来源 | 作用 | 当前观察 |
|---|---|---|
server/domains/legion/war/saltfield/info.go |
赛程、报名查询、军团面板战场字段 | 当前仍写死 type=10、legionWarType=15、legionWarMapType=7、LW_WEEK-* |
server/domains/legion/war/saltfield/info_test.go |
赛程口径测试 | 测试同样验证固定周赛 ID 与 legionWarType=15 |
server/compat_ws_bridge.go |
legion_getbattlefield、legion_signup |
当前直接依赖 BuildWarInfo()，因此对外口径仍受固定周赛限制 |
2. 战场运行时 ¶
| 来源 | 作用 | 当前观察 |
|---|---|---|
server/saltfield_module_handlers.go |
根级兼容 handler | 已实现 war_enterbattlefield、war_getbattlefieldinfo、war_startmarch、war_startbattle、war_startattackbuilding、war_setbattleteam、war_getteaminfo |
server/battlefield_runtime_host.go |
战场 agent 侧与兼容逻辑 | 已有重进、观战、行军、战斗、攻城、广播等运行时规则 |
server/entry/account/wsentry/registry.go |
WS 注册表 | 上述战场指令都已对外注册 |
3. 地图与建筑配置 ¶
| 来源 | 作用 | 当前观察 |
|---|---|---|
server/internal/legionwarcfg/legion_war_config.go |
地图类型到 mapId、建筑配置缓存 | 已支持多 legionWarType + mapType 配置读取 |
server/config/config1.json |
SecondSeasonStart、LegionWarMapConf、LegionWarMapTypeMappingConf、建筑配置 |
已存在 20~24 的月宫/天宫伟大航路 mapType 与映射 |
4. 奖励、结算与相关文档 ¶
| 来源 | 作用 | 当前观察 |
|---|---|---|
server/compat_ws_bridge.go 中 saltfield settle 相关逻辑 |
排行奖励与结算入口 | 已有盐场奖励与结算基础设施，但未证明已按伟大航路多阶段收束 |
server/internal/saltfieldrewarddb/ |
奖励存储与读取 | 说明服务端已有排名奖励系统基础 |
server/domains/legion/war/saltfield/*.md |
历史分析文档 | 可作为补充说明，但不作为最终权威来源 |
三、配置与规则文本来源 ¶
| 来源 | 作用 | 当前观察 |
|---|---|---|
server/config/config1.json |
服务端最终配置基线 | 包含 SecondSeasonStart: 7 与多阶段 mapType 配置 |
server/config/language.json |
服务端规则文本 | 包含“伟大航路介绍”“灰盐岛规则”“青铜岛规则”“黄金天宫规则”等完整说明 |
四、证据使用规则 ¶
- 服务端当前强制行为优先于客户端展示文案。
- 客户端字段依赖优先于纯描述性规则文本。
- 配置存在不等于功能已实现，只能证明“有设计入口”。
- 测试若验证了固定旧口径，应视为“当前实现行为”，不能直接提升为目标设计。
- 无法由代码或配置直接证明的规则，必须标记为“待业务确认”或“待生产口径验证”。
评论
请登录后发表评论。
暂无评论。成为第一个评论者！