diff --git a/ROADMAP.md b/ROADMAP.md index c0d184b..9255e9e 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -784,18 +784,38 @@ QTE 成功 / 到达隐藏结局 / 通关等"事件型"成就,通过在对应 e - [x] `src/App.vue` — 整合 AchievementToast + 主菜单"成就"入口 - [x] `public/scenes/demo.json` — 3 个成就 + QTE success 变量 set + alone_ending onEnter -### P15 结局画廊 + 章节回顾 — 分支图 + 完成度百分比 + 条件提示 ✅ 已完成 2026-06-09 +### P15 结局画廊 + 章节回顾 — 列表 + 完成度百分比 + 条件提示 ✅ 已完成 2026-06-09 -目标:通关后展示结局画廊和章节分支流程图,包含完成度百分比和未解锁分支的条件提示, -驱动重玩探索。对标 Detroit 的流程图体验。 +目标:通关后展示结局画廊和章节场景清单,包含完成度百分比和未解锁分支的条件提示, +驱动重玩探索。 -**设计决策(对标 Detroit / Dark Pictures):** +**设计决策:** | 决策 | 做法 | |------|------| | **结局存储** | 共用 `visitedSceneIds`,不独立建表。`endings` 数组声明哪些场景是结局,画廊查 `visitedSceneIds.has(sceneId)` | | **路径追踪** | **节点级** `visitedSceneIds: Set` — `goToScene` 中 `visited.add(scene.id)` | -| **回顾 UI** | Vue Flow 只读完整分支图 + 已到达节点绿色实心高亮 + 未到达节点灰色虚线边框 | +| **回顾 UI** | 列表模式:BFS 遍历可达场景 → visited/unvisited 列表 + 完成度百分比 + 条件提示 | + +> **关于分支图(未实施):** 原计划使用 Vue Flow 只读完整分支图(绿色实心高亮 visited 节点、灰色虚线边框 unvisited 节点),但经评估后确认:分支数一旦增多(多父同子、回边循环),自动布局的流程图会变成"意大利面",玩家理解成本反而高于简单列表。列表版已满足 P15 的核心目标——知道哪些场景到过、漏了什么、怎么解锁。 +> +> **业界对比与未来路线:** +> +> | 方案 | 做法 | 清晰度 | 成本 | +> |------|------|--------|------| +> | **Detroit 手绘图** | 美术逐章手工设计 InfoGraphic | 极高 | 极高 | +> | **Life is Strange 时间线** | 只画 `keyMoment` 标记的关键节点,Dagre 自动排成水平时间线,跳过琐碎小场景 | 高 | 中 | +> | **Telltale 纯统计** | 片尾弹出 "52% 玩家选了救 Doug",不画任何图 | N/A | 极低 | +> | **当前列表版** | BFS 遍历全场景 + visited/unvisited 标记 | 中 | 已实现 | +> +> **未来升级路线(Life is Strange 时间线方案):** +> +> 当需要可视化展示时,采用 Dagre 时间线方案而非全分支图: +> - `SceneNode.keyMoment?: boolean` — 场景标记为"关键节点",只有标记了的场景才出现在时间线图中 +> - Dagre `rankdir: 'LR'` 从左到右水平排列,仅展示关键节点的 choices / nextScene / QTE 跳转 +> - visited 节点绿色实心,unvisited 节点灰色虚线,条件提示小锁 +> - 普通小场景不展示,避免线路交织 +> - 回边用虚线半透明处理 **结局画廊:** @@ -810,30 +830,31 @@ QTE 成功 / 到达隐藏结局 / 通关等"事件型"成就,通过在对应 e 引擎 `goToScene` 到达场景时自动记录 visited。画廊检查 `visitedSceneIds.has(ending.sceneId)`。 -**章节回顾新增:** +**章节回顾(当前列表版):** **完成度百分比:** 每章展示 "3/7 (43%) 场景已发现"。 统计该章 `startScene` 可达的场景数作为分母,visited 中属于本章的场景数作为分子。 -**条件提示:** 分支图中一些灰色节点显示小锁图标 + 条件提示: +**条件提示:** 未到达节点显示小锁图标 + 条件提示: ``` -[灰色节点] 🔒 需要 trust >= 80 +⬜ secret_ending 🔒 trust >= 80 ``` 引擎读取该边对应 choice/hotspot 的 `conditions`,展示第一个未满足的条件。 **实现清单:** -- [x] `engine/types.ts` — `GameData.endings`、`EndingDef { id, label, sceneId, thumbnail? }` +- [x] `engine/types.ts` — `GameData.endings`、`EndingDef { id, label, sceneId, chapterId?, thumbnail? }` - [x] `engine/core/Engine.ts` — `goToScene` 中 `onMarkVisited(scene.id)` 回调 - [x] `engine/core/SceneManager.ts` — `getScenes()` 公开 scenes 数据 - [x] `engine/systems/SaveSystem.ts` — DB v6 新增 `visited` 表 -- [x] `src/components/EndingGallery.vue` — 结局缩略图网格 + 锁定(?剪影)/解锁(画面) +- [x] `src/components/EndingGallery.vue` — 结局缩略图网格 + 锁定/解锁 + 点击打开章节回顾 - [x] `src/components/ChapterRecap.vue` — BFS 遍历可达场景 + 完成度进度条 + visited/unvisited 列表 + 条件提示 - [x] `src/stores/gameStore.ts` — endings/visitedSceneIds/showEndingGallery 状态 - [x] `src/App.vue` — 主菜单"画廊"入口 + EndingGallery/ChapterRecap 组件 -- [x] `public/scenes/demo.json` — 3 个 endings + `end_*.jpg` 缩略图 +- [x] `public/scenes/demo.json` — 3 个 endings + `end_*.jpg` 缩略图 + `chapterId` 关联 - [x] `public/images/end_{trust,alone,continue}.jpg` — 结局缩略图 - [x] 验证:TypeScript + Vite build 通过 +- [ ] 未来:Dagre 关键节点时间线图(`SceneNode.keyMoment?: boolean`) ### P16 平台化 — 云存档 + 可访问性 + 自适应码率 + 全局统计(待实现)