EventAlertMod Retail 12.1.0 (Alpha 8.7)

專為《魔獸世界：決戰艾澤拉斯 / 地心之戰 / 午夜 (Retail 12.1.0 / 12.0+)》量身打造的超輕量、零污染、純事件驅動法術監控、技能冷卻、地面效果與角色屬性戰鬥告警插件。

🌟 本次更新亮點 (Release Highlights)

🚀 1. 高頻冷卻事件合併排程與警示更新零分配流水線 (Cooldown Event Coalescing & Zero-Allocation Alert Pipeline)

• 警示排隊佇列零記憶體分配 (Zero-Allocation Queue)：AlertManager 採用持久化槽位（persistentSlots），消除高頻警示更新時每秒數千次的臨時 Table 堆疊分配，根除 Lua GC 垃圾回收卡頓隱患，實機實測記憶體佔用顯著降低約 12 MB，FPS 飆升 +15.1%（86 -> 99 FPS）。
• 冷卻狀態髒檢查與無效重繪阻斷 (Cooldown Dirty State Diffing & Render Suppression)：CooldownService 與 ItemCooldownService 於狀態刷新前嚴格快照並比對 12 項關鍵屬性（顯示、啟用、佔位、灰階、發光、充能、時間），在資料未實質變更時全面抑制狀態廣播與後續繪製，渲染繪製次數暴降 96.9%（從每秒 21 次驟降至 0.65 次）。
• 全域冷卻事件同幀合併排程 (Frame-Level Cooldown Event Coalescing)：針對 SPELL_UPDATE_COOLDOWN、ACTIONBAR_UPDATE_COOLDOWN 與 BAG_UPDATE_COOLDOWN 等無特定法術 ID 負載之高頻全域事件實裝同幀合併調度，杜絕同一幀/Tick 內多次重複的全清單遍歷，極大平滑團隊副本與大秘境高負載環境下的幀率。
• 暴雪官方 AddOn Profiler 深度整合：實裝 C_AddOnProfiler 遙測探針，支援 /eam metrics 即時查看暴雪 C++ 遊戲引擎量測之外掛 CPU 耗時（每幀 CPU 耗時小於 0.08ms）與幀掉落刺波。

📊 2. 角色屬性與吸收量監控全面升級 (Player Stat & Absorb Monitor Upgrade)

• 模組即時開關與生命週期修復：切換開關即時隱藏框架並停止輪詢；底層 Native Aura 結構變更時提供醒目 /reload 警示與一鍵重載按鈕。
• 移動所有屬性與主錨點 GPU 樹狀零延遲同步聯動：拖曳主錨點時，全組屬性框架即時同步跟隨移動。
• 依附目標框架多選：支援 EAM 主錨點、UIParent、玩家頭像、目標頭像、焦點頭像、寵物頭像與 9 大方位錨點。
• 進度條雙色漸層渲染 (SetGradient API)：支援水平與垂直雙色漸層混色渲染，並相容經典降級。
• 全項自選色彩：進度條主色、次色、數值文字、名稱標籤均提供自選調色盤。
• 屬性堆疊自選排序：清單新增上移、下移、重設控制，即時更新畫面堆疊順序。

🏷️ 3. 全模組自訂技能與法術名稱功能實裝 (Custom Display Names Across All Modules)

• 全新支援自訂圖示顯示名稱 (簡稱)：滿足在圖示間距密集、緊湊排版時避免名稱過長互相遮擋的需求（例如可將「聖盾術」簡稱為「盾」、「斬殺」簡稱為「斬」）。
• 條件設定視窗佈局全面升級：新增「自訂顯示名稱 (簡稱)」專屬輸入框，並將視窗高度擴展至 680px，開闊清爽零擁擠。
• 清單列表即時標記：若該項目有設定自訂簡稱，設定清單將即時以「法術名稱 (|cff00ff96簡稱|r)」醒目標註，清單管理一目了然。
• 全模組服務層深度整合：涵蓋自身 Buff、自身 Debuff、目標 Debuff、技能冷卻、物品冷卻（含裝備欄位）與地面效果全流程，優先顯示自訂名稱，留空自動還原預設全稱。
• 原生光環防覆蓋機制：針對 Retail 12.1.0 原生光環容器 (Native Aura) 實裝文字守護鉤子 (Text Guard Hook)，防止暴雪底層預設光環名稱回寫覆蓋。

⚡ 4. 原生光環字型大小即時熱套用修復 (Native Aura Font Size Live Hot-Apply & Zero Reload)

• 免 /reload 即時生效：徹底修復原生光環在設定介面調整「秒數倒數字型大小」、「堆疊層數字型大小」或「法術名稱字型大小」後無法即時反應、必須 /reload 才能生效的重大缺陷。
• 弱引用按鈕註冊池與零配額更新：實裝 NativeAuraRenderer 弱引用按鈕註冊池與 updateButtonFonts 零配額熱套用機制，拉動滑桿直接原位更新，零延遲、無需銷毀容器、不消耗 18 次配額。

🎯 5. 目標光環切換目標即時刷新、殘留圖示清理與倒數鬼影根治 (Target Aura Target-Switching Live Refresh, Ghost Icon Purge & Countdown Ghost Elimination)

• 雙模 Native 12.1 原生容器生命週期重置：PLAYER_TARGET_CHANGED 目標變更時即時重設原生容器，徹底杜絕 C++ 底層遺漏切換導致舊目標光環與原生秒數持續倒數的缺陷。
• Legacy 渲染器即時同步清空與秒數計時器解綁：換目標時直接同步調用 Renderer.clearFrame("targetAura")，立即釋放所有舊圖示與計時器，杜絕異步排程延遲導致舊目標光環殘留。
• 過期暫存排空與事件隔離：清空未 Flush 佇列，修正極性誤判，保證切換目標 100% 即時反應。

🛡️ 6. 技能冷卻與地面效果第一格消失及移動模式坐標漂移根治 (Alert Layout Slot 1 Zero-Anchor Guard & Drag Coordinate Normalization Fix)

• Slot 1 物理死鎖排除：徹底修復 Slot 1 首次渲染時因 (0, 0) 快取碰撞導致的 0 錨點物理蒸發缺陷，建立 GetNumPoints() == 0 物理計數守衛。
• 幾何坐標回正：徹底根治暴雪原生 StopMovingOrSizing 強制改寫 BOTTOMLEFT 導致的幾何大漂移，換算回相對於 UIParent 之 CENTER 坐標。

💬 7. 全語系 CLI 命令列擴充 (Slash Commands Expansion)

• 補齊 /eam preview、/eam rune、/eam add ground 與 /eam lang 即時語系切換指令。
• 聊天框跳脫字元破裂修復：避免 |t 貼圖跳脫碼衝突，命令引導全在地化並徹底剔除生硬英文。

📦 安裝與使用指引 (Installation & Usage)

1. 下載最新版本解壓縮後，將 EventAlertMod 資料夾複製至魔獸世界目錄：
   • 正式服 Retail: World of Warcraft\_retail_\Interface\AddOns\
   • 測試服 PTR: World of Warcraft\_ptr_\Interface\AddOns\
2. 進入遊戲後輸入 /eam 開啟主設定面板，或輸入 /eam opt、/eam preview、/eam metrics。
3. 遊戲中將滑鼠游標懸停於任意技能、物品或巨集圖示上，按下 CTRL + ALT 即可叫出快捷加入面板。