EventAlertMod Retail 12.1.0 Alpha 8.4

EventAlertMod Retail 12.1.0 (Alpha 8.4)

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

---

🌟 本次更新亮點 (Release Highlights)

📐 1. 光環與冷卻模組 2D 矩陣折行排版與自訂換行欄數 (2D Grid Layout Engine)

• 2D 網格折行排版引擎：
  • 自身光環 (selfAura)、目標光環 (targetAura)、技能冷卻 (spellCooldown)、物品冷卻 (itemCooldown) 與地面效果 (groundEffect) 等模組全面升級為二維矩陣排版。
  • 圖示數量超過指定欄數 (Columns) 時，依成長方向自動向下一列 (Row) 折行，杜絕圖示單向無限延伸遮擋視線或超出螢幕邊界的痛點。
• 清單視窗頂部自訂欄數控制：
  • 於監控清單視窗 (listFrame) 頂部專精下拉選單右側增設「每列欄數 (Columns)」滑桿（範圍 1~20，預設 8 欄），支援即時調整與多分類獨立設定保存。
• 零延遲即時重新排版：
  • 滑桿拖曳或切換時，畫面圖示與父容器尺寸零延遲即時重新折行計算，且完全相容戰鬥狀態鎖定防護。
• 設定檔匯出匯入與存檔向後相容：
  • ProfileCodec 匯出/匯入與 SavedVariables 自動遷移補齊各框架 columns 欄位，跨版本升級無痛無縫相容。

👁️ 2. 預渲染冷卻隨戰鬥隱藏與純透明度切換 (Pre-rendered Cooldown Combat Visibility)

• 尊重「非戰鬥顯示技能冷卻」開關：
  • 開啟預渲染 (cooldownPreRender) 佔位的技能冷卻圖示，若設定為隨戰鬥關閉 (showSCDOutsideCombat == false)，在戰鬥外自動透過 SetAlpha(0) 平滑隱藏。
• 戰鬥狀態智慧切換：
  • 進入戰鬥時圖示瞬間以灰階待命顯現 (SetAlpha(1))，施法進入冷卻即亮起正常彩色倒數；脫離戰鬥時再次平滑隱藏 (SetAlpha(0))。
• 槽位常駐零 Taint 污染：
  • 隱藏過程僅變更透明度，絕不釋放 Frame 物件或更動排版 order 槽位，徹底杜絕戰鬥中 Frame 創建限制、Taint 污染與 2D 矩陣位置跳動。

🛡️ 3. 戰鬥中移動速度防護與回退機制 (Combat Speed Restriction Guard)

• 破解 Retail 12.x / Midnight 戰鬥跑速限制：
  • 解決暴雪在戰鬥中限制 GetUnitSpeed("player") 固定回傳 1.0，導致傳統計算公式除以 7.0 後顯示荒謬的 14.3% (1.0 / 7.0 * 100) 跑速問題。
• 真實脫戰有效記憶快取：
  • 實作戰鬥保護檢測：當檢測到回傳值 <= 1.05 且處於戰鬥狀態時，自動回退至脫戰真實有效記憶快取 (lastKnownStats)，確保在戰鬥中依然穩定顯示 100%、130% 等真實移動速度。

🔢 4. 技能冷卻清單 Location Order 排序與單一法術獨立預佔位

• 技能冷卻排序位置 (Location Order)：
  • 清單每一列新增 Location Order 數字輸入框，顯示在畫面排版中的唯一自然數槽位 (1..N)。
  • 支援點擊 ▲/▼ 上下調換、拖曳排序或直接輸入數字快速跳轉，順位自動連續校正。
• 嚴格禁止未啟用項目預先佔位：
  • 未啟用 (enabled == false) 的技能冷卻項目徹底杜絕建立預渲染圖示或佔位顯示，完全不佔用畫面槽位與系統資源。
• 單一法術獨立預先佔位開關：
  • 取消全域 Global 級開關，改由各技能在細部條件設定中獨立開啟/關閉預先佔位（未冷卻時灰階待命，施法冷卻即亮起），預設為關閉。

🎯 5. 清單視窗滾動緊密跟隨與選定高亮 (Scroll Tracking & Selection Highlight)

• 平滑滾動跟隨：
  • 調換順位或點擊項目時，卷軸視窗平滑滾動並緊密跟隨目標技能，並呈現湛藍選定背景高亮，徹底避免操作時視窗重置至頂部或失焦。

