Skip to content

章节扩展规划:游戏开发知识体系扩展路线图 ​

本站的主场一直是游戏后端——实时性、一致性、并发与状态是这个站最有积累的部分,这个定位不变。但游戏开发是一个整体:做后端的人躲不开客户端的约束,做客户端的人需要理解服务端的裁决,策划、测试、运营与工程的协作质量直接决定产品上限。本页是站点从「游戏知识体系」扩展为完整的游戏开发知识体系的路线图:盘点现有覆盖,列出补齐计划与落地节奏。

状态(2026-09):首轮扩展已全部落地——19/20/21 三讲均进入侧边栏「扩展」分组,历史线与游戏库两个横向入口均已纳入导航。本页保留为扩展过程的记录与后续增量的登记入口。


1. 为什么扩展 ​

两个现实原因:

  1. 后端知识无法孤立成立。第 03 讲讲前端引擎,是因为客户端的平台约束反向决定服务端设计空间;第 12 讲讲数据分析,是因为服务端流水是分析的事实基础。同样的道理,渲染管线、资源加载、UI 框架这些"前端的事"里,藏着大量需要前后端共同决策的问题(响应体积、加载策略、预测与纠偏)。
  2. 协作是知识体系的一部分。美术管线怎么出资源、QA 怎么验证版本、音频怎么进工程——后端工程师不需要会做,但需要知道接口在哪、成本在哪、什么时候该喊停。

2. 现有覆盖盘点 ​

以「游戏开发知识体系」的标准盘点现状(教程 21 讲 + 知识库主线 18 章 + 附录 A1–A6):

领域覆盖状态现有内容
后端架构与并发✅ 完整05/07 讲,知识库 3–7 章;第九批:第 07 讲第 13 节实战案例「一次『同屏不同血』的帧同步确定性排查」——回链第 3 节确定性坑 / 第 5 节 Tick 主循环与频率表 / 第 6 节定时器方案表,回填确定性清单「时间」第四变量(配套 tests/case-lockstep-desync.test.mjs 三查用例);第十二批:第 05 讲实战案例「一次『重启就好』的高峰队列失控排查」(小结前无编号节)——回链流控与背压三件套 / 退化顺序四层 / 陷阱清单第 3 条「无界队列」/ 单写者骨架 roomQueueSize=4096,回填队列有界化与超限四选一、队列深度指标进面板(配套 tests/case-queue-backpressure.test.mjs 三查用例)
网络与同步✅ 完整04 讲,知识库 3/4 章;第八批:第 04 讲第 15 节实战案例「一次战斗中『角色倒着走』的同步回滚排查」——回链 2.3 三件事 / 4.4 竞技组合 / 6.3 分片重组 / 10.1 广播放大器 / 10.2 语义裁剪 / 10.3 断流现实 / 12 协议 Checklist,回填协议契约的广播预算与新旧覆盖纪律(配套 tests/case-sync-rollback.test.mjs 三查用例)
数据、缓存与运维✅ 完整08/13 讲,知识库 11/12/16 章 + 附录 A4;第十六批:第 16 讲第 6 节实战案例「一次『校验全过、运行才崩』的热更兼容排查」(与知识库 16 章同源)——回链 4.2 体系六层能力 / 4.3 兼容表第 1 行「接口依赖」 / 4.4 兼容矩阵与 rollback_target / 4.5 灰度五阶段 / 4.6 测试 P0 三项 / 5.3 误区表第 1 行,回填兼容矩阵 4 字段、灰度五阶段与崩溃按宿主版本 × 补丁层级拆分上报(配套 tests/case-hotfix-compat.test.mjs 三查用例)
数值/经济/玩法✅ 完整02/10/11 讲;第十三批:第 02 讲第 14 节实战案例「一次『攒了 45 抽白攒』的保底清零排查」——回链 1.2 接需求四问第 3 问 / 4.3 保底状态机与换池显式化 / 4.4 概率审计留痕 10 字段 / 4.5 公示四条第 2 条 / 12 节 Checklist 第 9 条,回填换池规则配置化与公示文本对账进 CI(配套 tests/case-pity-reset.test.mjs 三查用例);第十四批:第 11 讲第 12 节实战案例「一次『一赢就排到怪物』的匹配震荡排查」——回链 2.2 Elo 局限第 2 条与期望公式 / 2.3 分段 K 与 RD 参数 / 2.5 质量双指标与陷阱缓解两条 / 第 11 节陷阱表第 1 行,回填分段 K、单场限幅与分差 P90 双指标告警(配套 tests/case-match-oscillation.test.mjs 三查用例)
数据分析/运营/安全✅ 完整12/18 讲,知识库 14/17 章
引擎与客户端(服务端协作视角)✅ 完整03 讲,知识库 8 章 + 附录 A5;本批正活(引擎专章补全):第 03 讲新增第 5 节 Godot 专章(开源定位与买断制独立游戏 / MultiplayerAPI 房间对等心智与权威服务端对接 / 协议对接 / 常见问题与服务端应对 / 与 Unity 取舍 / GodotSteam 与多端发行含 Web 导出 COOP/COEP)与第 6 节 LayaAir 专章(小游戏生态定位与三代引擎 / Socket 网络层与 Byte 二进制 / 协议对接含 AS3 存量 / 小游戏约束与服务端应对 / 与 Cocos Creator 取舍),原第 5–12 节顺延为第 7–14 节、陷阱表增至 10 行;第十五批:第 03 讲第 14 节实战案例「一次『切个微信就要重新登录』的切后台误判掉线排查」——回链 2.1 超时推导公式与 suspend/resume 显式挂起 / 2.3 补发窗口与快照兜底 / 3.4 适配清单第 4 条 / 第 9 节会话骨架 / 第 12 节陷阱表第 1 行,回填 suspend/resume + 15 分钟宽限期、1000 条补发窗口与误判掉线率按平台分列监控(配套 tests/case-suspend-misjudge.test.mjs 三查用例,回链节号随本批顺延同步更新)
客户端架构与渲染(前端本体)✅ 完整第 19 讲已落地渲染管线成本模型、UI 三态交互、动画/逻辑状态机、资源加载与内存预算、前端性能归因;性能深水区(渲染指令级优化)已以实战案例落地——第七批:第 19 讲第 9 节「新地图 24 帧的渲染指令归因」(DC/材质/过绘/LOD 四本指令账 + 资产审计门禁回填)
QA 测试与质量保障✅ 完整第 20 讲已落地测试金字塔四层(单测/协议回放/机器人对局/冒烟门禁)、机型矩阵与归属判定、可测性四纪律、性能验收门槛;第十批:第 20 讲第 11 节实战案例「一次『只能等它发生』的时序 bug 逃逸排查」——回链第 2 节四关卡 / 第 3 节金字塔四层 / 第 5 节可测性四纪律 / 第 7 节 Clock 代码 / 第 9 节陷阱表,回填 time.Now 门禁与时间维度质量口径(配套 tests/case-time-trap.test.mjs 三查用例)
音频与美术管线✅ 完整第 21 讲已落地资源管线全景、美术管线四件事、音频触发模型、跨职能成本接口;第十一批:第 21 讲第 9 节实战案例「一次『42MB 不该进包』的资源审计排查」——回链 2.3 下线三步 / 2.4 审计四规则 / 4.1 变更观 / 4.2 三层归属 / 第 5 节门禁骨架 / 第 7 节陷阱表,回填审计四规则进 CI 与补丁包体红线(配套 tests/case-asset-audit.test.mjs 三查用例)
方法论/模式与工程组织(基础横向)✅ 完整01/06/09/14/15 讲;第十七批·1/5:第 01 讲实战案例「一次『按 MMO 建了一套架构,却死在开局』的分型误判排查」——回链附录六问分型 / 问题模型分型表第 1 行「单局房间型」五件事 / 速查表「派对/房间制轻竞技」行 / 识别主导模型三维度 / 模型组合两个危险做法,回填六问分型进立项评审、房间型五件事进排期门禁(配套 tests/case-model-typing.test.mjs 三查用例);第十七批·2/5:第 06 讲实战案例「一次『迁移后移动一卡一卡』的隐式行为遗漏排查」——回链选型决策树「射击/动作(小规模)」行 / 阶段五「手游快速上线」Photon 推荐 / 迁移指南「从 Photon 迁移到自行开发」五步与隐式实现之坑 / 渐进式替换原则,回填行为快照清单进迁移验收、SDK 隐式行为盘点进升级评审(配套 tests/case-framework-migration.test.mjs 三查用例);第十七批·3/5:第 09 讲实战案例「一次『结算奖励多发 7 份』的进程级单例误用排查」——回链单例模式的谨慎警告(全局状态伪装/状态重置不该做单例)/ 服务定位器全局查找与 DI 优先 / 决策表「全局唯一的服务」与「全局服务的注册查找」两行,回填服务注册按生命周期分层进服务骨架、单例准入与 DI 优先进评审清单(配套 tests/case-singleton-misuse.test.mjs 三查用例);第十七批·4/5:第 14 讲实战案例「一次『私下改的奖励逻辑,合服后炸出 2100 笔异常』的变更分级失效排查」——回链第 5 节变更分级表三级与冻结期两档 / 成本量化原话(半天/两天/下版本)/ 两个退化极端与一刀切预言 / 陷阱表「变更一刀切」行,回填变更分级入口进提单模板、私下变更哨兵进上线门禁(配套 tests/case-change-triage.test.mjs 三查用例);第十七批·5/5:第 15 讲实战案例「一次『同一个坑踩了两遍』的知识沉淀排查」——回链第 4 节四类沉淀方法(归档/checklist/评审/复盘)与第 5 节总结五条(输出倒逼输入/从失败中学习/建立知识体系)/第 14 讲「同类故障再现先查改进项为何未落地」口径,回填复盘归档带坑签名进仓库、类修复进 checklist 与 CI、历史坑 Top 10 进 onboarding(配套 tests/case-knowledge-capture.test.mjs 三查用例)
后端引擎源码解析(源码级新系列)⚠️ 部分(系列展开中)附录 A6 新系列「游戏后端引擎源码解析」:已落 skynet 篇(server/skynet,统一 10 节框架 + 与其他引擎对比 / 设计优缺点与取舍 / 适用游戏场景三节,引用均带 文件:行号,源码出处行注明上游仓与 commit);KBEngine/BigWorld/Pitaya/Nakama/Colyseus 等首批篇目与横向对比总篇在计划内
系统策划/玩法设计(策划视角)⚠️ 部分02/10 讲从服务端实现视角覆盖,策划视角不做为补齐重点(站内定位)

