From 474e89de3adbb3bccb44d6a59dcee014629306b1 Mon Sep 17 00:00:00 2001
From: Joywayer <joywayer@163.com>
Date: Wed, 29 Jul 2026 11:22:15 +0800
Subject: [PATCH] =?UTF-8?q?feat(enemy):=20AbilityRef=E2=80=94=E2=80=94AI?=
 =?UTF-8?q?=20=E5=B1=82=E8=83=BD=E5=8A=9B=E5=BC=95=E7=94=A8=E8=B5=84?=
 =?UTF-8?q?=E4=BA=A7=E5=8C=96=EF=BC=8C=E5=AD=97=E7=AC=A6=E4=B8=B2=E4=BB=85?=
 =?UTF-8?q?=E4=BD=9C=E5=AE=9A=E5=88=B6=E8=84=9A=E6=9C=AC=E5=85=9C=E5=BA=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Assets/Tests/EditMode/AI/AbilityRefTests.cs   | 46 +++++++++++++++++++
 .../Tests/EditMode/AI/AbilityRefTests.cs.meta | 11 +++++
 .../Scripts/Enemies/Abilities/AbilityRef.cs   | 33 +++++++++++++
 .../Enemies/Abilities/AbilityRef.cs.meta      | 11 +++++
 4 files changed, 101 insertions(+)
 create mode 100644 Assets/Tests/EditMode/AI/AbilityRefTests.cs
 create mode 100644 Assets/Tests/EditMode/AI/AbilityRefTests.cs.meta
 create mode 100644 Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs
 create mode 100644 Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs.meta

diff --git a/Assets/Tests/EditMode/AI/AbilityRefTests.cs b/Assets/Tests/EditMode/AI/AbilityRefTests.cs
new file mode 100644
index 00000000..89d82380
--- /dev/null
+++ b/Assets/Tests/EditMode/AI/AbilityRefTests.cs
@@ -0,0 +1,46 @@
+using NUnit.Framework;
+using UnityEngine;
+using BaseGames.Enemies.Abilities;
+
+namespace BaseGames.Tests.EditMode.AI
+{
+    public class AbilityRefTests
+    {
+        [Test]
+        public void ImplicitFromString_ExposesLiteralId()
+        {
+            AbilityRef r = "e001_chase";
+            Assert.AreEqual("e001_chase", r.Id);
+            Assert.IsFalse(r.IsEmpty);
+        }
+
+        [Test]
+        public void FromAsset_ExposesAssetAbilityId()
+        {
+            var so = ScriptableObject.CreateInstance<EnemyAbilitySO>();
+            so.abilityId = "from_asset";
+            AbilityRef r = so;
+            Assert.AreEqual("from_asset", r.Id);
+            Object.DestroyImmediate(so);
+        }
+
+        [Test]
+        public void Default_IsEmpty()
+        {
+            var r = default(AbilityRef);
+            Assert.IsTrue(r.IsEmpty);
+            Assert.IsNull(r.Id);
+        }
+
+        [Test]
+        public void AssetWins_WhenBothSet()
+        {
+            var so = ScriptableObject.CreateInstance<EnemyAbilitySO>();
+            so.abilityId = "asset_id";
+            var r = new AbilityRef(so, "literal_id");
+            Assert.AreEqual("asset_id", r.Id);
+            Assert.IsTrue(r.HasConflict);   // 供校验器报警告
+            Object.DestroyImmediate(so);
+        }
+    }
+}
diff --git a/Assets/Tests/EditMode/AI/AbilityRefTests.cs.meta b/Assets/Tests/EditMode/AI/AbilityRefTests.cs.meta
new file mode 100644
index 00000000..1fc29b23
--- /dev/null
+++ b/Assets/Tests/EditMode/AI/AbilityRefTests.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 30c3cfb4f5ff62f4691343a1ab594f7a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
diff --git a/Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs b/Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs
new file mode 100644
index 00000000..aca18df0
--- /dev/null
+++ b/Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs
@@ -0,0 +1,33 @@
+using System;
+using UnityEngine;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 能力引用。配方资产侧引用 EnemyAbilitySO（Unity 引用系统保证拼不错、改名不断链）；
+    /// 定制 AiScript 侧仍可直接写字符串 id。资产优先。
+    /// </summary>
+    [Serializable]
+    public struct AbilityRef
+    {
+        [Tooltip("能力配置资产；配方路径用这个")]
+        [SerializeField] EnemyAbilitySO _asset;
+
+        [NonSerialized] string _literal;   // 定制脚本路径用；不参与序列化
+
+        public AbilityRef(EnemyAbilitySO asset)              { _asset = asset; _literal = null; }
+        public AbilityRef(string id)                         { _asset = null;  _literal = id; }
+        public AbilityRef(EnemyAbilitySO asset, string id)   { _asset = asset; _literal = id; }
+
+        /// <summary>解析出的能力 id；资产优先，都没有则 null。</summary>
+        public string Id => _asset != null ? _asset.abilityId : _literal;
+
+        public bool IsEmpty => string.IsNullOrEmpty(Id);
+
+        /// <summary>资产与字符串同时非空——歧义配置，供校验器报警告。</summary>
+        public bool HasConflict => _asset != null && !string.IsNullOrEmpty(_literal);
+
+        public static implicit operator AbilityRef(string id) => new AbilityRef(id);
+        public static implicit operator AbilityRef(EnemyAbilitySO asset) => new AbilityRef(asset);
+    }
+}
diff --git a/Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs.meta b/Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs.meta
new file mode 100644
index 00000000..e6445d07
--- /dev/null
+++ b/Assets/_Game/Scripts/Enemies/Abilities/AbilityRef.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 00a0a0d1f0e127a47ad01ea9423bbc0d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: