多轮审查和修复

Assets/Scripts/Cutscene/CutsceneSO.cs

@@ -0,0 +1,52 @@
+using System;
+using BaseGames.Camera;
+using BaseGames.Dialogue;
+using UnityEngine;
+using UnityEngine.Timeline;
+
+namespace BaseGames.Cutscene
+{
+    /// <summary>
+    /// 过场动画数据资产（架构 14_NarrativeModule §11.5）。
+    /// 定义一段完整的过场内容：Timeline 资产、Track 绑定、摄像机混合、可叠加对话层。
+    /// 资产路径：Assets/ScriptableObjects/Cutscene/CS_{SceneId}_{ContextId}.asset
+    /// </summary>
+    [CreateAssetMenu(menuName = "Cutscene/Cutscene")]
+    public class CutsceneSO : ScriptableObject
+    {
+        [Header("Identity")]
+        public string  cutsceneId;          // 全局唯一，用于存档去重和 CutsceneManager.PlayById 查找
+        public string  displayName;
+        public bool    playOnlyOnce;        // true → 仅首次播放（后续触发跳过）
+        public bool    isSkippable = true;  // 是否允许玩家跳过
+        public Sprite  thumbnail;           // 过场预览图（剧情重放 UI 用）
+
+        [Header("Timeline")]
+        public TimelineAsset Timeline;      // Unity Timeline 资产
+
+        [Header("Timeline Bindings")]
+        // Track 与场景 GameObject 的绑定关系（避免 PlayableDirector 硬引用场景对象）
+        public CutsceneBinding[] Bindings;
+
+        [Header("Camera Blend")]
+        [Tooltip("进入过场时的摄像机混合配置（可空 = 默认瞬切）")]
+        public CameraBlendProfileSO BlendIn;
+        [Tooltip("退出过场时的摄像机混合配置（可空 = 默认瞬切）")]
+        public CameraBlendProfileSO BlendOut;
+
+        [Header("Optional Dialogue Overlay")]
+        [Tooltip("过场中可叠加播放的对话序列（由 Timeline Marker 或 SignalEmitterClip 触发）")]
+        public DialogueSequenceSO[] DialogueLayers;
+    }
+
+    /// <summary>将一条 Timeline Track（通过名称索引）绑定到运行时场景对象。</summary>
+    [Serializable]
+    public struct CutsceneBinding
+    {
+        [Tooltip("Timeline Track 的名称（需与 PlayableDirector 内轨道名一致）")]
+        public string       trackName;
+
+        [Tooltip("绑定的目标对象；若为 null，CutsceneManager 从场景中按 tag/name 查找")]
+        public UnityEngine.Object target;
+    }
+}