3. 补齐计划 ​

新增讲次续接教程编号(19 起,不改动 01–18 的既有序号与互链),归入教程侧「专题」之后的「扩展」分组:

19 客户端架构与性能基础(前端向总纲)✅ 已落地 ​

  • 渲染管线基础:Draw Call、批处理、LOD、合批与烘焙——只讲到"后端工程师需要理解的成本模型"深度
  • UI/UX 工程基础:UI 框架层级、事件穿透、界面与网络的交互模式(加载态/错误态/重试态)
  • 动画与状态机:动画状态机与游戏逻辑状态机的对应关系(与第 09 讲状态模式互链)
  • 资源加载与内存预算:分包、卸载策略、内存水位与后端下发数据量的协同(与第 03 讲小游戏约束互链)
  • 前端性能:帧率预算、卡顿归因、首包时间——性能问题怎么按"谁的责任"分层

20 游戏测试与质量保障(质量向)✅ 已落地 ​

  • QA 流程体系:提测/验收/回归/出包的流程与责任边界
  • 自动化测试分层:协议级回放测试、逻辑单测、机器人对局、冒烟测试(与第 17 讲发布管线互链)
  • 兼容性测试:机型矩阵、平台差异(与第 03 讲平台约束互链)
  • 服务端如何为可测性设计:确定性随机、时间可控、影子流量(与第 02 讲确定性随机互链)

21 音频与美术管线协作(跨职能向)✅ 已落地 ​

  • 美术管线:资源规格、命名与版本、导入导出工具链、资源审计
  • 音频基础:音频资源体系、触发与混音的服务端关联(如 BGM 切换跟随服务器状态)
  • 跨职能协作的成本接口:需求变更的代价评估、资源出问题时的排障路径