⚡ 6. 角色屬性戰鬥即時更新與 C-Level 零 GC 渲染

• 原生格式化零 GC 渲染：
  • 全面採用暴雪原生 FontString:SetFormattedText 進行屬性數值文字渲染，達成 0.00ms C-Level 格式化與零 Lua GC 暫態字串記憶體分配。
• 完整 18 大屬性戰鬥路由：
  • 補齊全 18 大屬性之 getRawValue 戰鬥即時取值路由，配合 Retail 12.x / Midnight 的 AllowedWhenTainted 與 Enum.SecretAspect.Text 規範，徹底修復過去因安全過濾導致戰鬥中屬性數值凍結未更新或文字被清空的缺陷。

---

🛠️ 穩定性修復與工程治理 (Fixes & Governance)

• 🐛 屬性圖示拖曳座標報錯修復：
  • 修復單一屬性圖示在解鎖拖曳時，因 string.format 格式化佔位符缺少對應參數導致的 PlayerStatService.lua:1452: bad argument #4 to 'format' (number expected, got no value) 致命錯誤。
• 📚 權威參考資源庫對齊：
  • 全面收錄 Ketho 三大權威魔獸開發參考庫（WowDoc、BlizzardInterfaceResources、wow-ui-source-midnight-ptr）至專案治理架構。
• 📋 全專案 115 個目錄 HTML 治理清單：
  • 全專案 115 個目錄全面導入兼具人類視覺導覽與 AI 治理的 FOLDER_INDEX.html 說明清單（共 1500 個檔案結構完整核驗）。
• 🚀 發布流程最佳化：
  • 停用本機與 GitHub Release 之 SRC 原始碼重複打包，全面採用 GitHub 原生提供的 Source Code 封裝機制。

---

🧪 品質門禁與驗證數據 (Validation Metrics)

• ✅ Lua 語法檢查 (Syntax Checks)：76/76 全部通過 (PASS)
• ✅ Flow 業務狀態機測試 (State Machine)：85/85 全部通過 (PASS)
• ✅ 全專案自動化契約驗證 (Validation Contracts)：497/497 全部通過 (PASS)
• ✅ 套件完整性核驗：PASS

---

📦 發布產物與校驗資訊 (Artifacts & Checksums)

檔案名稱	說明	SHA-256 雜湊值
EventAlertMod_MN_20260904_183007-alpha-8.4_AGY.zip	遊戲 AddOn 插件安裝包	984fbcf08c2e477687dac0c43a1a78a1eb6c4b4a052e3f0c3827e052a7853a98

ℹ️ 原始碼取得：GitHub 已於下方自動提供本版本完整源碼包（Source code (zip) 與 Source code (tar.gz)），本機不再重複打包上傳 SRC 附件。

---

📥 安裝說明 (Installation)

1. 下載上方附加的 EventAlertMod_MN_20260904_183007-alpha-8.4_AGY.zip。
2. 解壓縮後將 EventAlertMod 資料夾複製至魔獸世界目錄下的 _retail_\Interface\AddOns\ 中。
3. 啟動遊戲即可享受完整功能，遊戲內輸入 /eam 即可開啟主設定面板。

EventAlertMod Retail 12.1.0 Alpha 8.3

Retail 12.1.0 Alpha 8.3 Next-Gen Spell Catalog & Multidimensional Group Management

-- 次世代全量法術庫與智慧預設系統 (Next-Gen Master Spell Catalog & Intelligent Presets)：
   -- 5 語系離線先驗資料庫：收錄全 13 職業、40 專精與 39 英雄天賦樹共 4,463 個核心法術與 466 個光環，支援繁中/簡中/英文/韓文/俄文即時切換。
   -- 階層式樹狀法術庫面板 (SpellCatalogTreePanel)：支援專精展開/收合、三態勾選、名稱與 ID 即時搜尋。
   -- 目標模組自由切換：頂部下拉選單可自選將勾選技能指派至技能冷卻、自身光環、目標光環、特殊光環或地面效果模組清單。
   -- 一鍵天賦智慧同步：整合 SpellBookScannerService 動態探測玩家當前天賦樹與法術書，一鍵自動同步核心技能至所選模組。
   -- 全法術懸停原生技能說明提示 (GameTooltip:SetSpellByID)：滑鼠懸停於法術項目時完整顯示原生法術說明、射程、施法時間與 ID。
