ashop

📌 變更摘要 (Summary)

本 PR 涵蓋了從 Commit 747afb1 到最新 Head（共 6 個 Commit）的核心功能新增與重要 Bug 修復。重點包括：

1. Discord 商店含冒號商品購買修復（附魔書/藥水短 Key Hash 防護）
2. Discord 每日 / 每週 / 每月商店營運報表與自動推播（支援 Bot 互動選單與 Webhook）
3. 物品交易趨勢與熱度智慧分析（熱度分數、動態漲跌幅與自動分析評語）
4. PlugManX / JDA 熱重載同步安全關閉（修復 zip file closed 異常）
5. 基岩版 (Bedrock) PDC 標籤注入與 GUI 離線帶走防呆攔截

---

🔥 主要變更亮點 (Key Highlights)

1. 🐛 修復 Discord 含冒號商品標籤點擊失敗 Bug (v1.7.0 Fix)

   • 針對 catalogKey 包含冒號（例如附魔書 enchanted_book:ench:minecraft:luck_of_the_sea:3 或藥水）的商品，實作短 Key Hash 對照表與倒數索引冒號安全解析演算法。
   • 完全解決 Discord 按鈕點擊時解析錯位導致「該商品目前未開放購買」的問題，並向下相容舊版按鈕。

2. 📊 Discord 每日 / 每週 / 每月商店營運報表系統 (v1.8.0)

   • 建立非同步 ReportService 與 transactions.yml 交易紀錄機制。
   • 新增 DiscordReportScheduler 排程器，支援手動指令（遊戲內 /shop report 與 Discord /report）以及定期自動推播至 Discord 頻道/Webhook。
   • Bot 發送管道具備永久互動按鈕 (📅 每日 / 📆 每週 / 📊 每月 / 🔄 重新整理) 與下拉選單（包含熱門商品 Top 10、熱門玩家榜、明細等）。
   • 新增 discord-report.timezone 設定，支援自訂或自動解析主機系統時區。

3. 📈 物品交易趨勢與熱度智慧分析 (Analytics)

   • 自動計算物品熱度指數 (0~100)、買賣比例與動態物價漲跌倍率。
   • 自動生成分類標籤（🔥 搶手爆款物資 / 📈 需求持續上升 / ⚖️ 供需穩定平衡 / 📥 玩家大量拋售）與人性化智慧分析短評。

4. ⚡ PlugManX / JDA 熱重載穩定度優化 (Stability)

   • 改用 standaloneJda.shutdownNow() 搭配 3 秒 awaitShutdown，確保 PlugManX 在關閉 ClassLoader 前完整釋放 JDA 背景執行緒，消除 IllegalStateException: zip file closed 錯誤。

5. 🛡️ 基岩版 (Bedrock / Geyser / Floodgate) 防呆與 PDC 標籤機制 (v1.7.1)

   • 為所有商店 GUI 物品注入 ashop:gui_item PersistentDataContainer (PDC) 標籤。
   • 當介面關閉、玩家離線或重新登入時，自動抹除游標與背包內殘留的 GUI 展示方塊。
   • 監聽放置方塊與丟棄物品事件進行防呆攔截；並於 config.yml 新增 bedrock.block-gui 控制開關。

---

• 747afb1 [Discord商店] 修復點擊含冒號商品標籤 (如附魔書/藥水) 導致購買失敗問題
• 8cd1ec7 [營運報表] 新增 Discord 每日/每週/每月商店營運報表與自動推播功能
• 4043e2e [營運報表] 調整語意為玩家交易與系統商店服務數據統計
• 14a5e01 [營運報表] 新增物品交易趨勢、熱度分數與自動智慧分析短評
• e4c667e [Discord] 修復 PlugManX 熱重載時 JDA 非同步關閉導致的 zip file closed 異常
• 8851c96 [基岩版相容] 新增 PDC 標籤與基岩版 GUI 離線帶走防呆機制

---

⚙️ 設定檔與多語系異動 (Config & Locale Changes)

• config.yml
  • 新增 discord-report 完整設定區塊（包含 channel-id, webhook-url, timezone, auto-push）。
  • 新增 bedrock.block-gui 設定項（預設 false）。
• zh_tw.properties / en_us.properties / _template.properties
  • 新增 msg.cmd.bedrock-blocked 基岩版阻擋提示訊息。
• CHANGELOG.md & README.AI.md
  • 已同步更新 v1.7.1 與 v1.8.0 異動日誌與歷史軌跡。