docs: update P15 to reflect list-based recap, add Dagre timeline future plan

This commit is contained in:
2026-06-09 19:20:11 +08:00
parent 906965c963
commit 5476c1b5cf

View File

@@ -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<string>``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 平台化 — 云存档 + 可访问性 + 自适应码率 + 全局统计(待实现)