深化而非新开(不占新编号) ​

  • 数值与经济设计深化:第 02 讲已有服务端视角完整覆盖,策划方法论不在本站主场
  • 数据分析深化:第 12 讲已覆盖;已补第 13 节实战案例「一次『报表收入下滑 12%』的完整排查」(口径分歧→维度拆分→支付漏斗→根因处置→回填清单)。第二批已落第 10 讲第 13 节实战案例「一次『合服后 23 笔充值未发货』的完整排查」(对账闭环→时间窗交集→停写在途盲区→止血与回填);第三批已落第 08 讲第 11 节实战案例「一次『主从切换回档』后的充值补账排查」(对账锁窗→半同步静默降级→恢复边界与回填)。三批构成数据正确性三联画:口径、重复、丢失(六批均已配套案例冒烟/集成用例);第四批已落第 13 讲第 11 节实战案例「一次『监控全绿』的整点活动卡顿排查」(口径对齐→分层归因→缓存击穿与整点三源叠加→处置回填);第五批已落第 18 讲第 7 节实战案例「一次『金币通胀 15%』的刷金工作室排查」(产出口径拆分→账号与流向聚类→渐进式根因→处置回填);第六批已落第 17 讲第 8 节实战案例「一次灰度『次日留存 -8pt』的口径与崩溃排查」(口径统一→机型档位聚类→图集规格根因→定向停发与回填),后续仍按案例增量补充;第七批起转入讲义本体案例增量:第 19 讲渲染指令归因(七)、第 04 讲同步回滚(八)、第 07 讲帧同步确定性(九)、第 20 讲时序 bug 逃逸(十)、第 21 讲资源审计(十一)、第 05 讲队列背压(十二)、第 02 讲保底清零(十三)、第 11 讲匹配震荡(十四)、第 03 讲切后台误判掉线排查(十五,回链超时推导与 suspend/resume 会话骨架)、第 16 讲热更兼容排查(十六,回链兼容表第 1 行 / 体系六层 / 灰度五阶段 / 测试 P0 三项);第十七批为教程实战案例补全:第 01 讲分型误判排查(1/5,回链附录六问分型与房间型五件事)、第 06 讲隐式行为遗漏排查(2/5,回链 Photon 迁移指南与阶段五选型)、第 09 讲进程级单例误用排查(3/5,回链单例谨慎警告与服务定位器)、第 14 讲变更分级失效排查(4/5,回链变更分级表与一刀切陷阱)、第 15 讲知识沉淀排查(5/5,回链四类沉淀方法与复盘纪律)——至此 21 讲全部配有实战案例,教程案例全覆盖;知识库案例试点同步推进:第 4 章 05 页回溯判定争议排查(试点 1/N,回链状态三层与五项时序日志)、06 页确定性分叉排查(2/N,回链分叉来源七条与稳定顺序/随机流/状态哈希三节)、第 5 章 05 页锁竞争排查(3/N,回链代价清单与治理顺序四步);按章顺延批已落第 3 章三页:01 主链路被外围流量拖慢排查(回链消息语义五类与连接/会话/消息三件事)、04 字段变更排查(回链演进灾难清单与错误码三层)、06 重复与顺序排查(回链可靠性五问与局部顺序);第二章落第 4 章四页:sync/01 渲染时间与逻辑时间错位排查(回链四种时间与多时钟分层)、sync/02 同步模型误判排查(回链模型四问与依赖清单)、sync/03 帧包乱序排查(回链输入窗口与哈希检查点)、sync/04 重连追帧排查(回链恢复档位与权威暂停语义),知识库案例节 17 → 20 → 24;第三章落第 5 章四页:runtime/01 并发化误判排查(回链状态隔离与混合式落点)、runtime/02 隐式状态与队列堆积排查(回链显式状态机与队列治理四件套)、runtime/03 帧预算污染排查(回链 Tick 顺序与预算)、runtime/04 背压与优先级排查(回链容量上限与退化顺序),知识库案例节 24 → 28;第四章落第 6 章四页:services/02 网关业务总线化排查(回链网关职责边界与边界污染三形态)、services/03 控制平面缺失排查(回链控制面能力六条与迁移回滚语义)、services/04 路由过期排查(回链四类路由与治理规则五条)、services/05 重复副作用排查(回链幂等补偿与重连语义五问),知识库案例节 28 → 32;第五章落第 7 章四页:capacity/01 容量推演断链排查(回链压测失真来源与拐点水位)、capacity/02 弹性边界排查(回链组件弹性分级与缩容防抖)、capacity/03 撞号漏改排查(回链引用完整性与执行纪律)、capacity/04 多地域归属排查(回链一致性取舍与平台化),知识库案例节 32 → 36;第六章落第 17 章四页:security/02 审计脱敏排查(回链可追责五问与治理方式)、security/03 风控闭环排查(回链闭环五层与处罚梯度)、security/04 合规后置排查(回链硬约束前置与三层拆分)、security/05 依赖盘点排查(回链许可坑点与治理方式),知识库案例节 36 → 40;第七章横向页:aoi 可见集漏更新排查(回链 Problem 平方账与 Algorithm 迟滞)、language 运行时选型排查(回链按榜单选与选型四问)、map 形态错配排查(回链形态错配与自建清单)、skynet 边界误判排查(回链厘秒精度与适用场景),知识库案例节 40 → 44;第八章落第 4、5 章余页:runtime/00 并发立场错配排查(回链七类立场与判断四问)、runtime/06 边界误判排查(回链 Epoch 一级概念与不适用清单)、sync/07 证据链后补排查(回链证据链六项与观战隔离)、sync/08 脚本化堆叠排查(回链运行时骨架与效果管线),知识库案例节 44 → 48;第九章落第 3 章余页:networking/02 接入层职责混淆排查(回链五层拆分与背压四策)、networking/03 传输层选型排查(回链语义三步与选择框架五问)、networking/05 边界失控排查(回链五类交互与广播四层)、networking/07 弱网恢复排查(回链补发分档与监控七项),知识库案例节 48 → 52;第十一章落第 7 章 networking/ipc 余页:ipc/01 场景边界误判排查、ipc/02 通信模式错配排查、ipc/04 背压缺失排查、ipc/05 唯一身份缺失排查、ipc/06 选型顺序倒置排查,知识库案例节 52 → 57;第十二章落第 8 章 client/ 其余四页(知识库目录号与章号错位,第 8 章现于 client/):client/01 技术栈责任划分排查(回链三层责任清单与跨层改动计数)、client/02 裁决权漂移排查(回链权威先行与裁决归属评审)、client/03 资源供应链排查(回链五层资源分组与依赖图校验)、client/05 关键裁决前置排查(回链谨慎特征四条与落地顺序),知识库案例节 57 → 61;第十三章落第 8 章余页:client/input 输入时序漂移排查(回链管线五段、手感三口径与触屏多设备)、engines/01 分成基数口径排查(回链授权光谱、收入结构叠加与隐性条款)、engines/02 选型顺序倒置排查(回链决策顺序、存量技能折算与多语言边界)、engines/03 消化能力排查(回链消化能力上限、管线优先与垂直切片),知识库案例节 61 → 65;第十四章落第 19 章 client/web 余页:web/02 渲染归因排查(回链提交账与显存账两本账)、web/03 架构缺位排查(回链引擎职责边界与适配验收)、web/04 UI 体系排查(回链列表池化与读状态渲染)、web/05 移植排查(回链包体三板斧与生命周期协议)、web/06 分层缺失排查(回链固定时步与单向数据流),知识库案例节 65 → 70,后续按章顺延低优先小步继续
  • 运营与安全合规:第 13/18 讲 + 知识库 14/17 章已完整

