.

ShenMian · Aug 1, 2024 · 28576f8 · 28576f8
1 parent 2352348
commit 28576f8
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/src/SUMMARY.md b/src/SUMMARY.md
@@ -3,6 +3,7 @@
 [介绍](introduction.md)
 
 - [关卡](level/README.md)
+  - [API 设计 🚧](level/api_design.md)
   - [表示](level/representation.md)
   - [构造](level/construction.md)
   - [标准化 🚧](level/normalization.md)

diff --git a/src/level/api_design.md b/src/level/api_design.md
@@ -0,0 +1,17 @@
+# API 设计
+
+结构体:
+
+- `Map`: 存储地图数据, 包括墙体和地板布局. 还有玩家位置, 箱子和目标位置, 方便快速读取.
+- `Actions`: 存储玩家动作, 包括动作的类型(移动或推动), 以及方向(上下左右).
+- `Level`: 关卡, 包含地图和玩家动作. 可以执行或撤销操作.
+
+它们之间的转换关系如下:
+
+```mermaid
+flowchart LR
+    A[String] -->|XSB 格式| B[Map]
+    A -->|LURD 格式| C[Actions]
+    B --> D[Level]
+    C --> B
+```