From 0cfeef4af26d1cea6de674ec5aa0ef69b46fdb17 Mon Sep 17 00:00:00 2001 From: unanmed <1319491857@qq.com> Date: Tue, 27 Oct 2026 14:13:16 +0800 Subject: [PATCH] =?UTF-8?q?docs(10-39):=20=E6=B3=A8=E5=86=8C=E9=AB=98?= =?UTF-8?q?=E7=BA=A7=20III=20=E4=BE=A7=E8=BE=B9=E6=A0=8F=E5=B9=B6=E6=9B=BF?= =?UTF-8?q?=E6=8D=A2=E5=8D=A0=E4=BD=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - config.ts 的 III 组注册导览与七篇正文共 8 项，collapsed 改为 false - 总导览、高级 I 导览、高级 II 导览的 III 占位改为真实链接 --- docs/.vitepress/config.ts | 34 ++++++++++++++++++++++++++++++++-- docs/advanced/i/index.md | 4 ++-- docs/advanced/ii/index.md | 2 +- docs/advanced/index.md | 14 +++++++------- 4 files changed, 42 insertions(+), 12 deletions(-) diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 8c57a55..d953c5f 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -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' + } + ] } ] }, diff --git a/docs/advanced/i/index.md b/docs/advanced/i/index.md index 506d5d4..cf03b15 100644 --- a/docs/advanced/i/index.md +++ b/docs/advanced/i/index.md @@ -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 @@ - 渲染端内容：渲染端尚未完工，高级教程当前只收录数据端内容，渲染端专题待完工后补上。 - 高级 II 的深入定制内容：范围、图块、装备、录像指令、寻路、勇士与怪物属性、战斗上下文，见[高级 II 导览](../ii/)。 -- 高级 III 的原理与架构：双端分离约束、数据端 L0–L3、编辑器识别协议、录像深层原理、性能与调试。 +- 高级 III 的原理与架构：双端分离约束、数据端 L0–L3、编辑器识别协议、录像深层原理、性能与调试，见[高级 III 导览](../iii/)。 - API 参考：接口签名与类型清单不属于教程正文。 ## 读完这一层应该能做什么 diff --git a/docs/advanced/ii/index.md b/docs/advanced/ii/index.md index 6b658ea..df5bdfd 100644 --- a/docs/advanced/ii/index.md +++ b/docs/advanced/ii/index.md @@ -26,7 +26,7 @@ 同一层的篇目可能分散在数据端的不同模块；层与层之间也可能调整主题。判断依据是难度与改动深度，不是模块归属。 -高级 III 尚未编写。本层正文只在需要时用 `高级 III · ` 这样的代码 span 或 `` 标出归属，不会写成真实链接；等该层建立后再替换。 +高级 III 已经可阅读，入口见[高级 III 导览](../iii/)。 ## 前置 diff --git a/docs/advanced/index.md b/docs/advanced/index.md index 92a33d5..13a29d6 100644 --- a/docs/advanced/index.md +++ b/docs/advanced/index.md @@ -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 @@ - 渲染端内容：渲染端尚未完工，本层当前只收录数据端内容；渲染端专题只用占位标记指出归属，待完工后补上。 - 编辑器内容：涉及编辑器与内容配置的部分只保留占位，不在本层展开。 - 不重复中级已讲内容：接口的日常用法、参数清单与常见改法属于中级教程；本层只在需要说明扩展点时引用，不整段重写。 -- 高级 III 入口：该层页面尚未创建，本页与侧边栏都不提供链接；页面齐备后统一开放入口。 +- 高级 III 入口：该层已可阅读，入口见[高级 III 导览](./iii/)。