4. 横向内容(已落地) ​

两个跨前后端的横向入口,均已落地并纳入导航:

  • 游戏发展历史线:1970s–2020s 年代轴上的八轨交互时间线——游戏发展、硬件(含显卡)、前端技术、后端技术、知名引擎、玩法、美术风格、公司与代表作八条互相互链的轨道(GSAP ScrollTrigger 驱动概览轴游标),设计稿与首批 76 条清单见 docs/history/,与现有讲次互链
  • 知名游戏库:按玩法类目组织的代表作条目库,每条以后端技术视角写(服务器架构、同步模型、匹配、实时通信、存储与反作弊),作为知识体系的索引入口

5. 落地节奏 ​

内容按批次推进,每批独立提交并通过站点测试与构建:

  1. 本页规划落导航——✅
  2. 游戏发展历史线——✅ 已落地,纳入导航
  3. 知名游戏库——✅ 已落地,纳入导航
  4. 19/20/21 讲正文(按优先级逐讲落地,每讲落成后加入侧边栏并更新本页状态)——✅ 已全部落地(见「扩展」分组,19/20/21 三讲齐)

路线图四步与两个横向入口均已全部落地。本页此后作为扩展过程的记录:新领域(如策划方法论等)如需补齐,先在「现有覆盖盘点」登记状态,再按批次推进。


6. 站内链接与内容清单核对(2026-10) ​

起因:全量覆盖率核对确认站点源码已无可补缺口(下述「覆盖率口径」),按约定转入站内链接与内容清单核对,结论入档于本节,并固化为 tests/site-links.test.mjs 随全量测试回归。

覆盖率口径(无可补缺口的依据):全量 pnpm test 覆盖率四项均达标(语句 100%、分支 100%、函数 100%、行 100%——历史线八轨的 GSAP 动态导入、滚轮/拖动边界与 Math.min/max 夹取等分支已全部补齐用例,coverage 阈值同步提至 100 并随测试回归),text 报告「No files with missing coverage」;vitest.config.mjs 的 coverage.include 共 11 个文件,与站点可执行源码集一一对应——docs/.vitepress/theme/ 下 10 个源码文件(index.js、GamesLibrary.vue、MermaidDiagram.vue、ReadingProgress.vue、renderDiagram.js、HistoryAxis.vue、HistoryTimeline.vue、data/games.mjs、data/homepage.mjs、data/timeline.mjs)全部已 instrument,另加 config.mjs(纯静态配置对象,0/0 已登记理由);docs/index.md 与 docs/games/index.md 的内联 script 只做数据装配,逻辑全在已覆盖的 homepage.mjs 与组件内。