-- 多維戰術群組與標籤管理模組 (Multidimensional Group Management Module)：
   -- 群組管理核心服務 (GroupService)：內建 4 大系統戰術群組（主要爆發、關鍵減傷、控場打斷、地面效果）並支援玩家自訂標籤群組。
   -- 支援法術與群組多對多歸屬、群組獨立全域開關與「僅戰鬥中顯示」情境過濾。
   -- 獨立群組管理側窗 (GroupManagerPanel)：支援群組名稱編輯、獨立儲存按鈕、戰鬥情境切換、所屬法術多選與全介面 GameTooltip 懸停說明。
   -- 技能細節視窗整合群組下拉複選器 (Options.lua)：所有技能條件設定視窗頂部增設「所屬群組 (可複選)」下拉按鈕與即時摘要。
-- 穩定性與相容性強化 (Hardening & Bug Fixes)：
   -- 嚴格禁止過時 API：全面替換 GetSpellInfo, GetItemInfo, GetSpellCooldown 為現代 C_Spell / C_Item API，並於 CI 加入靜態 AST 審查。
   -- Profile Codec 匯出/解碼修復：在 buildPayload 加入唯一性過濾，徹底修復實機歷史重複 ID 導致的 duplicateAlertID 報錯。
   -- 字型驗證修復：修正 LSM 載入時的旁路判斷，確保非法字型一律安全回退為 STANDARD。
   -- 修正條件設定視窗下拉文字 SetText 型別不相容問題。

EventAlertMod Retail 12.1.0 Alpha 8.2

EventAlertMod Retail 12.1.0 (Alpha 8.2)

專為《魔獸世界：正式服 (Retail 12.1.0 / 12.0+)》打造的超輕量、零污染、純事件驅動法術監控與戰鬥告警插件。

🌟 本次更新亮點 (Release Highlights)

🔊 1. LibSharedMedia-3.0 (SharedMedia) 素材生態全面整合與動態探測

• 動態素材探測 (MediaService.ensureLSM)：
  • 過去 EAM 依字母排序早於其他 SharedMedia 擴充插件載入，音效清單會被凍結在初始 12 種內建音效；現已加入動態探測機制與 PLAYER_LOGIN 延遲同步刷新，100% 自動抓取所有第三方 SharedMedia 音效包與字型包。
  • 同時查詢 lsm:List("sound") 與 lsm:HashTable("sound") 雙軌資料源並自動去重，確保不遺漏任何自訂素材。
• 安全雙軌音效播放 (MediaService.playSound)：
  • 無縫相容數字 FileDataID、原生 SoundKitID 與自訂字串 FilePath (.ogg / .mp3) 檔案。
  • 設定面板中的「測試」按鈕、光環設定中的「試聽素材」按鈕及點選選單項目時，皆可即時發聲試聽。
• 12.1 Native Aura 原生光環音效接入：
  • 規則編譯器已對接 MediaService.getSoundPath，原生光環觸發時亦可播放 LSM 自訂音效。

🔤 2. 全域字型熱套用與存檔修復（免 /reload 即時生效）

• 字型變更零延遲即時套用：
  • 預覽圖示聯動：更換字型時，畫面上的奶牛頭與位置預覽圖示 (Preview Icons) 立即同步重繪新字型。
  • Native 指紋修復：將 fontFamily 納入 Native Aura 規則指紋 (buildLayoutFingerprint)，修復因指紋相同而略過原生容器重建的問題。
  • 全子系統文字廣播：透過 EAM_FONT_FAMILY_CHANGED 事件，同步即時刷新一般告警圖示 (Renderer)、能量條文字 (PowerRenderer / PlayerResourceService) 與人物屬性文字 (PlayerStatService)。
• 存檔白名單解鎖：
  • SavedVariables.lua 放行所有通過 LSM 註冊的自訂字型名稱，防止重登、重載或切換專精後被強制還原為預設字型。
• 職業資源文字面板整合：
  • 資源監控面板的「字型切換」按鈕已支援循環切換所有 SharedMedia 字型。

🎨 3. UI 下拉選單長清單自適應捲動容器 (ScrollFrame)

• 捲動容器與滾輪支援：
  • 實作通用自適應捲動選單 buildScrollableDropdownMenu。
  • 當 SharedMedia 包含數十或數百種字型／音效時，選單自動限制高度為 10 筆並啟用 UIPanelScrollFrameTemplate 捲軸與滑鼠滾輪支援，版面整潔不破圖。
