docs(10-39): 注册高级 III 侧边栏并替换占位

- config.ts 的 III 组注册导览与七篇正文共 8 项,collapsed 改为 false

- 总导览、高级 I 导览、高级 II 导览的 III 占位改为真实链接
This commit is contained in:
unanmed 2026-10-27 14:13:16 +08:00
parent 93ac3efec8
commit 0cfeef4af2
4 changed files with 42 additions and 12 deletions

View File

@ -234,8 +234,38 @@ export default defineConfig({
},
{
text: '高级 III · 原理与架构',
collapsed: true,
items: []
collapsed: false,
items: [
{ text: '高级 III 导览', link: '/advanced/iii/' },
{
text: '加载系统',
link: '/advanced/iii/loading-system'
},
{
text: '录像系统底层',
link: '/advanced/iii/replay-internals'
},
{
text: '事件系统',
link: '/advanced/iii/event-system'
},
{
text: 'Anon-Tokyo 解释器',
link: '/advanced/iii/anon-tokyo'
},
{
text: '通行性谓词与寻路原理',
link: '/advanced/iii/passability-and-pathfinding'
},
{
text: 'CoreState 组装与初始化',
link: '/advanced/iii/core-state'
},
{
text: '插件内部机制',
link: '/advanced/iii/plugin-internals'
}
]
}
]
},

View File

@ -24,7 +24,7 @@
| [高级 II · 深入定制](../ii/) | 深入定制 | 范围、图块、装备、录像指令、寻路、勇士与怪物属性、战斗上下文 |
| 高级 III · 原理与架构 | 原理与架构 | 双端分离约束、数据端 L0–L3、编辑器识别协议、录像深层原理、性能与调试 |
高级 II 已经可阅读,入口见[高级 II 导览](../ii/);本层收录范围、图块、装备、录像指令、寻路、属性与战斗上下文。高级 III 仍用 `高级 III · <专题>` 这样的占位标记指出归属,暂不提供页面入口。
高级 II 已经可阅读,入口见[高级 II 导览](../ii/);本层收录范围、图块、装备、录像指令、寻路、属性与战斗上下文。高级 III 已经可阅读,入口见[高级 III 导览](../iii/)。
## 高级 I 包含什么
@ -74,7 +74,7 @@
- <strong>渲染端内容</strong>:渲染端尚未完工,高级教程当前只收录数据端内容,渲染端专题待完工后补上。
- <strong>高级 II 的深入定制内容</strong>:范围、图块、装备、录像指令、寻路、勇士与怪物属性、战斗上下文,见[高级 II 导览](../ii/)。
- <strong>高级 III 的原理与架构</strong>:双端分离约束、数据端 L0–L3、编辑器识别协议、录像深层原理、性能与调试。
- <strong>高级 III 的原理与架构</strong>:双端分离约束、数据端 L0–L3、编辑器识别协议、录像深层原理、性能与调试,见[高级 III 导览](../iii/)。
- <strong>API 参考</strong>:接口签名与类型清单不属于教程正文。
## 读完这一层应该能做什么

View File

@ -26,7 +26,7 @@
同一层的篇目可能分散在数据端的不同模块;层与层之间也可能调整主题。判断依据是难度与改动深度,不是模块归属。
高级 III 尚未编写。本层正文只在需要时用 `高级 III · <topic>` 这样的代码 span 或 `<!-- TODO(advanced-III) -->` 标出归属,不会写成真实链接;等该层建立后再替换。
高级 III 已经可阅读,入口见[高级 III 导览](../iii/)。
## 前置

View File

@ -6,13 +6,13 @@
## 三层结构
| 层级 | 定位 | 主要主题 |
| --------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| [高级 I · 扩展基础](./i/) | 较低门槛,核心是插件系统与基本扩展机制 | 声明式接口、插件系统、可存档内容、录像一致性、data-common 的 Store、钩子深入、移动 Mover、FaceHandler 系列 |
| [高级 II · 深入定制](./ii/) | 中等门槛,需要理解并修改引擎的特定系统 | 范围对象、图块、装备、录像指令、寻路、勇士与怪物属性、战斗上下文 |
| 高级 III · 原理与架构 | 最高门槛,系统讲解设计原理与架构 | 双端分离约束、数据端 L0–L3、编辑器识别协议、录像深层原理、性能与调试 |
| 层级 | 定位 | 主要主题 |
| ------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| [高级 I · 扩展基础](./i/) | 较低门槛,核心是插件系统与基本扩展机制 | 声明式接口、插件系统、可存档内容、录像一致性、data-common 的 Store、钩子深入、移动 Mover、FaceHandler 系列 |
| [高级 II · 深入定制](./ii/) | 中等门槛,需要理解并修改引擎的特定系统 | 范围对象、图块、装备、录像指令、寻路、勇士与怪物属性、战斗上下文 |
| [高级 III · 原理与架构](./iii/) | 最高门槛,系统讲解设计原理与架构 | 双端分离约束、数据端 L0–L3、编辑器识别协议、录像深层原理、性能与调试 |
高级 I 是入口层,插件系统是这一层的核心,后面的可存档内容、录像一致性、data-common 的 Store 与钩子深入都建立在它提供的扩展位置上。高级 II 按主题深入单个系统,进入前应当先读完高级 I 的相关篇目。高级 III 讲的是支撑前面两层的原理与架构,等该层页面就绪后开放入口。
高级 I 是入口层,插件系统是这一层的核心,后面的可存档内容、录像一致性、data-common 的 Store 与钩子深入都建立在它提供的扩展位置上。高级 II 按主题深入单个系统,进入前应当先读完高级 I 的相关篇目。高级 III 讲的是支撑前面两层的原理与架构,已可阅读,入口见[高级 III 导览](./iii/)。
## 怎么选阅读路径
@ -38,4 +38,4 @@
- <strong>渲染端内容</strong>:渲染端尚未完工,本层当前只收录数据端内容;渲染端专题只用占位标记指出归属,待完工后补上。
- <strong>编辑器内容</strong>:涉及编辑器与内容配置的部分只保留占位,不在本层展开。
- <strong>不重复中级已讲内容</strong>:接口的日常用法、参数清单与常见改法属于中级教程;本层只在需要说明扩展点时引用,不整段重写。
- <strong>高级 III 入口</strong>:该层页面尚未创建,本页与侧边栏都不提供链接;页面齐备后统一开放入口。
- <strong>高级 III 入口</strong>:该层已可阅读,入口见[高级 III 导览](./iii/)。