链接核对(断链 0):config.mjs nav/sidebar 共 241 个 link(重复出现按目标去重;2026-10 前端批次新开第 19 章《Web 游戏前端体系》25-web-frontend/,6 页 + 导览;数值批次新开第 20 章《策划与数值体系》26-design-numerics/,8 页 + 导览;link 数随之 194 → 201 → 210 → 212 → 215 → 216 → 218 → 220 → 228 → 231 → 234 → 240,+2 为知识图谱新树 /server/ 侧边栏组与 AOI 节点,+3 为 /system/ 玩法系统侧边栏组,+2 为玩法系统技能与结算两新节点,+2 为 server 树「语言与选型」侧边栏组(服务端语言与运行时、开源服务器地图),+1 为 client 树「交互与输入」横向节点,+1 为 industry 树「职业地图」横向节点,+1 为 system 树玩法系统组新增「品类与组件覆盖对照」节点,+1 为 glossary 树新增「英文术语与词源」词汇速查节点,+4 为玩法系统组新增任务、成就与图鉴、体力与次数门控、装备强化与升星四节点,+3 为玩法系统组新增签到福利兑换码、战令赛季轨、走马灯公告三节点,+3 为玩法系统组新增外观装扮、家园领地、游戏内语音三节点,+6 为新增「调研与知识点」侧边栏组(知识点总览、调研总览与三调研一差异表);client 树迁移把 10-client-engine-runtime/、25-web-frontend/、22-engine-language-tooling/ 并为 client/、client/web/、client/engines/ 并新增 /client/ 侧边栏键,目标一一改名、按去重口径 link 数不变);operation 树迁移把 16-operations-bi/、18-observability-debugging/ 并为 operation/bi/、operation/observability/ 并新增 /operation/ 侧边栏键(13 条目标与改名后的 / 组重合,按去重口径 link 数不变);industry 树迁移把 01-methodology/、02-models/、08-game-genres/、21-platforms-sdks/ 并为 industry/methodology/、industry/models/、industry/genres/、industry/platforms/ 并新增 /industry/ 侧边栏键(29 条目标与改名后的 / 组重合,按去重口径 link 数不变);design 树迁移把 09-problem-domain/ 并为 design/problem-domains/ 并新增 /design/ 侧边栏键(7 条目标与改名后的 / 组重合,按去重口径 link 数不变);numerical 树迁移把 26-design-numerics/ 并为 numerical/ 并新增 /numerical/ 侧边栏键(9 条目标与改名后的 / 组重合,按去重口径 link 数不变);glossary 树迁移把 00-terminology/ 并为 glossary/ 并新增 /glossary/ 侧边栏键(10 条目标与改名后的 / 组重合,按去重口径 link 数不变);server 树迁移把 04-sync-combat/、05-concurrency-runtime/、06-services-control-plane/、19-capacity-scaling/、20-security-compliance/ 并为 server/sync/、server/runtime/、server/services/、server/capacity/、server/security/ 并把 /server/ 侧边栏键扩为七组(41 条目标与改名后的 / 组重合,按去重口径 link 数不变);server 树五棵子树全部按七段节点格式改造、不改页数;脚本与通用服务两章并入 system 树(11-scripting-hotfix/ → system/scripting/、15-common-services/ → system/services/,/system/ 侧边栏键扩为四组并新增树根 /system/,目标与改名后的 / 组重合后仅树根为新目标,link 数 215 → 216;两章 8 页按七段节点格式改造、不改页数),按 cleanUrls 口径(/xx/yy → xx/yy.md 或 xx/yy/index.md)全部解析到存在的 md;正文绝对内链 716 条、相对内链 249 条全部可达(第 19 章新增 22 条、第 20 章新增 25 条,均为导览与章间互链;历史线八轨页重构移除旧三线静态表中的 10 条绝对互链、回填 2 条章节互链,合计 66 → 58;历史线页另补 2 条指向同目录设计稿与节点清单的相对内链,相对内链 141 → 143;知识图谱样板节点 AOI 新增 3 条,58 → 61;system 树 3 页新增绝对互链 4 条、姊妹节点相对互链 7 条,61 → 65、143 → 150;database 树节点化不改页数,cache/01 回链 system 树排行榜新增 1 条绝对互链,65 → 66;operation 树根总览新增 2 条子树导览绝对链,66 → 68;其两个子树导览各回链树根 1 条相对链,150 → 152;industry 树根总览新增 4 条子树导览绝对链,68 → 72,四个子树导览各回链树根 1 条相对链,152 → 156;design 树根总览新增 1 条子树绝对链,72 → 73,子树导览回链树根 1 条相对链,156 → 157;server 树根总览新增 5 条子树导览绝对链与 2 条横向节点链(AOI、Skynet),73 → 80;五个子树导览各回链树根 1 条相对链,157 → 162;system 树根总览新增 3 个玩法节点与 2 个子树导览绝对链,80 → 85;system 两子树导览各回链树根 1 条相对链,162 → 164);server 树的 Skynet 源码解析页补齐七段节点格式(13 个小节降为 Algorithm 子节,节号与站内「第 N 节」引用保持不变,正文逐字保留),其 Used By 回指 7 个节点、Related 回指 3 个节点新增绝对内链,85 → 95;引擎档案回收把 BigWorld(088d3b84)/KBEngine(0bc93d5)/Pitaya(eaacc47)/Nakama(e920249)/Colyseus(e620123)/Leaf(af71eb0)/Nano(dbf22c7)/Orleans(b1b557d)/Agones(5366fb7)/skynet(64391f7)十仓的源码事实(文件:行号,commit 锚定)织入 24 个节点的 Used By(runtime 六页、sync 三页、services 五页、capacity 一页、security 两页、database 三页、system 四页;不增内链,计数不变);玩法系统新增两节点:技能系统(system/skill.md,五部件边界与扩展四问,Used By 织入 BigWorld 088d3b84/skynet 64391f7/Colyseus e620123)与结算(system/settlement.md,凭证与幂等,Used By 织入 BigWorld 088d3b84/Colyseus e620123);system 树根「三节点」扩为「五节点」,sync/08、security/01、sync/index 三处「待写」指涉改为真链;两新文件新增绝对内链 16 条、相对内链 8 条,树根与三处指涉新增绝对链 5 条,绝对内链 95 → 116、相对内链 164 → 172;server 树新增两横向节点:服务端语言与运行时(server/language.md,运行时四型与选型四问,Used By 织入 BigWorld 088d3b84/KBEngine 0bc93d5/skynet 64391f7/Nakama e920249/leaf af71eb0/nano dbf22c7/Colyseus e620123/Orleans b084e03)与开源服务器地图(server/map.md,四形态地图与选型链路,Used By 织入 Colyseus e620123/Nakama e920249/skynet 64391f7/BigWorld 088d3b84/KBEngine 0bc93d5/leaf af71eb0/nano dbf22c7);engines 三页「待写」指涉改为真链;两新文件新增绝对内链 20 条、相对内链 5 条,server 树根与 engines 三页新增绝对链 6 条,绝对内链 116 → 142、相对内链 172 → 177;client 树新增交互与输入横向节点(client/input.md,管线五段与手感三口径,Used By 为场景口径不织引擎);web/04「待写」指涉改为真链(+1 绝对)、client 树根本章清单补 1 条相对链(+1 相对),input.md 新增绝对内链 12 条,绝对内链 142 → 155、相对内链 177 → 178;industry 树新增职业地图横向节点(industry/career.md,岗位四族×项目输入与成长流动三口径,Used By 为场景口径不织引擎);retro/05「待写」指涉改为真链(+1 绝对)、industry 树根导览补 1 条横向节点链(+1 绝对),career.md 新增绝对内链 14 条、相对内链 1 条(回链树根),绝对内链 155 → 171、相对内链 178 → 179;玩法品类覆盖对照新增 1 篇(system/genre-coverage.md,21 品类 × 46 组件的三档判定与 11 个缺口),页内绝对内链 100 条,system 树根导览补 1 条对照链,绝对内链 171 → 272;覆盖对照页补逐表结论与「可参考分析」节,页内绝对内链 100 → 109,绝对内链 272 → 281(相对内链与锚点内链不变);glossary 树新增英文术语与词源速查 1 篇(glossary/10.md,57 条词条按网络同步/引擎运行时/玩法品类/数值经济四组收录,页内绝对内链 74 条,绝对内链 281 → 355;树根收录清单补 1 条相对链,相对内链 179 → 180);玩法系统丰富批次新增四节点:任务(system/quest.md,进度模型/事件推进/链式前置/交付提交点)、成就与图鉴(system/achievement.md,只增计数/事件源标签/自动发奖)、体力与次数门控(system/stamina.md,惰性恢复/服务器日窗口/限购幂等)、装备强化与升星(system/enhance.md,失败策略/保底/传承),四页新增绝对内链 13 条、相对内链 24 条,绝对内链 355 → 368、相对内链 180 → 204;丰富批第二批新增三节点:签到福利与兑换码(system/checkin.md)、战令与赛季轨(system/battle-pass.md)、走马灯与公告(system/marquee.md),三页新增绝对内链 5 条、相对内链 26 条,绝对内链 368 → 373、相对内链 204 → 230;丰富批第三批新增三节点:外观皮肤与装扮(system/cosmetics.md)、家园领地与建造权限(system/territory.md)、游戏内语音(system/voice.md),三页新增绝对内链 20 条、相对内链 18 条,绝对内链 373 → 393、相对内链 230 → 248;覆盖对照页缺口回填(11 项判定翻转、逐项补落点链接 22 条、移除失效落点 9 条),页内绝对内链 109 → 131,绝对内链 393 → 406;词汇速查页随丰富批扩充 17 条(网络穿透与服务器形态、引擎脚本与 GC、品类与外观、付费分层),页内绝对内链 74 → 91,绝对内链 406 → 423;调研收拢批:并行批次的 docs/research/ 三篇入库(research/01-authoritative-books.md、research/02-engine-middleware-docs.md、research/03-application-scenarios.md,页内绝对内链 51 + 41 + 34 = 126 条),补齐中断批缺页——调研总览(research/index.md,绝对内链 11 条)与覆盖差异表(research/04-coverage-diff.md,绝对内链 18 条),03 篇落点 slug 回核为实际篇名(task→quest、equip-enhancement→enhance、homestead→territory、checkin-welfare→checkin、notice→marquee,条数不变),新增调研知识点总览(knowledge.md,绝对内链 138 条),调研收拢批合计新增绝对内链 293 条,绝对内链 423 → 716;知识库案例按章顺延批:第 3 章 networking/01.md、networking/04.md、networking/06.md 三页各补一个实战案例节(主链路被外围流量拖慢、字段变更、重复与顺序),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 17 → 20 与 kb-case- 用例一一对应;案例按章顺延第二章:第 4 章 server/sync/01.md–04.md 四页各补一个实战案例节(渲染时间与逻辑时间错位、同步模型误判、帧包乱序、重连追帧),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 20 → 24 与 kb-case- 用例一一对应;案例按章顺延第三章:第 5 章 server/runtime/01.md–04.md 四页各补一个实战案例节(并发化误判、隐式状态与队列堆积、帧预算污染、背压与优先级),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 24 → 28 与 kb-case- 用例一一对应;案例按章顺延第四章:第 6 章 server/services/02.md–05.md 四页各补一个实战案例节(网关业务总线化、控制平面缺失、路由过期、重复副作用),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 28 → 32 与 kb-case- 用例一一对应;案例按章顺延第五章:第 7 章 server/capacity/01.md–04.md 四页各补一个实战案例节(容量推演断链、弹性边界、撞号漏改、多地域归属),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 32 → 36 与 kb-case- 用例一一对应;案例按章顺延第六章:第 17 章 server/security/02.md–05.md 四页各补一个实战案例节(审计脱敏、风控闭环、合规后置、依赖盘点),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 36 → 40 与 kb-case- 用例一一对应;案例按章顺延第七章横向页:server/aoi.md、server/language.md、server/map.md、server/skynet.md 四页各补一个实战案例节(可见集漏更新、运行时选型、形态错配、边界误判),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 40 → 44 与 kb-case- 用例一一对应;案例按章顺延第八章:第 5 章 server/runtime/00.md、server/runtime/06.md 与第 4 章 server/sync/07.md、server/sync/08.md 四页各补一个实战案例节(并发立场错配、边界误判、证据链后补、脚本化堆叠),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 44 → 48 与 kb-case- 用例一一对应;案例按章顺延第九章:第 3 章 networking/02.md、03.md、05.md、07.md 四页各补一个实战案例节(接入层职责混淆、传输层选型、消息模式边界失控、弱网恢复),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 48 → 52 与 kb-case- 用例一一对应;案例按章顺延第十一章:第 7 章 networking/ipc/01.md、02.md、04.md、05.md、06.md 五页各补一个实战案例节(场景边界误判、通信模式错配、背压缺失、唯一身份缺失、选型顺序倒置),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 52 → 57 与 kb-case- 用例一一对应;案例按章顺延第十二章:第 8 章 client/01.md、02.md、03.md 与 05.md 四页各补一个实战案例节(技术栈责任划分、裁决权漂移、资源供应链、关键裁决前置),案例体不带内链,绝对内链 716 条、相对内链 248 条、md 245 篇、config 240 个 link 均不变,知识库案例节 57 → 61 与 kb-case- 用例一一对应;带 # 锚点的内链 33 条,按 VitePress slugify 口径(NFKD 展开全角符号、数字标题补 _ 前缀)与页内标题/显式锚点逐一命中,锚点断链 0;工作室方法批次:新增 production 树节点「工作室分工与质量门禁」(production/07.md,把开源工程模板 Claude-Code-Game-Studios commit be8993b 的角色分层、门禁词表与质量证据纪律收成参考结构),页内不带内链,production 树根「本章文章」清单补 1 条相对链,相对内链 248 → 249;两处侧边栏 production 组各新增 1 条目,按目标去重 config link 240 → 241;md 245 → 246 篇,绝对内链 716 条、带 # 锚点的内链 33 条均不变。

