前言¶
DeepSeek Harness 桌面端側邊欄插件，用於一鍵查看主流二遊的當期卡池與活動起止。在管理二游資源時，快速確認當前版本、卡池與活動的起止時間是一項高頻需求。該插件通過側邊欄懸浮面板提供這一能力，支持聯網自動刷新與多源自動回退。
核心功能¶
插件主要包含以下能力：
- 側邊欄懸浮面板：側邊欄底部「📅 二遊日歷」按鈕，點擊展開懸浮面板。面板按行展示每款遊戲的當期卡池、卡池起止、當期活動、活動起止。
- 倒計時與詳情：顯示剩餘時間；懸停可查看卡池/活動的完整名稱與源站原文。
- 自動刷新機制：
- 啓動強制刷新：插件更新或首次安裝時強制刷新一次，懸停可查看上次完全成功的時間。
- 按間隔刷新：其餘刷新按設置間隔（1–42 天）進行，從上次成功刷新起算。
- 刷新提示與失敗歸類：頂行顯示刷新狀態，按「成功 / 卡池失敗 / 活動失敗 / 新卡池未公佈 / 新活動未公佈」歸類。懸停可查看逐條原因。”來源報錯”計入失敗，”源站還沒收錄當期”不算失敗。
- 多來源獨立與自動回退：各遊戲來源獨立（官方公告 / 官方 Wiki / 第三方站），失敗時自動回退備選源。設置頁可切換來源或填自定義地址。
- 自定義與自檢：設置頁支持自定義條目（名稱+圖標+來源鏈接）、展示順序、條目顯隱/刪除。提供解析器自檢功能，可逐個來源跑一遍，報告解析問題，用於定位源站改版。
安裝與啓用¶
通過官方命令安裝：
dsh plugin --profile desktop add dsh-gacha-calendar
或手動安裝：將倉庫複製到 profile 的 node_modules 目錄下，重啓 DSH Desktop。
安裝前需確認 DSH 版本滿足 peer 依賴範圍：
>=0.1.1-rc.2 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0（cordis ^4.0.1、schemastery >=3.18.0 <4）。
典型用法¶
- 查看排期：點擊側邊欄底部的「📅 二遊日歷」按鈕，展開懸浮面板查看各遊戲狀態。
- 切換來源：進入設置頁，針對特定遊戲切換數據來源或填入自定義地址。
- 解析器自檢：在設置頁點擊解析器自檢，查看各源站抓取與解析的執行情況。
適用場景與注意事項¶
- 適用場景：主要面向需要頻繁查看二遊卡池與活動排期的用戶。
- 權限與安全：插件以當前 DSH 進程權限運行。鑑於其爲開源項目，安裝前建議檢查源碼與許可證（MIT）。
- 免責聲明：本項目爲非營利性質的個人項目，與各遊戲廠商、發行商及官方/社區 Wiki 均不存在隸屬或合作關係。卡池、活動等排期數據均取自各遊戲公開的官方公告與社區 Wiki、第三方站，僅作信息聚合展示，不提供亦不存儲任何遊戲資源。
短結尾¶
該插件通過聚合多源數據並提供自動刷新與回退機制，解決了二遊排期查詢的痛點。更多細節可參考項目主頁或 GitHub 倉庫。