• 即時素材拉取：
  • 展開音效與字型選單時自動以 forceRefresh 模式向 LSM 抓取最新註冊素材清單。

---

🧪 驗證數據 (Validation Metrics)

• ✅ Lua 語法檢查：71/71 全部通過
• ✅ 流程與狀態機測試：84/84 全部通過
• ✅ 自動化契約驗證：493/493 全部通過
• ✅ 套件建置檢查：PASS

📦 安裝說明

1. 下載下方附加的 EventAlertMod_Retail-12.1.0-Alpha8.2_*.zip。
2. 解壓縮後將 EventAlertMod 資料夾複製至魔獸世界目錄下的 _retail_\Interface\AddOns\ 中。
3. 進入遊戲即可享受完整功能，輸入 /eam 可開啟主設定面板。

EventAlertMod Retail 12.1.0 Alpha 8.1

EventAlertMod Retail 12.1.0 (Alpha 8.1)

🚀 專為《魔獸世界：正式服 (Retail 12.1 / 12.0+)》打造的超輕量、零污染、純事件驅動法術監控與戰鬥告警插件！

---

🌟 Alpha 8.1 核心重大改版與修復亮點 (Major Highlights & Fixes)

1. ⏳ 技能冷卻純透明度（Alpha=0）隱藏模式與全監控冷卻預先錨定 (Persistent Pre-anchoring & Zero-Alpha Mode)：

   • 徹底解決戰鬥中首次施放冷卻技能延遲問題：非戰鬥登入、切換天賦或載入設定時，自動預先為所有已監控之技能冷卻與物品冷卻建立 Frame，並精確計算螢幕座標定位。
   • 冷卻完成改由 SetAlpha(0) 隱藏：冷卻結束時圖示透明度設為 0，保留 Frame 結構常駐介面，杜絕戰鬥中動態釋放與排版重算；戰鬥中施放技能瞬間恢復 SetAlpha(targetAlpha) 顯示，實現 0.00ms 零 GC 零排版延遲且 100% 免疫戰鬥鎖定。

2. 📊 角色屬性與副屬性戰鬥中防歸零修復 (Combat Stat Cache & Multi-Tier API Fallback)：

   • 解決 Retail 12.0+/12.1+ 進入戰鬥後呼叫原生 Unit / Stat API 受限回傳 Secret Number 導致力量、敏捷、智力、耐力、致命、加速、精通、臨機應變等數值歸零問題。
   • 建立全 18 項屬性 lastKnownStats 記憶體快取表，並在登入、切換專精、更換裝備及脫離戰鬥時自動執行預熱 (prewarmStats)，戰鬥中若遇受限環境自動無縫回退至最後有效真實數值。
   • 副屬性全面補齊系別 API (GetCritChance / GetSpellCritChance 等) 與等級評級轉換公式容錯。

3. 🛡️ 角色屬性依職業獨立設定 (Per-Class Player Stat Profiles)：

   • 角色屬性監控全面升級為「依職業獨立配置設定」：每種職業（例如聖騎士、法師、戰士、牧師等）擁有專屬獨立的屬性監控項目開關、圖示大小、字型、閾值與獨立位置座標。
   • 切換不同職業角色時自動無縫載入該職業設定，設定面板標題即時標註當前職業名稱（例如「★ 角色屬性與吸收量監控 [聖騎士]」）。

4. 🧪 吸收盾與治療吸收量雙軌偵測強化 (Dual-Channel Shield & Heal Absorb Detection)：

   • 強化總吸收盾量 (totalAbsorb) 與治療吸收量 (healAbsorb) 取值核心：支援原生 Unit API 與 C_UnitAuras 增益/減益點數 (aura.points) 雙軌即時累加運算，徹底解決吸收盾無法顯示問題。
   • 補齊 UNIT_HEAL_ABSORB_AMOUNT_CHANGED、UNIT_HEALTH、UNIT_MAXHEALTH 與 PLAYER_SPECIALIZATION_CHANGED 事件監聽。
   • 修復全選單按鈕在安全關閉面板時觸發的 inCombat 未定義報錯。