内容清单:docs 下共 246 篇 md(不含 .vitepress;含调研收拢批 research/ 树 5 篇(三份调研 + 调研总览 + 覆盖差异表)与 knowledge.md 知识点总览 1 篇、2026-10 前端批次 7 篇、数值批次 9 篇、历史线八轨页 + 设计稿 + 节点清单 2 篇、后端引擎源码解析系列 1 篇、知识图谱新树样板节点 1 篇 server/aoi.md 、system 树 27 篇(15 玩法节点 + 脚本与热更 5 篇 + 通用服务 5 篇 + 1 覆盖对照 + 1 树根总览)、operation 树 14 篇(11 节点 + 2 子树导览 + 1 树根总览)、industry 树 32 篇(27 节点 + 4 子树导览 + 1 树根总览;横向节点 career 计入节点数)、design 树 8 篇(6 节点 + 1 子树导览 + 1 树根总览)、numerical 树 9 篇(8 节点 + 1 树根总览)、glossary 树 11 篇(9 术语约定节点 + 1 词汇速查节点 + 1 树根总览)、server 树 41 篇(35 节点 + 5 子树导览 + 1 树根总览;横向节点 aoi/skynet/language/map,前两者已计入样板与源码解析条目));教程 21 讲(01–21)+ 本页;实战案例已覆盖 21 讲(01/02/03/04/05/06/07/08/09/10/11/12/13/14/15/16/17/18/19/20/21),未覆盖 0 讲(无)——教程案例全覆盖;21 个案例节 ↔ 21 个 tests/case-*.test.mjs 一一对应(每讲恰一个案例节,每个用例都指向有案例的讲)。台账 20 处案例标题与讲内实际标题逐一比对,修正第一至三批省略的 一次「…」 外层(随本节同步修正)。

