docs: add battle system, conditional routing, key moments, and creators guide docs

2026-06-14 16:42:16 +08:00
parent 02a82e9801
commit c75db2886f
5 changed files with 255 additions and 4 deletions
--- a/docs/guide/KEY_MOMENTS.md
+++ b/docs/guide/KEY_MOMENTS.md
@@ -0,0 +1,31 @@
+# 关键节点过滤
+
+## 概述
+
+P26 新增。StoryGallery 的章节回顾默认只展示**剧情关键节点**，过滤掉过渡/路由/中间场景。
+
+## 自动判断规则
+
+| 场景类型 | 是否展示 |
+|----------|:--:|
+| 章节起始场景（`chapters[].startScene`） | ✅ |
+| 有 `choices` 的分支点 | ✅ |
+| 结局场景（`endings[].sceneId`） | ✅ |
+| QTE 场景 | ❌ |
+| 路由/过渡场景 | ❌ |
+
+## 手动覆盖：`keyMoment` 字段
+
+```json
+{
+  "id": "combat_router",
+  "keyMoment": false,
+  "nextScene": [...]
+}
+```
+
+| 值 | 行为 |
+|:--:|------|
+| `true` | 强制展示 |
+| `false` | 强制隐藏 |
+| 未设置 | 自动判断 |