5. 🔮 光環模組支援護盾吸收量即時顯示 (Aura Shield Absorb Amount Display)：

   • 光環監控核心 (AuraService) 自動從 C_UnitAuras 提取護盾類光環（如真言術:盾、冰甲護盾、靈魂汲取等）的即時剩餘吸收盾數值 (state.absorbAmount)。
   • 渲染器 (Renderer) 於光環圖示右下角疊加層精確格式化顯示剩餘吸收盾量（如 45.2k、1.2M），若同時具備多層數則自動並列顯示（如 3(45k)）。

6. 📦 圖示物件池 (IconPool) 擴容與安全放行：

   • 預熱池容量由 16 擴增至 64，並在池耗盡時直接安全呼叫 createIcon 建立，杜絕戰鬥中回傳 nil。

---

📦 安裝說明 (Installation)

1. 下載下方 Attached Assets 中的 EventAlertMod_Retail-12.1.0-Alpha8.1_*.zip。
2. 解壓縮後將 EventAlertMod 資料夾複製至魔獸世界正式服目錄：
   World of Warcraft\_retail_\Interface\AddOns\EventAlertMod
3. 進入遊戲即可享受極致流暢、零污染、零延遲的法術監控告警體驗！

Retail 12.1 Alpha 8.0

EventAlertMod Retail 12.1 (Alpha 8.0) 🚀

🌟 核心重大更新 (Major Highlights)

1. 角色屬性依職業獨立配置 (Per-Class Player Stat Profiles)

• 多職業獨立儲存：角色屬性監控全面升級為「依職業獨立配置」，每種職業（例如聖騎士、法師、戰士、牧師、德魯伊等）皆有 100% 獨立的屬性監控配置、項目開關、圖示大小、字型、閾值與獨立位置座標。
• 無縫自動載入：切換不同職業角色時自動無縫載入該職業設定；二級設定面板頂部即時標註當前職業名稱（例如「★ 角色屬性與吸收量監控 [聖騎士]」）。

2. 總吸收盾量與治療吸收量雙軌取值強化 (Dual-Channel Absorb Detection)

• 雙軌即時取值：支援原生 Unit API 與 C_UnitAuras 增益/減益點數 (aura.points) 雙軌即時累加運算，徹底解決吸收盾不顯示或延遲問題。
• 清晰數值格式化：無護盾或數值為 0 時清晰顯示 "0"（而非 "0.0" 或空白）；大數值支援 k / M 智慧縮寫（如 150.4k、1.2M）。
• 補齊事件監聽：補齊 UNIT_HEAL_ABSORB_AMOUNT_CHANGED、UNIT_HEALTH、UNIT_MAXHEALTH 與 PLAYER_SPECIALIZATION_CHANGED 事件。

3. 光環模組護盾吸收量即時顯示 (Aura Shield Absorb Amount Display)

• 護盾數值自動提取：光環服務核心 (AuraService.lua) 自動從 C_UnitAuras 提取護盾類光環（真言術:盾、冰甲護盾、靈魂汲取、暗影結界等）的即時剩餘吸收盾量。
• 渲染器精準疊加：渲染器 (Renderer.lua) 於光環圖示右下角疊加層優先格式化顯示護盾吸收量（如 45.2k、1.2M）；若光環同時具有多層數則自動並列顯示（如 3(45k)）。

4. 取消圖示純文字自適應排版與獨立定位 (Iconless Adaptive Layout & Positioning)

• 自適應容器尺寸：取消顯示圖示（純文字模式）時，依「上方/下方/左側/右側」數值方位動態計算容器尺寸，橫向並列自動拓寬防折行，縱向上下居中對齊。
• 項目維度累加間距演算法：整體排列方向（向右/向左/向上/向下）下，混合模式（部分圖示、部分純文字）均能維持精確等距，徹底杜絕文字重疊與錯位。
• 獨立自訂位置與拖曳：每項屬性均可獨立勾選「啟用此項獨立位置」，在畫面上直接以滑鼠拖曳定位並即時雙向同步 X/Y 滑桿。

5. 系統穩定性與排版修復 (System & UI Fixes)

• 按鈕切換防禦性修復：補齊 PlayerStatService.lua 本地 inCombat() 函式定義，徹底消除點擊主選單分類按鈕與關閉面板時觸發的 nil call 報錯。
• 飛龍模式飛速圖示修復：改用數值型 FileDataID 4667307 與動態 API 獲取原生圖示，消除黑框。
• 主選單排版精確對齊：修復「測試閃爍」按鈕覆蓋文字問題，將「啟用 12.1 原生圓形光環倒數光圈」回歸主設定選單核心控制區。