登记体例(非断链):批次标记「第二批」至「第十六批」齐全,「第一批」无字面标记(首批以「已补第 13 节实战案例」句式记录于「深化而非新开」);用例文件路径自第八批起逐条登记为「配套 tests/case-*.test.mjs」(14 条),第一至六批由「六批均已配套案例冒烟/集成用例」总括覆盖,第七批未提文件路径——属登记体例差异,21 个用例文件均在 tests/ 下且全绿。docs/index.md 无 H1 为 layout:page 自绘首页的预期形态。

知识库实战案例(首批试点):知识库页此前均无案例节,本轮起按教程同体例(背景与现象 + 四步 + 回填清单 + 三个教训)为知识库页试点补案例,用例文件统一用 tests/kb-case-*.test.mjs 前缀,与教程的 tests/case-*.test.mjs 互不干扰。首批试点落在第 4 章《同步、战斗与实时交互》05 页「预测、补偿与纠正」,案例题为「一次『明明躲开了还中』的回溯判定争议排查」(回链页内状态三层拆分、四级纠正、五项时序日志、补偿口径四问,配套 tests/kb-case-prediction.test.mjs 三查用例);第二篇落在同章 06 页「确定性与数值一致性」,案例题为「一次『同一份回放,两台机器算出两个结果』的确定性分叉排查」(回页内确定性定义句、分叉来源七条、稳定顺序/随机流/状态哈希三节与分层确定性口径,配套 tests/kb-case-determinism.test.mjs 三查用例);第三篇落在第 5 章《执行模型与运行时》05 页「锁竞争与性能代价」,案例题为「一次『加了全局锁,战斗服反而更抖』的锁竞争排查」(回页内代价清单六条、热点六条、单写者四手段与治理顺序四步,配套 tests/kb-case-lock-contention.test.mjs 三查用例);第四篇落在第 6 章《服务拆分、分布式与控制平面》01 页「服务拆分方法论」,案例题为「一次『服务拆了十四个,技能慢了三倍』的过度拆分排查」(回页内状态边界先行、拆分四问、三种拆分思路、六项拆分成本、判断标准五条与常见误区三类,配套 tests/kb-case-over-splitting.test.mjs 三查用例);第五篇落在第 7 章《消息系统与进程间通信》03 页「主链路与外围链路差异」,案例题为「一次『打完了不出结算』的外围反卡主链路排查」(回页内主链路五例四特征、外围六例、更稳妥拆法三条、做坏点三个、判断标准三问与常见误区三类,配套 tests/kb-case-outer-blocking.test.mjs 三查用例);第六篇落在第 8 章《客户端架构与引擎体系》04 页「脚本语言与 ECS」(注意:知识库目录号与章号错位,第 8 章现于 client/,知识图谱迁移前的目录号为 10-client-engine-runtime),案例题为「一次『重构三个月,帧率没救回来』的 ECS 边界排查」(回页内脚本层动因与代价、ECS 讨论动因、脚本/ECS 各四条适配、边界四问三后果、稳妥落地三条与常见误区三类,配套 tests/kb-case-ecs-boundary.test.mjs 三查用例);第七篇落在第 9 章《脚本、热更新与逻辑扩展》04 页「热更新体系」,案例题为「一次『校验全绿,灰度桶崩了四倍』的热更兼容排查」(回页内体系六层能力、兼容四类、回滚四问、灰度三价值、分层测试四项与常见误区三类,配套 tests/kb-case-hotfix-compat.test.mjs 三查用例);第八篇落在第 10 章《版本、发布与运营支撑》05 页「配置表与数据驱动管线」,案例题为「一次『测试表发进了生产,产出翻了十倍』的配置管线排查」(回页内配置事故五表现、管线六件套、风险分层四问、血缘四问、半套编程语言四件与稳妥做法四条,配套 tests/kb-case-config-env-leak.test.mjs 三查用例);第九篇落在第 11 章《数据建模与数据库》04 页「数据同步、冷热分层与归档」,案例题为「一次『90 天前的流水只找得回 8 笔』的资产争议追溯排查」(回页内热冷特征各四条、副本五份与语义四问、归档五场景、生命周期四层四定义、验收五场景与常见误区三类,配套 tests/kb-case-archive-trace.test.mjs 三查用例);第十篇落在第 12 章《缓存、中间件与基础设施》01 页「Redis、排行榜与锁」,案例题为「一次『补发任务跑了两遍,全服多发 600 万』的锁租约排查」(回页内缓存四条件、权威源三特征、榜单与读法各三条、分数四问题、锁三问与失效四形态、误区四条 bullet,配套 tests/kb-case-lock-lease-double-run.test.mjs 三查用例);第十一篇落在第 13 章《通用游戏服务》04 页「风控、审计、GM 与客服」,案例题为「一次『凌晨封了 8000 个号,改判四成』的风控误伤排查」(回页内闭环五环、审计必答四问与场景五类、GM 分层三类与强写五要、客服取证六类、协同四环三局面与常见错误四条,配套 tests/kb-case-risk-ban-appeal.test.mjs 三查用例);第十二篇落在第 14 章《运营、商业化与数据分析》01 页「运营与商业化基础」,案例题为「一次『三张收入表差 9 万』的运营口径排查」(回页内三表口径桥接、动作三步与礼包调价六件套、五类能力缺复盘系统、常见组织方式三型与常见错误四条,配套 tests/kb-case-revenue-three-tables.test.mjs 三查用例);第十三篇落在第 15 章《平台生态、渠道与 SDK》01 页「平台与渠道生态」,案例题为「一次『顺手多接的 3 个小渠道,把排期拖垮了 4 周』的渠道接入排查」(回页内平台约束四问、审核节奏四条与最慢渠道兼容窗口、多版本共存与测试矩阵、投影口径、隔离层取舍与评估模板四维、常见误区六条,配套 tests/kb-case-channel-overreach.test.mjs 三查用例);第十四篇落在第 16 章《可观测性与稳定性》01 页「日志、指标、Tracing 与 OTel」,案例题为「一次『三样工具都买了,定位还是卡了 6 小时』的证据链排查」(回页内三支柱分工、指标站岗与日志解剖、日志五条基础判断、关联三习惯、追踪单位三类与采样两条底线、指标档案四件与建设顺序三步、常见误区五条,配套 tests/kb-case-evidence-chain.test.mjs 三查用例);第十五篇落在第 17 章《安全、风控与合规》01 页「安全与反作弊」,案例题为「一次『单局代币客户端说了算,4 天刷出 7680 万』的结算权威排查」(回页内安全与反作弊不分家的动因四条、客户端防护两作用、权威关键状态四条与做法三条、滥用形态与五层体系各五条、建设方式三型与常见错误四条,配套 tests/kb-case-settle-authority.test.mjs 三查用例);第十六篇落在第 18 章《选型、实践与复盘》01 页「引擎、语言与技术选型」,案例题为「一次『两轮会定下的新引擎,量产期产能掉了六成』的选型复盘排查」(回页内硬软约束各一条、引擎权衡六维、服务端语言五条、不可逆三档、会议纪律四条、决策记录三件、换底座信号四条与常见误区六条,配套 tests/kb-case-choice-discipline.test.mjs 三查用例);第十七篇落在第 19 章《Web 游戏前端体系》01 页「H5 与 Canvas 2D 渲染基础」,案例题为「一次『低分屏验收全绿,上线当天 58 条反馈』的 Canvas 渲染排查」(回页内 DPR 两套尺寸与发虚根因、rAF 与 delta time 最小骨架、绘制四手段、文本预渲染与预解码、常见误区五条,配套 tests/kb-case-canvas-render.test.mjs 三查用例)。当前知识库共 70 个案例节 ↔ 70 个 kb-case- 用例文件,一一对应。第二十二篇落在 web/02「WebGL 与三维渲染入门」,案例题为「一次『高端机满帧,低端机进战斗掉到 22 帧』的渲染归因排查」(回页内渲染管线两个关键事实、DrawCall 三层次、纹理三件事与常见误区五条,配套 tests/kb-case-webgl-attribution.test.mjs 三查用例);第二十三篇落在 web/03「游戏引擎与 Cocos Creator」,案例题为「一次『引擎够用,改个活动按钮却要动 23 个文件』的架构缺位排查」(回页内引擎职责清单、热路径三忌、适配验收标准与常见误区五条,配套 tests/kb-case-engine-arch.test.mjs 三查用例);第二十四篇落在 web/04「游戏 UI 体系」,案例题为「一次『背包一开就卡死,多语言要 9 人天』的 UI 体系排查」(回页内 HUD 分层三条、列表池化三配套、界面栈四件事与常见误区六条,配套 tests/kb-case-ui-pool.test.mjs 三查用例);第二十五篇落在 web/05「小游戏平台与浏览器环境」,案例题为「一次『H5 搬进小游戏,首屏白屏 8 秒』的移植排查」(回页内环境差异对照表、包体三板斧、生命周期要点与常见误区五条,配套 tests/kb-case-minigame-port.test.mjs 三查用例);第二十六篇落在 web/06「客户端内部分层:渲染、逻辑与资源」,案例题为「一次『同一段录像,两台机器打出两个结果』的分层缺失排查」(回页内三层职责、固定时步 accumulator、事件协议与资源对账,配套 tests/kb-case-layering.test.mjs 三查用例)。第十八篇起转入按章余页批次:第十八篇落在第 8 章余页 client/input「交互与输入」,案例题为「一次『同一操作,不同设备三种判定』的输入时序漂移排查」(回页内管线五段表、手感三口径三条、触屏与多设备三条与 Problem 表现四条,配套 tests/kb-case-input-drift.test.mjs 三查用例);第十九篇落在 engines/01「引擎选择与商业模式」,案例题为「一次『分成 5%,年尾却多付了 540 万』的分成基数口径排查」(回页内分成基数口径句、常见误区七条与条款变化预案三条,配套 tests/kb-case-royalty-basis.test.mjs 三查用例);第二十篇落在 engines/02「编程语言与技术栈地图」,案例题为「一次『为类型安全切语言,交付反被拖垮』的选型顺序倒置排查」(回页内决策顺序四步、常见误区七条与语言地图四条,配套 tests/kb-case-choice-order.test.mjs 三查用例);第二十一篇落在 engines/03「团队能力、项目类型与工具生态」,案例题为「一次『功能清单打分最高,上线后六个版本五个延期』的消化能力排查」(回页内消化掂量四条、管线规律四条、常见误区七条与垂直切片要点,配套 tests/kb-case-digest-ceiling.test.mjs 三查用例)。

游戏知识体系