docs(10-11): 用户修订循环 batch3(基础/其他 + 高级教程预留)

- U-01 src-tour:content 层主要在编辑器内改、对应初级教程
- U-02 data-state-overview:解释 state 静态类型按 L0-L3 逐层累加
- U-04 map-structure:按 alias/zIndex 取指定图层(非 addLayer)
- U-05 map-tiles:putMapData/getMapData 完整示例 + 高级教程预留
- U-06 flags:区分字段对象与字段值,两组接口如何选择
- U-20 events:以内置事件集已完整(发布前约 100 个)视角改写
- U-21 replay-commands:录像指令细节留高级教程
- U-22 11 篇:高级教程显式说明 + 非链接预留标记
This commit is contained in:
AncTe committed 2026-10-18 14:45:00 +08:00
1 parent 5c77676bca
commit 687e248ac1
15 files changed
+174 -24

No files matched your search

+15
View File
@@ -93,6 +93,21 @@ const map = state.maps.getActiveMap('floor-1'); // L1
state.emitTip('获得黄钥匙'); // L0
```
### 为什么有些地方的 state 看不到全部层级
`state` 在运行时始终是同一个主对象,分层只是它的**静态类型**在逐层累加。类型定义一层叠一层,每层只声明自己这一层拥有的成员:
- L0 `IDataCommon`:公共层,声明 `tileStore` / `itemStore` / `mapStore` / `eventStore` / `faceManager` / `roleFace` / `replaySystem` / `emitTip` 等共享设施;
- L1 `IStateBase`:在 L0 之上加数据层成员,即 `hero` / `maps` / `flags` / `enemyManager`;
- L2 `IStateSystem`:在 L1 之上加系统层成员,即 `enemyContext` / `combat` / `eventSystem` / `pathfinding`;
- L3 `ICoreState`:在 L2 之上加顶层成员,即 `loader` / `loadManager` / `getDataPlugin` 等。
所以,当你从某个**底层对象**上取到 `state` 时,它的类型可能只标到 L0 或 L1——编辑器里就看不到 `hero`、`flags` 这些更高层的成员。这并不是它们不存在,而是**当前这层接口没有声明它们**:运行时是同一个对象,只是编译期类型更窄。这正是「分层」的实际体现:越往上,成员越全。
要使用完整成员,就拿 L3 的 `ICoreState`,也就是框架作为参数传入、或从 `handler.state` 取到的那个 `state`(获取方式见上文「state 从哪来」)。这套分层的设计原理(为什么这样拆、每层负责什么)会在**高级教程**中展开(预留标记:`高级教程 · 数据端分层`);待高级教程就位后,此处会替换为链接。
<!-- TODO(advanced): 数据端分层 -->
## 从这里继续
- 勇士的数值与加成:见[勇士属性](./hero-attribute.md);