剧情+对话完善

docs/save-and-selection-system-status.md

@@ -1,7 +1,7 @@
 # 存档、剧情进度与选曲缓存：当前状态说明
 
 > **适用项目**：`ichni Official`  
-> **最后更新**：2026-07-18  
+> **最后更新**：2026-07-21
 > **状态**：已完成 Core-002 的存档与选曲缓存收尾，以及 Core-003 的统一 Offline 内容解锁模块。
 
 本文记录当前已落地的运行时存档机制、数据边界、字段语义和维护规则。它不是面向玩家的说明；以后修改存档、谱面、剧情或选曲逻辑时，应先阅读本文。
@@ -18,9 +18,9 @@
 
 | 数据域 | 主要职责 | ES3 文件 | 当前 Schema | 启动加载顺序 |
 |---|---|---|---|---|
-| 游戏记录 | 歌曲完成状态、每个谱面的成绩、Chart Revision | `GameSaves/SongSaves.json` | Song Save v1 | 先加载 |
+| 游戏记录 | 歌曲尝试/完成状态、每个谱面的成绩、Chart Revision | `GameSaves/SongSaves.json` | Song Save v1 | 先加载 |
 | 内容解锁 | 已授予的章节/歌曲/教程等内容访问 Key | `GameSaves/UnlockKeys.json` | Unlock Save v1 | 游戏记录后、菜单显示前加载 |
-| 剧情记录 | 各章节剧情树、选项状态、全局 Yarn 变量 | `StorySaves/*.json`（由 `StorySaveModule` 管理） | Story Save v1 | 游戏记录后加载 |
+| 剧情记录 | 各章节剧情树、选项状态、章节 Yarn 变量和回滚快照 | `StorySaves/*.json`（由 `StorySaveModule` 管理） | Story Save v1 | 按章节加载 |
 | 选曲缓存 | 当前运行期间各章节最后选择的歌曲与难度 | 仅内存 | 不适用 | 按需创建 |
 
 `GameSaveManager.Start()` 先初始化 `SongSaveModule` 并加载游戏记录、剧情解锁 Key，再初始化 `StorySaveModule`。菜单和章节 UI 因而可在首次展示前读取成绩和解锁状态。
@@ -45,6 +45,7 @@
 
 | 字段 | 所属层级 | 含义与更新规则 |
 |---|---|---|
+| `SongStatusSave.isTried` | 歌曲 | 玩家曾确认进入该歌曲的 `GameScene`；Story SongBlock 以此作为完成依据，即使中途退出也保持为 `true`。 |
 | `SongStatusSave.isCompleted` | 歌曲 | 任意一个有效游玩结束后置为 `true`；不会因为较差成绩回退。 |
 | `SongStatusSave.additionalInfo` | 歌曲 | 预留信息；当前保持非空字符串，未承载游戏规则。 |
 | `BeatmapSave.accuracy` | 谱面 | 当前 `Chart Revision` 下的最高 Accuracy。 |
@@ -84,7 +85,7 @@
 
 ## 5. 剧情存档
 
-剧情存档由 `Assets/Scripts/NewStorySystem/Save/StorySaveModule.cs` 负责。它独立保存章节剧情树、选项/节点状态和全局 Yarn 变量，并有自己的 Story Save Schema v1。
+剧情存档由 `Assets/Scripts/NewStorySystem/Save/StorySaveModule.cs` 负责。它按章节独立保存剧情树、选项、章节永久变量和 Timeline 回滚快照，并有自己的 Story Save Schema v1。
 
 剧情存档不得承担歌曲 Accuracy、Combo、FC/AP 等游玩数据；反过来，游戏记录也不得复制 Yarn 变量或剧情节点状态。剧情通过 Yarn 命令授予内容解锁 Key，由独立 `UnlockSaveModule` 决定章节和歌曲是否开放。
 
@@ -122,7 +123,7 @@
 - 玩家重新进入同一次运行中的同一章节时，UI 会优先恢复该选择。
 - 若缓存歌曲已不在章节内、难度索引失效、歌曲没有可用难度，系统会安全回退，不会把空难度交给进入游戏流程。
 
-### 6.1 跨歌曲的难度回退规则
+### 7.1 跨歌曲的难度回退规则
 
 当玩家从一首歌拖动到另一首歌，而目标歌曲没有当前难度时，系统会选择目标歌曲中“更接近”的可用难度；距离相同则优先较低的列表序号。例如当前选择难度索引为 `2`，目标歌曲只有 `0`、`1`、`3` 可用时选择 `1`。