---

📦 安裝說明

1. 下載下方附加的 EventAlertMod_Retail-12.1.0-Alpha8.0_*.zip。
2. 解壓縮並將 EventAlertMod 資料夾複製至魔獸世界正式服目錄：World of Warcraft\_retail_\Interface\AddOns\。
3. 進入遊戲輸入 /eam 開啟主設定面板，調整即時生效！

Retail 12.1 Alpha 7.9

Retail 12.1 Alpha 7.9

📝 更新日誌 (Changelog)

-- [Retail 12.1.0 Alpha 7.9 Full UI Hover Tooltips & Center Reset & Showcase] 2026.08.24
    -- 全介面控制項懸停提示 (Comprehensive UI Hover Tooltips)：
       -- 在全部按鈕、核取方塊、滑桿、下拉選單、輸入編輯框與清單操作列加入直觀的懸停說明提示 (Hover Tooltips)，清晰標註控制項用途、設定範圍與操作指引。
       -- 實作通用工具函式 EAM.UI.setTooltip，支援純文字、多語系字串與表格綁定，徹底消除介面操作門檻。
       -- 覆蓋主設定面板、告警框架排版、法術清單、細部條件、批次輸入、角色屬性、職業資源、功能模組、Profile 分享與除錯中心共 10 大視窗。
    -- 主視窗螢幕邊界鎖定與一鍵居中重置 (ClampedToScreen & Center Reset Command)：
       -- 主視窗增加 SetClampedToScreen 螢幕邊界鎖定，防止拖出畫面無法找回。
       -- 新增 /eam reset (或 /eam center / resetpos) 斜線命令、小地圖按鈕中鍵點擊與 Shift+點擊，一鍵將主視窗拉回螢幕正中央。
       -- 修正關閉主視窗時在 closeAllSidePanels 缺少 close() 引發的 nil call 錯誤，實作防禦性 safeClosePanel 機制。
    -- 官方 README 圖文導覽與 GitHub 直連展示 (Visual Showcase)：
       -- 整理 14 張全功能高畫質介面截圖，分類涵蓋系統選單、法術條件與階層吸附、職業資源與屬性排版。

---

📦 發布產物與 SHA-256 校驗 (Artifacts)

檔案名稱	說明	SHA-256 雜湊值
EventAlertMod_MN_20260824-alpha-7.9.zip	遊戲 AddOn 插件安裝包	975E2C18509E2501E7CF9C7E7239151B2E7E261D32FBB67DFFB6855BD20B8DA7
Project_EventAlertMod_SRC_20260824-alpha-7.9.zip	專案完整工程原始碼包	34037C8E7F0DF04CF434C3884F7C969FEC0912E3F4038E24A80FDDE8734F4C3C

Retail 12.1 Alpha 7.8

Retail 12.1 Alpha 7.8

📝 更新日誌 (Changelog)

