发包版本

Assets/Scripts/UI/Base/UiExpandingContoursEffect.cs

@@ -0,0 +1,56 @@
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Ichni.UI
+{
+    /// <summary>
+    /// 将装饰性 UI Image 纳入「UI 效果」图形设置。
+    /// <para>
+    /// 此组件应只挂在使用 <c>UI_ExpandingContours</c> 等可选视觉 Shader 的 Image 上。
+    /// 关闭设置时仅禁用目标 Image 的绘制，不会停用 GameObject，因此布局与子物体状态不受影响。
+    /// 目标应为不承载输入的装饰性 Image。
+    /// </para>
+    /// <para>
+    /// 新增同类 UI 特效时，只需在对应 Image 上添加本组件；无需再在 SettingsManager 中硬编码页面或物体名称。
+    /// </para>
+    /// </summary>
+    [DisallowMultipleComponent]
+    [RequireComponent(typeof(Graphic))]
+    public sealed class UiExpandingContoursEffect : MonoBehaviour
+    {
+        [SerializeField] private Graphic targetGraphic;
+
+        private void Reset()
+        {
+            targetGraphic = GetComponent<Graphic>();
+        }
+
+        private void Awake()
+        {
+            if (targetGraphic == null)
+            {
+                targetGraphic = GetComponent<Graphic>();
+            }
+        }
+
+        private void OnEnable()
+        {
+            // 页面首次显示或从隐藏状态恢复时，重新读取已经加载的玩家设置。
+            bool enableUiEffects = SettingsManager.instance?.settingsSaveData?.enableUiEffects ?? true;
+            ApplyEnabledState(enableUiEffects);
+        }
+
+        /// <summary>
+        /// 设置目标 Image 是否参与绘制。由 SettingsManager 在载入存档、场景切换和玩家切换开关时调用。
+        /// </summary>
+        public void ApplyEnabledState(bool enableUiEffects)
+        {
+            if (targetGraphic == null)
+            {
+                targetGraphic = GetComponent<Graphic>();
+            }
+
+            targetGraphic.enabled = enableUiEffects;
+        }
+    }
+}

Assets/Scripts/UI/Base/UiExpandingContoursEffect.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: e47bc8701d1c446184bf62bffaf104f2