diff --git a/Docs/Yarn全局转场指令表.md b/Docs/Yarn全局转场指令表.md
new file mode 100644
index 000000000..bbc5ba51b
--- /dev/null
+++ b/Docs/Yarn全局转场指令表.md
@@ -0,0 +1,56 @@
+# Yarn 全局转场指令表
+
+全局转场采用“进入方式”和“退出方式”自由组合：`in` 表示盖住画面，`out` 表示揭开画面。
+
+| Yarn 命令 | 默认时长 | 是否等待完成 | 用途 |
+|---|---:|:---:|---|
+| `<<fade_in>>` | 1 秒 | 是 | 黑色遮罩逐渐盖住画面 |
+| `<<fade_out>>` | 1 秒 | 是 | 当前遮罩逐渐消失，黑幕和白幕通用 |
+| `<<fade_in_sync>>` | 1 秒 | 否 | 开始黑色淡入后立即继续执行后续 Yarn |
+| `<<fade_out_sync>>` | 1 秒 | 否 | 开始淡出后立即继续执行后续 Yarn |
+| `<<fade_in_white>>` | 1 秒 | 是 | 白色遮罩逐渐盖住画面 |
+| `<<flash_white>>` | 0.2 秒 | 是 | 完成一次白色闪光，参数表示完整总时长 |
+| `<<wipe_in>>` | 0.6 秒 | 是 | 黑色幕布从左向右盖住画面 |
+| `<<wipe_out>>` | 0.6 秒 | 是 | 当前颜色的幕布继续向右移出 |
+| `<<shutter_in>>` | 0.6 秒 | 是 | 黑色上下幕布向中心闭合 |
+| `<<shutter_out>>` | 0.6 秒 | 是 | 当前颜色的上下幕布向外打开 |
+
+## 使用规则
+
+- 所有时长参数都可以省略，单位为秒。
+- Out 自动继承当前遮罩颜色，因此没有 `fade_out_white`。
+- 除两个旧 Sync 指令外，其他指令都会等待动画完成。
+- In 与 Out 可以自由组合，不要求同类型配对。
+- `flash_white` 是一次性效果，不需要再接 Out；应从可见画面开始使用。
+
+## 常用写法
+
+```yarn
+// 传统黑色淡入淡出
+<<fade_in>>
+<<load_scene ClinicOut>>
+<<fade_out>>
+
+// 白色淡入，普通淡出
+<<fade_in_white 0.3>>
+<<fade_out 0.8>>
+
+// 黑幕淡入，然后向右推开
+<<fade_in 0.5>>
+<<wipe_out 0.6>>
+
+// 推幕盖入，然后淡出
+<<wipe_in>>
+<<fade_out>>
+
+// 白幕淡入，然后上下打开
+<<fade_in_white>>
+<<shutter_out>>
+
+// 上下闭合，然后向右推开
+<<shutter_in>>
+<<wipe_out>>
+
+// 单次白闪
+<<flash_white 0.2>>
+```