Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs: add "See also" cross-links to the guides that lacked them

esenginefeea809f1759
diff --git a/docs/astro/src/content/docs/guides/ai.mdx b/docs/astro/src/content/docs/guides/ai.mdx
index 7e438996e..e8196b81d 100644
--- a/docs/astro/src/content/docs/guides/ai.mdx
+++ b/docs/astro/src/content/docs/guides/ai.mdx
@@ -574,3 +574,9 @@ The two enemies' `StateMachineAgent.fsm` and `BehaviorTreeAgent.bt` point at
`enemy.esfsm` / `enemy.esbt` — authored in the editor, loaded by the engine.
Perception, the FSM/BT ticks, and nav following are all built-in, so the only game
code is the shared leaves above plus the one-time grid.
+
+## See also
+
+- [Scripting](/docs/guides/scripting/) — behaviors are declarative systems; leaves are plain functions.
+- [Animation](/docs/guides/animation/) — drive sprite clips from a state machine.
+- [Scenes](/docs/guides/scene/) — `.esfsm` / `.esbt` assets load and serialize with the scene.
diff --git a/docs/astro/src/content/docs/guides/build-export.mdx b/docs/astro/src/content/docs/guides/build-export.mdx
index fe8cdbcd2..67f94ed3b 100644
--- a/docs/astro/src/content/docs/guides/build-export.mdx
+++ b/docs/astro/src/content/docs/guides/build-export.mdx
@@ -179,3 +179,9 @@ node build-tools/cli.js watch # rebuild on change (engine dev)
Most game developers never run the build CLI beyond the one-time WeChat / Playable
runtime builds — day-to-day work happens in the editor and the SDK.
</Aside>
+
+## See also
+
+- [WeChat MiniGame](/docs/guides/wechat/) — subpackage layout and platform-specific quirks.
+- [Assets](/docs/guides/assets/) — how the cook step bundles and content-addresses assets.
+- [Profiling & Diagnostics](/docs/guides/profiling/) — check frame time and draw calls before you ship.
diff --git a/docs/astro/src/content/docs/guides/lighting.mdx b/docs/astro/src/content/docs/guides/lighting.mdx
index 02289de5c..675133a23 100644
--- a/docs/astro/src/content/docs/guides/lighting.mdx
+++ b/docs/astro/src/content/docs/guides/lighting.mdx
@@ -208,3 +208,9 @@ const app = createWebApp(module, { colorSpace: 'linear' });
- All of a light's visual fields (`color`, `intensity`, `radius`, the angles, and the
shadow settings) are **animatable** — key them in the [Sequencer](/docs/guides/timeline/)
for flickering torches, day/night cycles, or a pulsing beacon.
+
+## See also
+
+- [Materials & Shaders](/docs/guides/material/) — lit materials and custom shading.
+- [Post-processing](/docs/guides/postprocess/) — bloom and color grading over the lit scene.
+- [Sprites & Rendering](/docs/guides/sprites/) — normal maps that give 2D sprites depth under light.
diff --git a/docs/astro/src/content/docs/guides/mcp.mdx b/docs/astro/src/content/docs/guides/mcp.mdx
index d3a6f8142..dd8ce50df 100644
--- a/docs/astro/src/content/docs/guides/mcp.mdx
+++ b/docs/astro/src/content/docs/guides/mcp.mdx
@@ -105,3 +105,8 @@ In a source checkout, `pnpm --filter @estella/editor editor:mcp` serves the same
registry against a headless fixtures host (scene tools only), `editor:mcp -- --editor`
boots the dev editor, and two e2e suites (`editor:mcp:e2e`,
`editor:mcp:editor-e2e`) prove the full loop.
+
+## See also
+
+- [The Editor](/docs/guides/editor/) — the visual editor this automation surface drives.
+- [Scripting](/docs/guides/scripting/) — the same scene / component model, from game code.
diff --git a/docs/astro/src/content/docs/guides/save.mdx b/docs/astro/src/content/docs/guides/save.mdx
index ad54407e9..5f39278b8 100644
--- a/docs/astro/src/content/docs/guides/save.mdx
+++ b/docs/astro/src/content/docs/guides/save.mdx
@@ -93,3 +93,8 @@ backend.
Both APIs are synchronous and back onto the platform's storage, which has a size
limit (a few MB in browsers). Keep saves to game state — not bulk assets.
</Aside>
+
+## See also
+
+- [Scenes](/docs/guides/scene/) — loading and switching the scenes a save points at.
+- [Assets](/docs/guides/assets/) — why bulk data belongs in assets, not in a save slot.
diff --git a/docs/astro/src/content/docs/guides/scripting.mdx b/docs/astro/src/content/docs/guides/scripting.mdx
index 5f3fa3a75..4ccc9c066 100644
--- a/docs/astro/src/content/docs/guides/scripting.mdx
+++ b/docs/astro/src/content/docs/guides/scripting.mdx
@@ -241,3 +241,9 @@ that asks of your code:
The mechanism (probe context, schema fingerprint, `App.hotSwapSystems`) is
documented in [App Setup & Lifecycle](/docs/core-concepts/app-lifecycle/#hot-reload).
+
+## See also
+
+- [Systems](/docs/core-concepts/systems/) — the full query vocabulary, filters, and schedules.
+- [ECS Architecture](/docs/core-concepts/ecs/) — entities, components, and how systems iterate them.
+- [Input](/docs/guides/input/) — read keyboard, pointer, and gestures from a system.
diff --git a/docs/astro/src/content/docs/guides/sprites.mdx b/docs/astro/src/content/docs/guides/sprites.mdx
index 2e813ef4e..b28b5435f 100644
--- a/docs/astro/src/content/docs/guides/sprites.mdx
+++ b/docs/astro/src/content/docs/guides/sprites.mdx
@@ -363,3 +363,9 @@ without a depth buffer.
Browser into the viewport to spawn one already textured.
- Every field above is editable in **Details**; sprites, cameras, and lights show as
gizmos in the viewport. See [The Editor](/docs/guides/editor/).
+
+## See also
+
+- [Animation](/docs/guides/animation/) — sprite-sheet flipbooks and tweened properties.
+- [Custom Drawing](/docs/guides/drawing/) — meshes and immediate-mode shapes beyond sprites.
+- [2D Lighting & Shadows](/docs/guides/lighting/) — normal maps and per-sprite lighting.
diff --git a/docs/astro/src/content/docs/zh-cn/guides/ai.mdx b/docs/astro/src/content/docs/zh-cn/guides/ai.mdx
index d86d38a30..d42eac693 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/ai.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/ai.mdx
@@ -530,3 +530,9 @@ export const setupNavGrid = defineSystem([Res(Nav)], (nav) => {
两个敌人的 `StateMachineAgent.fsm` 和 `BehaviorTreeAgent.bt` 分别指向 `enemy.esfsm` /
`enemy.esbt`——在编辑器里编排,由引擎加载。感知、FSM/BT 的 tick、以及跟随导航全是内置的,
所以唯一的游戏代码就是上面的共享叶子加上那张一次性的网格。
+
+## 参见
+
+- [脚本](/docs/zh-cn/guides/scripting/) —— 行为是声明式系统;叶子就是普通函数。
+- [动画](/docs/zh-cn/guides/animation/) —— 用状态机驱动精灵动画。
+- [场景](/docs/zh-cn/guides/scene/) —— `.esfsm` / `.esbt` 资产随场景加载与序列化。
diff --git a/docs/astro/src/content/docs/zh-cn/guides/build-export.mdx b/docs/astro/src/content/docs/zh-cn/guides/build-export.mdx
index de424f721..8cf54b7ad 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/build-export.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/build-export.mdx
@@ -147,3 +147,9 @@ node build-tools/cli.js watch # 改动即重建(引擎开发)
大多数游戏开发者除了那一次性的微信 / Playable 运行时构建外,从不需要动构建 CLI——日常工作都在
编辑器和 SDK 里。
</Aside>
+
+## 参见
+
+- [微信小游戏](/docs/zh-cn/guides/wechat/) —— 分包布局与平台差异。
+- [资源](/docs/zh-cn/guides/assets/) —— cook 步骤如何打包与内容寻址资产。
+- [性能剖析与诊断](/docs/zh-cn/guides/profiling/) —— 发布前检查帧时间与 draw call。
diff --git a/docs/astro/src/content/docs/zh-cn/guides/lighting.mdx b/docs/astro/src/content/docs/zh-cn/guides/lighting.mdx
index 2f8b9137d..e60895c09 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/lighting.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/lighting.mdx
@@ -195,3 +195,9 @@ const app = createWebApp(module, { colorSpace: 'linear' });
- 在 Details 里实时调 `color`(取色器)、`intensity`、`radius` 和聚光角度;结果在视口里即时更新。
- 一盏灯的全部视觉字段(`color`、`intensity`、`radius`、各角度、阴影设置)都**可动画**——在
[Sequencer](/docs/zh-cn/guides/timeline/)里给它们打关键帧,做闪烁的火把、昼夜循环或脉动的信标。
+
+## 参见
+
+- [材质与着色器](/docs/zh-cn/guides/material/) —— 受光材质与自定义着色。
+- [后处理](/docs/zh-cn/guides/postprocess/) —— 在受光场景上叠加辉光与调色。
+- [精灵与渲染](/docs/zh-cn/guides/sprites/) —— 让 2D 精灵在光下有立体感的法线贴图。
diff --git a/docs/astro/src/content/docs/zh-cn/guides/mcp.mdx b/docs/astro/src/content/docs/zh-cn/guides/mcp.mdx
index 7cb71e022..ef679f4b8 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/mcp.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/mcp.mdx
@@ -99,3 +99,8 @@ claude mcp add estella --env ESTELLA_MCP_ALLOW_WRITES=1 -- \
源码仓库里,`pnpm --filter @estella/editor editor:mcp` 用无头夹具宿主提供同一套
注册表(仅场景工具),`editor:mcp -- --editor` 拉起开发版编辑器;两套 e2e
(`editor:mcp:e2e`、`editor:mcp:editor-e2e`)验证完整闭环。
+
+## 参见
+
+- [编辑器](/docs/zh-cn/guides/editor/) —— 这个自动化面驱动的可视化编辑器。
+- [脚本](/docs/zh-cn/guides/scripting/) —— 同一套场景 / 组件模型,从游戏代码这边看。
diff --git a/docs/astro/src/content/docs/zh-cn/guides/save.mdx b/docs/astro/src/content/docs/zh-cn/guides/save.mdx
index 848e8af5b..61757709a 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/save.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/save.mdx
@@ -86,3 +86,8 @@ Storage.has('keybinds'); // true
两个 API 都是同步的,且落在平台的存储上,存储有大小限制(浏览器里通常几 MB)。存档只放
游戏状态——不要放大块资源。
</Aside>
+
+## 参见
+
+- [场景](/docs/zh-cn/guides/scene/) —— 加载与切换存档所指向的场景。
+- [资源](/docs/zh-cn/guides/assets/) —— 为什么大块数据应放资源而非存档槽。
diff --git a/docs/astro/src/content/docs/zh-cn/guides/scripting.mdx b/docs/astro/src/content/docs/zh-cn/guides/scripting.mdx
index 0aa8e4436..6d2bae723 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/scripting.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/scripting.mdx
@@ -220,3 +220,9 @@ world.spawn()
其机制(探针上下文、模式指纹、`App.hotSwapSystems`)见
[应用设置与生命周期](/docs/zh-cn/core-concepts/app-lifecycle/#热重载)。
+
+## 参见
+
+- [系统](/docs/zh-cn/core-concepts/systems/) —— 完整的查询词汇、过滤器与调度。
+- [ECS 架构](/docs/zh-cn/core-concepts/ecs/) —— 实体、组件,以及系统如何遍历它们。
+- [输入](/docs/zh-cn/guides/input/) —— 在系统里读取键盘、指针与手势。
diff --git a/docs/astro/src/content/docs/zh-cn/guides/sprites.mdx b/docs/astro/src/content/docs/zh-cn/guides/sprites.mdx
index 960d789dc..3e3862272 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/sprites.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/sprites.mdx
@@ -330,3 +330,9 @@ Draw.texture(pos, { x: 512, y: 256 }, cache.textureId);
- **创建 → 精灵** 添加一个精灵实体,或从内容浏览器**把图拖**进视口,生成一个已带纹理的精灵。
- 上面每个字段都能在 **Details** 里编辑;精灵、相机、光源在视口里显示为 gizmo。见
[编辑器](/docs/zh-cn/guides/editor/)。
+
+## 参见
+
+- [动画](/docs/zh-cn/guides/animation/) —— 精灵表帧动画与属性补间。
+- [自定义绘制](/docs/zh-cn/guides/drawing/) —— 精灵之外的网格与即时模式图形。
+- [2D 光照与阴影](/docs/zh-cn/guides/lighting/) —— 法线贴图与逐精灵光照。