# 编辑器 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 | 撤销/重做——重要但改动不小 |