-- [Retail 12.1.0 Alpha 7.8 Player Stats & Custom Icons & Classic Preview] 2026.08.24
    -- 「★ 角色屬性與吸收量監控」全新模組：
       -- 支援 18 種核心屬性取值監控（主屬性：力量、敏捷、耐力、智力；副屬性：致命、加速、精通、臨機應變；輔助與生存：閃避、汲取、速度屬性評級、跑速、泳速、飛速、飛龍模式飛速、總吸收盾量、治療吸收量、護甲值）。
       -- 速度類別全面淬鍊：跑速 (GetUnitSpeed 地面即時與上限跑速)、泳速 (水下速度)、飛速 (穩定飛行 310%~420%)、飛龍模式飛速 (調用 C_PlayerInfo.GetGlidingInfo 專屬 API 取得 830%~1400% 動能滑翔速度)，並以 0.1s 高頻計時器平滑刷新。
       -- 繁體中文術語嚴格對齊台灣官方用語（致命、加速、臨機應變）。
       -- 獨立二級設定面板：無縫依附主視窗右側並支援同步平滑拖曳；支援個別自訂開關、是否顯示圖示、替代圖示路徑/代碼、圖示大小、數值字型大小、代表名稱字型大小、名稱替代文字、小數位數 (0~2)、大數值簡寫 (k/M)、警戒值上下限紅框警示、進度條開關與獨立框架定位排版。
    -- Secret Value 防護與原生 StatusBar Sink 整合：
       -- 針對 Retail 12.0+ / 12.1+ 部分 Unit API（如吸收量、移速等）在戰鬥/受污染環境下回傳受保護之 Secret Number，全面加入安全數值檢查，防止 Lua 層運算或格式化報錯。
       -- 為屬性框架預建原生 C-Level StatusBar，遭遇 Secret 數值時直接將原始數值單向傳入 StatusBar:SetValue 展現視覺進度比例。
       -- 支援依屬性類別專屬著色（吸收盾天藍、治療吸收紫紅、移速青綠、副屬性金黃、主屬性橙紅、護甲鋼藍）。
    -- 全模組自訂替代圖示支援 (Custom Icon Override)：
       -- 在自身光環、目標光環、技能冷卻、物品冷卻、地面效果等所有模組細部設定中，新增「自訂替代圖示（代碼或材質路徑）」輸入框、即時動態預覽方塊與 Wago.tools 查詢網址框。
       -- 服務層發布告警狀態時優先採用自訂圖示覆蓋原生預設圖示。
    -- 經典奶牛頭位置預覽 (Classic Cow Head Anchor Preview)：
       -- 拖曳排版位置時改用經典奶牛頭圖示 (Spell_Nature_Polymorph_Cow) 作為畫面預覽，並支援 8 大告警框架即時標籤名稱與紅/綠框高亮區分。
    -- 全方位即時熱預覽 (Live Real-time Config Preview)：
       -- 調整圖示尺寸、水平/垂直間距、透明度、扇形倒數轉圈動畫、轉圈透明度、自身/目標減益色度、法術/倒數/堆疊字型大小、成長方向時，畫面上告警框架與圖示即時 60fps 熱更新響應，無需重啟。
    -- 進入戰鬥全螢幕紅框閃爍 (In-Combat Fullscreen Red Edge Flash)：
       -- 實作 UI/CombatFlash.lua 全螢幕低血/戰鬥紅框閃爍動畫，監聽 PLAYER_REGEN_DISABLED 事件觸發戰鬥進入警示，並在主選單提供即時測試按鈕。
    -- 主題樣式與面板關閉修復：
       -- EAM 預設主題改回經典魔獸紅色選單按鈕與仿石框邊緣。
       -- 修正關閉主視窗時在 closeAllSidePanels 缺少 close() 引發的 nil call 錯誤，實作防禦性 safeClosePanel 機制。

---

📦 發布產物與 SHA-256 校驗 (Artifacts)

檔案名稱	說明	SHA-256 雜湊值
EventAlertMod_MN_20260824_173826-alpha-7.8.zip	遊戲 AddOn 插件安裝包	be6cec432cb85c649dd6659b81234aeac53e14bc8898cac36ab8dd5783b33db0
Project_EventAlertMod_SRC_20260824_173846-alpha-7.8.zip	專案完整工程原始碼包	7cd3f64a668f6e1b64a22775633b8aa30c4a5c14314fbf835a0ada6d129fbf80

Retail 12.1 Alpha 7.7

Retail 12.1 Alpha 7.7

📝 更新日誌 (Changelog)

-- [Retail 12.1.0 Alpha 7.7 Interactive Frame Anchors & Layout Management] 2026.08.24
    -- 子視窗聯動移動錨點：點擊各類別監控（自身增益、跨職業、目標增益、技能冷卻、物品冷卻、地面效果、玩家職業資源）子視窗時，自動在畫面上亮起該模組專屬半透明移動錨點框（標記按住左鍵拖曳），方便玩家直觀拖曳調整在畫面上的定位。
    -- 排版位置全開模式：開啟「告警框架位置與排版」視窗時自動亮起全部 7 大框架移動錨點，關閉子視窗或主選單時自動隱藏所有錨點並套用最新座標排版。
    -- 全二級附屬側窗互斥：開啟職業資源、除錯中心、Profile 匯入/匯出、功能模組、關於或清單子視窗時，自動關閉其他側邊面板，徹底消除多個側窗堆疊重疊問題。
    -- 除錯中心與診斷匯出修復：修正流程測試分頁運行非同步回傳布林值導致的 index error，補全格式化輸出；修正系統診斷報告匯出按鈕調用。

---

📦 發布產物與 SHA-256 校驗 (Artifacts)

