POE_tool v3.3.0

🚀 POE_tool v3.3.0 正式發布 (Release Notes)

歡迎來到 POE_tool v3.3.0 重大版本！本次更新專注於工程地基重塑、PoE 1 vs PoE 2 雙引擎能力隔離、結構化滾動日誌、主版面側邊導覽與首頁儀表板，並同步交付了完整的 PoE 2 終局地圖（Waystones）三大核心功能。

---

✨ 核心新功能與亮點 (Highlights)

1. ⚖️ PoE 1 vs PoE 2 雙引擎能力邊界與功能隔離 (#194)

• 建立型別安全領域模型 ENGINE_CAPABILITY_MATRIX，嚴格標註世代專屬機制（輿圖天賦、章節拓荒、工藝模擬）與雙世代共用功能。
• 實作 StorageNamespaceAdapter 與路由防呆重導向，杜絕跨世代暫存覆蓋。
• 推出「專注模式 (Focus Mode)」，支援一鍵隱藏當前遊戲世代不適用的功能分頁。

2. 🪵 結構化滾動日誌系統與敏感資料脫敏 (#195)

• 後端 Rust 微核心實作 LogRotator，單檔嚴格限制 1MB、3 份滾動備份（.log.1, .log.2, .log.3），循環覆寫杜絕磁碟膨脹。
• 實作 LogSanitizer，自動遮蔽脫敏 POESESSID、Bearer Token、Cookie 與敏感連線資訊。
• 前端設定頁提供「一鍵匯出診斷日誌 (Export Diagnostic Logs)」，便於除錯與社群回報。

3. 🎨 應用主版面側邊導覽與首頁儀表板重構 (#197)

• 徹底移除過載的頂部水平按鈕列，改採左側模組分組邊欄（市集與定價、輿圖與刷圖、流派與工藝、資產財務），支援極簡圖示收合模式。
• 打造全新 Home 總覽儀表板，提供經濟看板、快捷功能卡片與最近刷圖收益摘要。
• 統一三層 Surface 色彩階層與 Design Tokens，消除水平捲軸溢出與資訊視覺過載。

4. 🗿 PoE 2 銘刻地圖 (Waystone) 詞綴危險評級與洗圖精算 (#190)

• 專屬 PoE 2 銘刻地圖危險詞綴庫，比對玩家機體抗性弱點動態校準秒殺危險等級。
• 點金/重鑄、蛻變/增幅/富豪、混沌直骰三種策略之單次命中率、期望成本與 95% 保底消耗精算。

5. 🗺️ PoE 2 遊戲日誌解析與金幣時薪收益追蹤 (#191)

• 深度解析 PoE 2 Client.txt，以狀態機即時追蹤進圖、首領討伐、陣亡與回城。
• 精算單場金幣淨拾取量、總利潤與 Gold/hr、Divine/hr 時薪，雙世代歷程命名空間隔離。

6. 🗼 PoE 2 先祖塔台與生態群落策略優化器 (#192)

• 實作多塔交疊共振乘數模型（雙塔 +15%、三塔 +35% 額外加乘）與 9 種先祖碑牌 (Precursor Tablets) 插槽效益聚合。
• 建立 6 大生態群落（荒漠、密林、凍原、火山、遺跡、沼澤）與 6 種終局目標之契合度打分演算 (0~100) 與戰術建言。

7. 📚 軟體工程多層架構文檔中心與發布治理 (#193, #196)

• 翻新精簡 README.md，模組化拆分規格文檔至 /docs/（user-guide/, features/, architecture/, development/）。
• 嚴格落實 SemVer 2.0.0 與 Milestone 一對一治理門檻，杜絕微版本膨脹。

---

🧪 品質與工程標準 (Quality Standards)

• 1145+ 項自動化單元測試全數通過（233 個 Vitest 前端測試檔 1060 項測試 + 86 項 Rust Cargo 測試）。
• 全專案 0 顯式 any、TypeScript 嚴格編譯 0 錯誤、oxlint 0 警告。
• 嚴格遵守單檔長度限制（邏輯 $\le 200$ 行、UI/測試 $\le 300$ 行、函式 $\le 30$ 行）。

Full Changelog: v3.2.0...v3.3.0

What's Changed

• refactor(versioning): redesign release lifecycle and streamline roadmap milestones by @saijo0404 in #198
• feat(logger): implement structured rolling log system with size caps and diagnostic export by @saijo0404 in #199
• feat(core): establish explicit PoE 1 vs PoE 2 capability matrix and adaptive UI partitioning by @saijo0404 in #200
• refactor(ui): redesign application layout and navigation to eliminate visual clutter by @saijo0404 in #201
• docs(architecture): modernize README and modularize technical documentation into structured docs repository by @saijo0404 in #202
• feat(waystone): build PoE 2 waystone mod risk rating and rolling cost forecaster by @saijo0404 in #203
• feat(mapping): implement PoE 2 game log parser and gold profit tracker by @saijo0404 in #204
• feat(waystone-towers): develop PoE 2 precursor tower and biome strategy optimizer by @saijo0404 in #205
• chore(release): bump version to v3.3.0 and update changelog & roadmap by @saijo0404 in #206

Full Changelog: v3.2.0...v3.3.0

POE_tool v3.2.0

⚔️ POE_tool v3.2.0 PoE 2 雙武器配置與技能切換輔助系統正式發布！

本版本針對《流亡黯道 2 (Path of Exile 2)》革命性的雙武器配置機制，提供從底層雙武器領域模型、技能綁定解析、雙天賦點數分離校驗，到連段異常狀態協同與拓荒/攻堅權重評分，以及遊戲內懸浮 HUD 即時指示器的全流程輔助系統。

✨ 核心亮點功能

• PoE 2 雙武器組與雙天賦分配領域模型 (Dual Weapon Sets & Dual Spec Domain Model)：
• 建立 WeaponSet ('Set1' | 'Set2')、EquippedWeapon 與 DualSpecAllocation 領域模型與不可變資料結構 (#183, #186)。
• 實作雙語基底類型分類器 classifyWeaponType 與副手合法性校驗 isValidOffHand（完整支援弓/十字弓配備箭袋，近戰雙手武器互斥保護）。
• 實作技能武器需求自動綁定解析器 resolveSkillWeaponRequirements 與主動切換邏輯。
• 實作武器專屬雙天賦點數分離校驗器 validateDualSpec 與本地命名空間持久化儲存 DualWeaponStorage。
• 雙武器組屬性差額與連段協同運算引擎 (Dual Setup Stat Delta & Combo Synergy Engine)：
• 實作 calculateWeaponSetDelta 精算攻擊/法術點傷、攻速、暴擊、防禦與抗性之相對及百分比差額 (#184, #187)。
• 實作 PoE 2 特色連段異常狀態協同引擎 calculateComboSynergy，精算焦油點燃、冰凍碎裂猛擊、破甲割裂等連鎖乘數與加成覆蓋。
• 實作情境權重評分引擎 calculateScenarioScore，針對拓荒清圖 (Mapping) 與攻堅王戰 (Bossing) 智慧評估兩組武器之契合度得分。
• 遊戲內雙武器即時切換懸浮指引與狀態條 (Weapon Swap In-Game HUD & Active Setup Overlay)：
• 實作 useWeaponSwap Hook 監聽全域與本機切換熱鍵（預設 X），支援 Set 1 / Set 2 快速切換與即時狀態同步 (#185, #188)。
• 打造 WeaponSwapIndicator 懸浮 HUD 元件，具備主副手武器類型徽章、天賦點數分配進度條、不相容技能警示與差額矩陣展開卡片。
• 整合至 OverlayApp，於 PoE 2 引擎模式自適應渲染，並提供極簡模式快速收合。

What's Changed

• feat(dual-spec): design PoE 2 dual weapon sets and skill binding domain model by @saijo0404 in #186
• feat(dual-spec): implement dual setup stat delta and skill synergy calculation engine by @saijo0404 in #187
• feat(hud): build in-game weapon swap HUD and active setup overlay indicator by @saijo0404 in #188
• chore(release): bump version to v3.2.0 and update changelog & roadmap by @saijo0404 in #189

Full Changelog: v3.1.0...v3.2.0

What's Changed

• feat(dual-spec): design PoE 2 dual weapon sets and skill binding domain model by @saijo0404 in #186
• feat(dual-spec): implement dual setup stat delta and skill synergy calculation engine by @saijo0404 in #187
• feat(hud): build in-game weapon swap HUD and active setup overlay indicator by @saijo0404 in #188
• chore(release): bump version to v3.2.0 and update changelog & roadmap by @saijo0404 in #189

Full Changelog: v3.1.0...v3.2.0

POE_tool v3.1.0

🌐 POE_tool v3.1.0 PoE 2 官方市集對接與專屬詞綴數據字典正式發布！

本版本為《流亡黯道 2 (Path of Exile 2)》雙核心架構之核心查價與數據對接版本，全面打通官方 Trade2 API、建立專屬雙向繁中/英文詞綴數據字典，並實現剪貼簿一鍵智慧查價與自適應篩選。

✨ 核心亮點功能

• PoE 2 官方市集 API Client 與多引擎請求分發器：
  • 後端與前端 API Client 依遊戲引擎動態路由至 /api/trade2/，實作獨立聯盟快取、獨立 Rate Limiter 速率通道與階梯退避。
  • 支援 PoE 2 特有之查詢 Payloads（精魂需求、符文孔位、銘刻地圖階級、未切割寶石階級過濾）。
• PoE 2 專屬基底與雙向繁中/英文詞綴數據字典庫：
  • 建立 PoE 2 專屬詞綴映射庫，收錄精魂保留、翻滾冷卻、積蓄、破甲、能量護盾充能等專屬屬性。
  • 後端以 Aho-Corasick 高效演算法實現雙向字典反查，前端提供 lookupPoe2Stat / lookupPoe2Base 毫秒級查表。
• PoE 2 剪貼簿一鍵智慧查價與自適應篩選：
  • 整合 Poe2ItemParser，將複製裝備即時轉譯為精準 Trade2 搜尋查詢。
  • 自動套用精魂需求（Spirit）、符文插槽（Rune Sockets）、銘刻地圖/尋路石階級（Waystone Tier T1-T16）與未切割寶石階級（Uncut Gem Tier T1-T20）篩選條件。
  • OverlayHeader 與查價介面自適應渲染 PoE 2 徽章與標籤，懸浮查價即時分析中位數與市場行情。

What's Changed

• feat(trade): implement PoE 2 official trade API client and multi-engine request dispatcher by @saijo0404 in #178
• feat(dictionary): build PoE 2 stat dictionary and bi-directional affix translation lookup by @saijo0404 in #180
• feat(price): integrate PoE 2 clipboard price checking and smart query generation by @saijo0404 in #181
• chore(release): bump version to v3.1.0 and update changelog & roadmap by @saijo0404 in #182

Full Changelog: v3.0.0...v3.1.0

What's Changed

• feat(trade): implement PoE 2 official trade API client and multi-engine request dispatcher by @saijo0404 in #179
• feat(dictionary): build PoE 2 stat dictionary and bi-directional affix translation lookup by @saijo0404 in #180
• feat(price): integrate PoE 2 clipboard price checking and smart query generation by @saijo0404 in #181
• chore(release): bump version to v3.1.0 and update changelog & roadmap by @saijo0404 in #182

Full Changelog: v3.0.0...v3.1.0

POE_tool v3.0.0

🚀 POE_tool v3.0.0 次世代雙核心架構正式發布！

本版本為《流亡黯道 2 (Path of Exile 2)》雙核心獨立架構之重要基石，支援遊戲視窗自動識別、雙引擎解析器工廠、資料隔離與 PoE 2 專屬屬性（精魂、符文、銘刻地圖）適配。

✨ 核心亮點功能

• 雙引擎狀態機與進程偵測抽象架構：提供 GameEngine 領域模型 ('poe1' | 'poe2')，支援手動鎖定與自動感應雙模式，並透過 Rust 跨平台實作前台視窗識別。
• 雙引擎物品解析工廠與 PoE 2 剪貼簿解析：抽象化 ItemParserFactory，支援精魂 (Spirit)、符文插槽 (Rune Sockets)、銘刻地圖 (Waystone) 與未切割寶石 (Uncut Gem)。
• 全域雙核心切換器與 PoE 2 檢視適配：於導覽列整合 EngineSwitcher，裝備檢視卡片與估價表頭自適應展示 PoE 2 專屬屬性與引擎徽章。
• 儲存命名空間隔離與型別健全性：實作 StorageNamespaceAdapter 與 namespacedStorage，物價與歷史紀錄按引擎隔離，全專案 100% 零顯式 any。

What's Changed

• ci(governance): enforce conventional commits linting and clean PR template by @saijo0404 in #165
• feat(engine): introduce game engine context state machine and window detection abstraction by @saijo0404 in #169
• feat(parser): design dual engine item parser factory and PoE 2 clipboard parser by @saijo0404 in #170
• feat(ui): implement global game engine switcher and adapt PoE 2 item inspection views by @saijo0404 in #171
• docs(roadmap): expand future PoE 2 architecture roadmap from v3.1.0 to v3.4.0 by @saijo0404 in #172
• refactor(core): bridge StorageNamespaceAdapter to default storage, clean test typing debt, and bump version to v3.0.0 by @saijo0404 in #174
• chore(release): bump version to v3.0.0 and update changelog & tauri config by @saijo0404 in #178

Full Changelog: v2.12.0...v3.0.0

POE_tool v2.12.0

🚀 Release v2.12.0 LTS: PoE 1 終極架構收斂與後端模組化 (PoE 1 Final Convergence & Rust Modularization)

本版本為 PoE 1 系列之 LTS 終極收官版本，象徵著 PoE 1 功能與工程架構的完全收斂與品質成熟，正式為即將啟動的 v3.0.0 (PoE 2 次世代雙核心獨立架構) 奠定零技術債之堅實基石。

---

📦 主要交付成果 (Delivered Items)

1. 🦀 Rust 後端核心服務與超長測試模組化拆分 (#158, PR #161)

• 拆分 services/build_calc/tests.rs (553 行) 為細粒度模組 (character_json_tests.rs, pob_parse_tests.rs, query_gen_tests.rs)。
• 拆分 services/parser/tests.rs (503 行) 為細粒度模組 (gear_tests.rs, map_gem_tests.rs, ninja_tests.rs, tier_tests.rs)。
• 解耦 services/parser/mod.rs (422 行)、services/trade/listing_parser.rs (398 行) 與 services/stash/valuation.rs (396 行) 至單一職責子模組。
• 修復 Win32 WNDCLASSEXW.cbWndExtra 欄位型別，所有後端檔案與測試全數符合 $\le 200$ 行架構標準。

2. 🎨 UI 原語元件全面普及與設計 Token 收斂 (#159, PR #162)

• 將 src/components/ui/ 原子原語（Card, Button）全面推廣至全專案剩餘 28 個 Card 與容器元件。
• 涵蓋 atlas, build, crafting, delirium, gear, jewel, mapMod, mapping, price, sanctum, scarab, settings, ultimatum, wealth, whisper, wildwood 等領域模組。
• 徹底消弭散落於各業務模組之重複 Tailwind 類別與內聯樣式，確保全站視覺一致性且單檔 $\le 300$ 行。

3. 🧹 前端遺留測試嚴格型別化與相依安全性修復 (#160, PR #163)

• 拆分 TradeListingView.test.tsx (268 行) 與 AffixFilterList.test.tsx (254 行) 為模組化子測試，單檔全數 $\le 132$ 行。
• 消除 TradeListingView.test.tsx 中殘留之 let writeTextMock: any; 與 as any 強制轉型，達成全專案 0 顯式 any。
• 修剪無用依賴並升級 nanoid 至 3.3.18，消除所有安全性弱點警告（npm audit 0 個弱點）。

---

🛡️ 品質與驗證指標 (Quality & Health Metrics)

• 前端測試：186 個測試檔案、781 項測試 100% 通過。
• 後端測試：60 項 Rust 單元測試 100% 通過。
• 靜態分析：oxlint 0 錯誤 0 警告、TypeScript 0 錯誤、cargo clippy 0 警告。
• 架構規範：全專案 100% 遵守六角架構與單檔行數限制（後端/測試/Domain $\le 200$ 行，UI $\le 300$ 行，函式 $\le 30$ 行）。
• 安全稽核：npm audit 0 弱點。

What's Changed

• refactor(rust): modularize oversized backend services and tests to meet line limits by @saijo0404 in #161
• refactor(ui): complete UI primitives adoption across remaining components (#159) by @saijo0404 in #162
• chore(debt): clean up remaining test typing and resolve npm audit warnings (#160) by @saijo0404 in #163
• chore(release): v2.12.0 LTS - PoE 1 Final Convergence & Rust Modularization by @saijo0404 in #164

Full Changelog: v2.11.0...v2.12.0

POE_tool v2.11.0

🚀 POE_tool v2.11.0 發布說明

♻️ 核心架構收斂、技術債清理與品質提升 (Core Refactoring, Tech Debt Cleanup & UI Primitives)

在邁入次世代版本前，POE_tool 完成了 Milestone 14 的全面技術債清償與架構收斂，達到全專案 100% 程式碼健康度標準：

1. 🧪 測試套件模組化拆分與 100% 行數健康度達標 (Test Suite Modularization & Limit Compliance) (#152, #155)

   • 拆分 8 個超長測試檔案為細粒度情境模組（渲染、互動、計算邏輯、API 隔離等）：
     • BuildCalculator.test.tsx ➔ BuildCalculator.calc.test.tsx, BuildCalculator.live.test.tsx, buildCalculatorMockData.ts
     • usePriceChecker.test.ts ➔ usePriceChecker.mods.test.ts, usePriceChecker.search.test.ts, priceCheckerMocks.ts
     • api.test.ts ➔ api.stash.test.ts, api.trade.test.ts, api.tauri.test.ts
     • mappingCalculator.test.ts ➔ mappingCalculator.deltas.test.ts, mappingCalculator.profit.test.ts
     • atlasHelpers.test.ts ➔ atlasHelpers.pricing.test.ts, atlasHelpers.export.test.ts
     • clipboardHistoryManager.test.ts ➔ clipboardHistoryManager.queue.test.ts, clipboardHistoryManager.compare.test.ts, clipboardHistoryMocks.ts
     • useClipboardSync.test.ts ➔ useClipboardSync.web.test.ts, useClipboardSync.tauri.test.ts
     • wealthCalculator.test.ts ➔ wealthCalculator.filter.test.ts, wealthCalculator.bulk.test.ts
   • 全專案 184 個測試檔案與全體生產檔案 100% 符合健康度標準（Domain/Hooks/Utils/Tests $\le 200$ 行，UI $\le 300$ 行，函式 $\le 30$ 行）。

2. 🧭 App.tsx 路由解耦與全域監聽器抽象化 (App Router Extraction & Global Hotkey Hook) (#153, #156)

   • 抽離 AppRouter.tsx，消除 9 層巢狀三元運算子分頁渲染，採用宣告式分頁調度並封裝加載骨架。
   • 封裝 useGlobalHotkeys.ts 處理全域按鍵監聽，並抽離 isHotkeyTriggered 純邏輯校驗。
   • 封裝 useToastNotification.ts 處理 Toast 狀態、重置防抖與自動定時消除。
   • App.tsx 行數由 193 行精簡至 115 行，所有函式 $\le 20$ 行。

3. 🎨 統一 UI 設計系統原子元件與樣式收斂 (UI Design System Primitives & Token Unification) (#154, #157)

   • 於 src/components/ui/ 封裝核心原子元件庫：Card.tsx、Badge.tsx、StatBadge.tsx、Button.tsx。
   • 替換 BestiaryCraftCard.tsx、BlightOilCard.tsx 與 ExpeditionOptimizerCard.tsx 等重複的內嵌容器與按鈕樣式。
   • 新增 uiPrimitives.test.tsx 完整測試套件。

---

完整對比變更: v2.10.0...v2.11.0

What's Changed

• refactor(tests): modularize 8 oversized test suites to meet line limits (#152) by @saijo0404 in #155
• refactor(app): decouple routing and extract global listener hooks (#153) by @saijo0404 in #156
• refactor(ui): extract design system primitives and unify component styling (#154) by @saijo0404 in #157

Full Changelog: v2.10.0...v2.11.0

What's Changed

• refactor(tests): modularize 8 oversized test suites to meet line limits by @saijo0404 in #155
• refactor: extract AppRouter, useGlobalHotkeys and useToastNotification by @saijo0404 in #156
• refactor(ui): create UI design system primitives and unify styles by @saijo0404 in #157

Full Changelog: v2.10.0...v2.11.0

POE_tool v2.10.0

🚀 POE_tool v2.10.0 發布說明

✨ 核心亮點功能

1. 🦁 魔物園獵捕效益精算與野獸工藝配方查詢器 (Bestiary Beastcrafting & Mission EV Engine) (#146, #149)

   • 純領域野獸工藝精算核心 (beastcraftingEngine.ts, bestiaryData.ts)，完整收錄 4 大勢力傳奇紅野獸庫與 7 大核心工藝配方（拓印魔法物品、分裂、加前綴移後綴、瓦爾 30% 品質等）。
   • 精算野獸工藝成本、利潤空間、ROI 評等與一鍵產生大宗紅野獸採購密語。
   • 建立白/黃/紅圖魔物園任務掉落機率模型，精算單場任務期望總產值 (EV) 與淨回報。
   • 野獸工藝卡片組件 (BestiaryCraftCard.tsx)，整合至工藝模擬中心，支援配方分類篩選與即時搜尋。

2. 💧 凋落聖油提煉配比與真菌地圖收益期望精算器 (Blight Oil Combinator & Blighted Map EV Forecaster) (#147, #150)

   • 純領域聖油精算核心 (blightOilEngine.ts, blightData.ts)，收錄 13 種聖油階級階梯與 3:1 向上升級轉換率，精算直接販售 vs 向上提煉之套利價差與建議標籤。
   • 支援主流關鍵天賦塗油配方反向查詢（輸入天賦名稱即可查出所需 3 聖油組合）。
   • 精算凋落圖 (3聖油) 與凋落蔓延圖 (9聖油) 組合之掉落數量、怪群規模、幸運寶箱與預期淨回報 (EV)。
   • 凋落精算卡片組件 (BlightOilCard.tsx)，整合至輿圖規劃中心。

3. 🧭 探險先祖秘寶出價談判最佳化與日誌收益精算器 (Expedition Haggle Optimizer & Logbook EV Forecaster) (#148, #151)

   • 純領域探險精算核心 (expeditionEngine.ts, expeditionData.ts)，建立圖貞 (Tujen) 議價出價區間最佳化模型，計算第一次安全出價 (52%)、進取出價 (45%) 與回價 (68%) 之成交率與文物節省期望值。
   • 丹尼格 (Dannig) 文物匯率換算器，精算以太陽文物向丹尼格折扣兌換黑鐮/卡古爾/秩序文物的套利淨值。
   • 探險日誌殘骸詞綴（Remnants）權重與期望回報模型，自動檢測致命不可打詞綴（免疫元素/混沌/物理）並發出警示。
   • 探險精算卡片組件 (ExpeditionOptimizerCard.tsx)，整合至刷圖收益中心。

---

完整對比變更: v2.9.0...v2.10.0

What's Changed

• feat(bestiary): add beastcrafting recipes & mission EV engine (#146) by @saijo0404 in #149
• feat(blight): add oil combinator arbitrage & blighted map EV forecaster (#147) by @saijo0404 in #150
• feat(expedition): add haggle optimizer & logbook EV forecaster (#148) by @saijo0404 in #151

Full Changelog: v2.9.0...v2.10.0

POE_tool v2.9.0

🚀 POE_tool v2.9.0 發布說明

✨ 核心亮點功能

1. 🌿 荒野野靈荒野昇華天賦與符咒效果精算器 (Wildwood Ascendancy & Charms Evaluator) (#140, #143)

   • 純領域符咒精算核心 (charmEvaluator.ts, wildwoodData.ts)，完整收錄 3 大荒野昇華派系（原始獵手、林地看守者、夜詠者）與 15 種跨職業昇華符咒詞綴效果庫。
   • 支援 1~3 個符咒插槽組合驗證，即時計算累積抗性、生命/魔力加成與特殊旗標，並產出流派契合度評級（S/A/B/C）與裝備配置建議。
   • 荒野符咒卡片組件 (WildwoodCharmsCard.tsx)，整合至流派配裝面板，支援即時詞綴搜尋與快速清除。

2. 🏛️ 禁忌聖所試煉聖物詞綴相乘評估與房型收益推估器 (Forbidden Sanctum Relic & Room EV Evaluator) (#141, #144)

   • 純領域聖所精算核心 (sanctumRelicEngine.ts, sanctumData.ts)，收錄 4 大層聖所房型難度與基礎獎勵池模型，支援 12 種聖物詞綴相乘評估（決心抗性、商人折扣、額外視野等）。
   • 精算各房型期望淨利（EV in Chaos/Divine）與通關生存率預測，提供「首選挺進 / 審慎考慮 / 極高風險」房型建議。
   • 聖物精算卡片組件 (SanctumRelicCard.tsx)，整合至刷圖收益面板，支援層數切換與自訂金幣估值。

3. 📦 聖甲蟲庫存自動盤點與套裝成套率精算器 (Scarab Inventory Stock & Set Completion Engine) (#142, #145)

   • 純領域甲蟲盤點核心 (scarabStockEngine.ts, scarabData.ts)，支援 4~5 槽位策略聖甲蟲配置與短板瓶頸精算。
   • 根據當前庫存精算成套場次，依據目標場次精算各甲蟲缺口數量與補貨總成本，並產出官方市集大宗採購鏈接與批次購買密語。
   • 甲蟲盤點卡片組件 (ScarabStockAuditCard.tsx)，整合至輿圖規劃中心，支援一鍵加載預設甲蟲組合與補貨清單複製。

---

完整對比變更: v2.8.0...v2.9.0

What's Changed

• feat(wildwood): add wildwood ascendancy and charms evaluator (#140) by @saijo0404 in #143
• feat(sanctum): add sanctum relic and room ev evaluator (#141) by @saijo0404 in #144
• feat(scarab): add scarab inventory stock and set completion engine (#142) by @saijo0404 in #145

Full Changelog: v2.8.0...v2.9.0

POE_tool v2.8.0

🌫️ 幻境瞻妄階級層數回報模擬與迷霧寶珠成本效益精算器 (Delirium Fog Layer EV & Simulacrum Splinter Forecaster)

• 純領域瞻妄精算核心 (deliriumEvEngine.ts)，完整支援瞻妄擊殺進度階梯模型、各階層獎勵期望值（EV）與 17 種迷霧寶珠加成成本效益計算 (#134, #137)。
• 精算幻境裂片掉落機率與整張門票折算淨回報，產出投資建議評級（強烈推薦 / 保守打平 / 高風險虧損）。
• 瞻妄精算卡片組件 (DeliriumForecasterCard.tsx)，整合至刷圖收益記錄器，支援一鍵套用寶珠成本至刷圖門票。

💎 永恆軍團珠寶種子碼鑑定與核心基石變更查詢器 (Timeless Jewel Seed Evaluator & Keystone Lookup)

• 純領域鑑定核心 (timelessEvaluator.ts, timelessData.ts)，完整收錄 5 大軍團勢力、所有歷史將領與其對應核心基石效果 (#135, #138)。
• 支援種子碼數值雜湊與被動點額外天賦加成推估，產出主流流派契合度評級（S/A/B/C）與市場參考身價。
• 軍團珠寶鑑定卡片 (TimelessJewelCard.tsx)，整合至流派配裝面板，支援即時搜尋與勢力過濾。

📋 遊戲內剪貼簿歷史回溯面板與多物品比價暫存列 (Clipboard History Log & Multi-Item Comparison Tray)

• 純領域剪貼簿歷史管理器 (clipboardHistoryManager.ts)，提供 FIFO 佇列自動保留最新 20 筆查價紀錄，支援重複去重與本機持久化 (#136, #139)。
• 多物品比價暫存列（最多 4 件），即時計算多物品價格中位數、物等區間與各詞綴卷值橫向對比表格。
• 剪貼簿歷史卡片 (ClipboardHistoryTray.tsx) 與地圖危險警示條 (MapDangerBanner.tsx) 整合至查價中心，支援一鍵回溯重查與快速清空。

Full Changelog: v2.7.0...v2.8.0

What's Changed

• feat(delirium): add delirium fog EV forecaster and splinter model (#134) by @saijo0404 in #137
• feat(jewel): add timeless jewel seed evaluator and keystone lookup (#135) by @saijo0404 in #138
• feat(history): add clipboard history log and comparison tray (#136) by @saijo0404 in #139

Full Changelog: v2.7.0...v2.8.0

POE_tool v2.7.0

✨ v2.7.0 更新重點 (Release Highlights)

• 🗺️ 地圖歷史掉落價值分析與地形收益熱力圖 (Map Drops Value Analytics & Tier Performance Heatmap) (#128, #131):

  • 依據歷史刷圖場次按地圖名稱與階級自動聚合分析，精算平均淨利、時薪 Divine/hr、星級評等與綜合熱力指數。
  • 視覺化展示各地形收益條與頂級掉落紀錄，智慧標示首選刷圖地形。

• ⚖️ 通牒命運試煉期望回報精算與致命詞綴風險評級引擎 (Ultimatum Trial & EV Risk Engine) (#129, #132):

  • 收錄通牒 1~10 輪獎勵池模型與 22 種負面致命詞綴危險度階級權重。
  • 結合機體弱點勾選即時檢測致命衝突，精算挺進下一輪的期望淨利 (EV)、通關機率與風險報酬比，提供「強烈挺進 / 謹慎挑戰 / 見好就收」決策建議。

• ⌨️ 自訂全域快捷鍵綁定管理與懸浮視窗自適應釘選 (Custom Global Hotkey Manager & Overlay Pinning) (#130, #133):

  • 支援單鍵、雙鍵與三鍵組合正規化、按鍵校驗與衝突檢測器。
  • 內建 5 種快捷方案（標準經典、左手人體工學、MMO 數字側鍵、Alt 映射、F 功能鍵直覺）。
  • 支援即時按鍵錄製（Press-to-record）、衝突警示、懸浮視窗一鍵置頂釘選與透光度滑動調節。

What's Changed

• feat(mapping): add map drops value analytics and heatmap (#128) by @saijo0404 in #131
• feat(ultimatum): add ultimatum trial EV calculation and risk engine (#129) by @saijo0404 in #132
• feat(hotkey): add custom hotkey manager and overlay pinning (#130) by @saijo0404 in #133

Full Changelog: v2.6.0...v2.7.0