feat: editor improvements and roadmap doc

docs/EDITOR_ROADMAP.md

@@ -0,0 +1,123 @@
+# 编辑器 Roadmap — 与引擎功能同步
+
+P3 完成的编辑器支持基本的场景节点编辑。以下是与引擎 P4~P31 同步所需的编辑器功能迭代。
+
+---
+
+## 已完成（P3）
+
+| 功能 | 完成 |
+|------|:--:|
+| 场景节点图（Vue Flow） | ✅ |
+| 场景属性编辑（videoUrl, choices, nextScene, onEnter） | ✅ |
+| QTE 参数编辑 | ✅ |
+| JSON 导入/导出 | ✅ |
+| 视频预览 | ✅ |
+
+---
+
+## E1: 图片/视频热点编辑（对标 P4）
+
+- [ ] NodeEditor 新增 `type` 切换（video / image）
+- [ ] `imageUrl` 字段
+- [ ] 热区列表编辑：id / label / targetScene / x / y / w / h
+- [ ] 时间轴参数：showAt / hideAt
+- [ ] conditions / effects 编辑
+- [ ] timeLimit 字段
+
+## E2: 循环等待参数（对标 P5）
+
+- [ ] loopStart / loopEnd 两个数字字段
+
+## E3: BGM 字段编辑（对标 P6）
+
+- [ ] bgmUrl / bgmVolume / bgmCrossFade
+- [ ] bgmDuckLevel / bgmDuckFade
+- [ ] videoMuted
+
+## E4: i18n Key 编辑（对标 P11/P31）
+
+- [ ] SceneNode: subtitleUrl → subtitles map（按语言编辑）
+- [ ] Choice: textKey / promptKey
+- [ ] Hotspot: labelKey
+- [ ] ChapterInfo: labelKey
+- [ ] AchievementDef: titleKey / descKey
+- [ ] EndingDef: labelKey
+- [ ] QTEDefinition: promptKey
+- [ ] BattleHUD / BattleResult: labelKey / titleKey
+
+## E5: Choice 增强（对标 P13）
+
+- [ ] prompt 字段编辑
+
+## E6: 顶级字段编辑（对标 P8/P14/P15/P20/P24）
+
+- [ ] chapters 列表编辑（id / label / startScene / thumbnail / defaultVariables）
+- [ ] achievements 列表编辑（id / title / description / icon / hidden / condition）
+- [ ] endings 列表编辑（id / label / sceneId / chapterId / thumbnail）
+- [ ] introVideo / menuVideo
+- [ ] streamingUrl map（三档画质 key-value）
+- [ ] assetBase 字段
+
+## E7: 条件路由编辑（对标 P25）
+
+- [ ] nextScene 类型切换（字符串 / 数组）
+- [ ] 数组模式：逐条编辑 conditions + targetScene
+
+## E8: 关键节点编辑（对标 P26）
+
+- [ ] keyMoment 字段（三态：自动 / 强制 true / 强制 false）
+
+## E9: 战斗系统编辑（对标 P31）
+
+- [ ] battleHUD 列表编辑：每项含 label / portrait / stats 数组
+- [ ] battleHUD stats 编辑：variable / label / max / style
+- [ ] battleResult 编辑：title / stats 数组
+
+## E10: 内嵌快速测试
+
+- [ ] 节点右键菜单 → "从此场景开始测试"
+- [ ] PreviewPanel 切换为 iframe 内嵌游戏播放器（加载 `/?scene=<id>`）
+- [ ] Engine 支持 `?scene=` URL 参数指定起始场景
+
+## E11: 场景列表 + 搜索
+
+- [ ] 左侧可折叠场景列表面板（`SceneList.vue`）
+- [ ] 按名称搜索/筛选场景节点
+- [ ] 点击列表项 → 画布跳转到对应节点并选中
+
+## E12: JSON 校验器
+
+- [ ] 导出/保存前实时检查
+- [ ] 引用完整性：targetScene 指向不存在的场景 ID
+- [ ] 死路检测：无 choices / 无 nextScene / 无 qte / 无 hotspots 的场景
+- [ ] 变量引用：conditions 中的 variable 未在 `variables` 声明
+
+## E13: 撤销/重做
+
+- [ ] 操作历史栈（add/delete/update/move node & edge）
+- [ ] Ctrl+Z 撤销 / Ctrl+Shift+Z 重做
+- [ ] `useGraphEditor` 中维护 `history[]` + `historyIndex`
+
+## E14: 面板可折叠 + 标签页
+
+- [ ] NodeEditor 和 PreviewPanel 加折叠/展开按钮
+- [ ] NodeEditor 按类别分标签页：基本（id/type/videoUrl）/ 音频（bgmUrl 等）/ 战斗（battleHUD/battleResult）/ 高级（loopStart/keyMoment）
+- [ ] 标签页间切换不丢失编辑状态
+
+---
+
+## 优先级建议
+
+| 优先级 | 编号 | 说明 |
+|:--:|------|------|
+| **P0** | E4 | i18n key 编辑——覆盖最广，P11/P31 都依赖 |
+| **P0** | E10 | 内嵌快速测试——最直接的创作者效率提升 |
+| **P1** | E1 | 热点编辑——P4 是核心交互功能 |
+| **P1** | E6 | 顶级字段——chapters/achievements/endings 创作者需求最大 |
+| **P1** | E12 | JSON 校验——防止导出后游戏崩溃 |
+| **P2** | E7/E8/E9 | 条件路由/关键节点/战斗——新增功能，但依赖前置 |
+| **P2** | E11 | 场景列表搜索——场景多了才有真实需求 |
+| **P2** | E14 | 面板标签页——属性字段达到 20+ 后优势明显 |
+| **P3** | E2/E3/E5 | 单字段编辑——BGM/loop/prompt，改动小 |
+| **P3** | E13 | 撤销/重做——重要但改动不小 |