檔案名稱	說明	SHA-256 雜湊值
EventAlertMod_MN_20260824_153329-alpha-7.7.zip	遊戲 AddOn 插件安裝包	a61375caaeb30ec8e32ee859f50d97d48f2dae3f945f27ceaceaf118cb44de76
Project_EventAlertMod_SRC_20260824_153329-alpha-7.7.zip	專案完整工程原始碼包	64de36830bd827b62f10d251cbe03eccc8bc61a75a7a163de73914f74aa12961

Retail 12.1 Alpha 7.5

Retail 12.1 Alpha 7.5

📝 更新日誌 (Changelog)

-- [Retail 12.1.0 Alpha 7.6 UI & Feature Overhaul] 2026.08.23
    -- 在每個模組視窗出現關聯的框架供使用者移動定位
    
-- [Retail 12.1.0 Alpha 7.5 UI & Feature Overhaul] 2026.08.23
    -- 介面佈局重構：主選單第 7 項目提升為「★ 玩家職業資源設定」，排版位置微調為第 8 項目，除錯類功能統整至 4-Tab「除錯與測試診斷中心」。
    -- 全視窗快速關閉：所有視窗右上角加入原生 [X] 快速關閉按鈕。
    -- 階層式無縫吸附 (APPEND Docking)：主選單 ➔ 清單/排版/資源 ➔ 細部條件/批次輸入 視窗依序向右緊密貼合，並支援多視窗同步平滑拖曳。
    -- Profile 分享功能升級：支援 8 大自選項目匯出／匯入（自身/目標光環、技能/物品冷卻、地面效果、框架排版位置、職業資源設定、一般偏好設定），並提供快捷選取按鈕與預覽區塊分析。
    -- 職業資源設定即時生效：設定滑桿與下拉選單數值變更時即時驅動原生渲染器更新，非戰鬥不需 /reload。
    -- 死亡騎士符文強化：圖示依血魄 (250)、冰霜 (251)、穢邪 (252) 專精動態切換專屬圖示；下方增設 6 格微型充能冷卻條，由排程器平滑驅動；提供 /eam rune 槽位診斷與複製視窗。

---

📦 發布產物與 SHA-256 校驗 (Artifacts)

檔案名稱	說明	SHA-256 雜湊值
EventAlertMod_Alpha_7.5_20260823_213943.zip	遊戲 AddOn 插件安裝包	531128e03f78048600acb59626f6e24551beff55bb85960f6f7f4168d664c4d4
Project_EventAlertMod_SRC_20260823_213133_AGY.zip	專案完整工程原始碼包	c20e187ceca3b7aae9cbaf500dfec74d9332a462176df7f28eeeb085933cc7dc

EventAlertMod Retail 12.1 Alpha 7.4

Alpha 7.4 重點

• 充能技能改以剩餘次數／最大次數驅動分段 StatusBar，支援 TOP、BOTTOM、LEFT、RIGHT 與 TGA ring grid；「冷卻完成時移除」對充能技能只在 spent 後回滿才成立。
• DK 符文改由六槽 GetRuneCount／GetRuneCooldown 初始化，再由 RUNE_POWER_UPDATE(index, added) 即時更新；符能維持獨立資源條。
• GroundEffect 支援 Base／Override／SpellInfo 法術族群對應，修正死亡凋零／褻瀆等 override miss；Secret spellID 維持 fail-closed。
• 冷卻監控嚴守首次玩家施放才啟動，三項冷卻行為可由個別技能覆寫全域設定。
• 玩家資源設定可即時更新；內嵌 LibStub／LibButtonGlow，並保留 EAM fallback。
• 部署工具支援通道／版本選擇、WTF EventAlertMod 全角色存檔備份與還原；不再以 WoW 執行中作部署阻擋。

離線驗證

• Lua 5.1 syntax：64/64
• Flow all：82/82
• Flow boundary：61/61
• Validation Contracts：493/493
• AddOn ZIP inventory：97 files
• Source ZIP inventory：354 files；排除 Dist、任意深度 .git／backup／TestResults／patch-temp／trash

實機邊界

這是 Alpha prerelease。上述結果是離線與靜態證據，不等於 Retail／PTR／XPTR 真人實機通過。請先用專案部署工具部署目標通道並 /reload，再優先簽收 DK 符文、死亡凋零／褻瀆、反魔法立場與充能 ring。