mirror of
https://github.com/motajs/template.git
synced 2026-11-08 02:54:30 +08:00
AncTe
93ac3efec8
- 新建 III 导览：读者画像、与 I/II 的区别、前置、八篇地图、阅读路径、边界与自检 - 七篇正文补返回导览，并把已有的兄弟页提及改为真实相对链接（含 event-system 收集章节锚点）
63 lines
4.8 KiB
Markdown
63 lines
4.8 KiB
Markdown
# 高级 III 导览
|
||
|
||
高级 III 是高级教程的最高难度层，讲数据端系统的原理与架构：这些系统为什么这样拆分、数据在它们之间怎么流动、哪些约束不能打破。它面向已经能独立改动数据端、现在需要判断改动该落在哪一层的作者。
|
||
|
||
这一页说明这一层是给谁的、与高级 I 和高级 II 的区别、需要哪些前置、收录了哪八篇，以及两条阅读路径。本层只写数据端；渲染端原理不在当前范围。
|
||
|
||
## 高级 III 是给谁的
|
||
|
||
- 你能读懂类、接口、泛型、装饰器与 TypedArray，不需要逐行解释也能跟上类型签名；
|
||
- 你需要判断一个改动该落在状态、系统还是加载层，而不是只把效果调出来；
|
||
- 你要排查存档与回放不一致的问题，需要知道状态从哪里来、由谁装配、什么时候写入；
|
||
- 你愿意先理解机制再动手，接受「顺序固定」与「不要重排装配」这类约束。
|
||
|
||
## 与高级 I、高级 II 的区别
|
||
|
||
高级 I 讲扩展机制怎么用：插件、存档、录像一致性与钩子各自怎么接。高级 II 讲具体系统怎么改到自己的需求：范围、图块、装备、寻路、属性与战斗上下文。高级 III 讲这些系统为什么这样设计、数据怎么流、失败会在哪里出现。
|
||
|
||
三层是难度标签，不是领域分类：同一主题可能在不同层以不同深度出现。读高级 III 时默认你已经会使用相关接口，因此这里不重复调用步骤，只讲结构、顺序与边界。
|
||
|
||
## 前置
|
||
|
||
建议先读完[高级 I 导览](../i/)与[高级 II 导览](../ii/)。其中四篇会反复被本层引用：
|
||
|
||
- [插件系统](../i/plugin-system.md)：插件顺序与生命周期是装配页与插件内部页的直接前置；
|
||
- [可存档内容](../i/saveable-content.md)：存档 id、对象与执行器的约定贯穿装配页；
|
||
- [录像一致性](../i/replay-consistency.md)：录像页默认你知道哪些方法要登记；
|
||
- [自动寻路](../ii/pathfinding.md)：寻路页只讲原理与契约，用法与损失函数在那篇。
|
||
|
||
## 八篇地图
|
||
|
||
| 序 | 篇目 | 它能让你做什么 |
|
||
| --- | -------------------------------------------------------- | ------------------------------------------------ |
|
||
| 1 | [加载系统](./loading-system.md) | 看清三层加载模型、阶段顺序与三类扩展点 |
|
||
| 2 | [录像系统底层](./replay-internals.md) | 理解录像的二进制形状、沙箱播放与存档字段 |
|
||
| 3 | [事件系统](./event-system.md) | 分清仓库、收集、执行与解释器各自负责什么 |
|
||
| 4 | [Anon-Tokyo 解释器](./anon-tokyo.md) | 看懂语句如何编译成程序、执行上下文如何推进 |
|
||
| 5 | [通行性谓词与寻路原理](./passability-and-pathfinding.md) | 理解通行契约、两个谓词实例与构图搜索的分工 |
|
||
| 6 | [CoreState 组装与初始化](./core-state.md) | 看清四层装配、加载管线与存档挂载 |
|
||
| 7 | [插件内部机制](./plugin-internals.md) | 知道插件顺序怎么算、状态怎么推进、依赖写错会怎样 |
|
||
|
||
本页是第八篇，负责导览；其余七篇各自独立成文。
|
||
|
||
## 阅读路径
|
||
|
||
- **原理线**：CoreState 组装与初始化 → 插件内部机制 → 事件系统 → Anon-Tokyo 解释器 → 通行性谓词与寻路原理 → 录像系统底层 → 加载系统。适合想一次把数据端的结构与数据流打通。
|
||
- **按需线**：先读 CoreState 组装与初始化，建立分层与加载管线的心智模型，再跳到与当前问题最相关的一篇。每篇都单独成立，不需要按顺序读。
|
||
|
||
## 本层不覆盖什么
|
||
|
||
- 渲染端的结构性内容：渲染场景、绘制流程与客户端主对象属于渲染端，本层只写数据端；
|
||
- 编辑器与内容配置：编辑器属性项、地图事件 id 绑定与序列化事件注册由编辑器负责；
|
||
- API 签名清单：本层只讲机制与取舍，不罗列接口参数；
|
||
- legacy 包：旧引擎实现只作为对比基线出现，不作为扩展入口。
|
||
|
||
## 怎么验证你读懂了
|
||
|
||
- 能说出 CoreState 的四层装配顺序，并解释为什么不能重排；
|
||
- 能说明插件依赖成环或缺失时，为什么下游也会被阻断；
|
||
- 能解释事件为什么按「点事件整组在前、图块事件整组在后」的顺序执行；
|
||
- 能说出通行性谓词为什么会有两个实例，以及怎样让两侧保持一致；
|
||
- 能说明录像为什么能按步号读取，以及读取流为什么会过期；
|
||
- 能画出加载的三段阶段，并说清额外配置与自定义任务各自该在什么时候追加。
|