外观
技术手册
「玩家设定 →」
技术手册面向开发者，以代码真实实现为准（来源优先级：yml 运行时配置 > DB 迁移最终态 > Java 常量 > balance 内置默认 > 旧 docs），与「游戏设定」分区一一配对。
阅读指引
| 你的问题 | 从哪看起 |
|---|---|
| 后端/前端/部署整体怎么组织 | 架构总览 |
| 某张表在哪个玩法、归属哪个迁移 | 数据模型索引 |
| 某个 yml 键什么意思、生效值多少 | 配置中心 |
| 某个玩法的 Controller/Service/表/数据流 | 玩法实现（与设定页配对） |
| 代码与旧文档不一致怎么办 | 差异审计（D1~D7） |
| 代码改了之后文档怎么同步 | 维护手册 |
| 数值到底来自哪个文件 | 设定来源索引 |
导航
玩法实现（与设定页一一配对，frontmatter pair 双向校验）
- 修炼养成 · 技术实现：境界 / 装备强化 / 装备淬炼 / 坐骑翅膀灵兽 / 肉身淬炼 / 称号 / 功法心法 / 磐石之力 / 天道法则 / 传承继承 / 飞升
- 战斗挑战 · 技术实现：地图挂机 / 训练与教练 / 烬渊挂机塔 / 成长塔 / 炼体秘境 / 破界深渊 / 无尽试炼 / 世界 BOSS
- 副本玩法 · 技术实现：余烬试炼场（烬塔 v2）/ 肉鸽秘境 / 打金副本 / 称号副本
- 社交交易 · 技术实现：交易行 / 推荐返利 / 世界喇叭与公告 / 排行榜
- 特权付费 · 技术实现：VIP / 月卡终身卡 / 冠名权 / 商城与点券 / 每日签到
全局页
- 架构总览 — 模块划分、三层调用链、Flyway V1~V92（4 个 Java 迁移）、配置分层、前端结构、部署
- 数据模型索引 — 约 90 张业务表按域分组 + 玩法页链接；无中央物品元数据表说明
- 配置中心 —
emberfall.*全量键、9 张 DB 配置表、@ConfigurationProperties类 - 差异审计 — D1~D7 差异总览 + 新增流程
- 维护手册 —
npm run sync工作流、STALE 处理、pair 维护、物品图鉴复核 - 设定来源索引 — 5 类来源文件清单 + data/ 产物对应表
阅读建议
- 开发者查实现：按玩法域进入 implementations，每页六节（代码位置 / 数据表 / 配置与常量 / 数据流简述 / 已知差异 / 相关代码）
- 查数值出处：先 source-index 定位来源文件，再到 config-center 或 data/ 产物核对
- 维护站点：读 维护手册，一切以
npm run sync输出为准
数据同步状态见构建时
verify报告；页面数值表如显示过期徽标，请运行npm run sync。