前言¶
在 DSH Web 界面中，查看用量通常需要切換面板，不夠直觀。dsh-opencode-go-usage 插件提供了一個常駐的桌寵小窗，用於實時監控用量。下面介紹該插件的功能與使用方式。
這是什麼¶
dsh-opencode-go-usage 是 DSH Web GUI 的桌寵用量小窗，角色名爲藍色大肥魚。它由 wawo77 維護，屬於趣味換裝類別。該插件解決了在 Web 界面角落常駐查看用量的問題，無需切換面板即可瞭解今天的消耗情況。
核心功能¶
該插件具備以下能力：
- 自動適配 Provider：自動識別並適配 DSH 配置的 provider，支持 OpenCode Go、Command Code、DeepSeek 官方等。
- 骨骼動畫：角色具有骨骼動畫效果，包括呼吸起伏、每 6 秒蹦一下、耳朵抖動、尾巴擺動。
- 現場合成音效：點擊交互（如“吱”聲）和縮放音效（“啵”聲）均爲現場合成，零音頻文件，零版權問題。
- 智能轉向：角色會根據在屏幕上的位置自動轉向，貼屏幕左半邊朝右看，貼右半邊朝左看。
- 交互控制：支持鼠標懸停、點擊展開詳情、拖動位置、滾輪縮放（範圍 90–260px）。
- 數據安全：純本地處理，賬號數據不出本機，所有 HTTP 路由都有 loopback 圍欄。
安裝與啓用¶
執行以下命令安裝插件：
dsh plugin --profile web add "github:wawo77/dsh-opencode-go-usage"
安裝後，需要重啓 dsh web 以確認安裝並驗證 sprite 加載。安裝路徑含空格會導致 link 協議安裝失敗。
典型用法¶
- 查看用量：在 DSH 網頁界面角落常駐查看用量，氣泡第一行顯示套餐配額百分比或賬戶餘額，第二行顯示今日 token。
- 交互查看：點擊角色展開詳情卡片，查看更多統計數據。
- 調整大小：在角色上滾動滾輪進行縮放（90–260px），每變一檔會響一聲“啵”。
- 懸停互動：鼠標懸停在角色上，角色會輕輕抬起。
適用場景與注意¶
該插件適合需要在 DSH Web 界面中直觀查看用量並關注數據隱私的用戶。
使用時需注意以下事項：
* 版本要求：需要 DSH >= 0.1.5-rc.1。
* 配置依賴：需在 DSH 中配置對應套餐的 API Key（如 OPENCODE_GO_API_KEY、DEEPSEEK_API_KEY）。
* 重啓生效：安裝後必須重啓 dsh web 才能生效。
* 路徑限制：安裝路徑含空格會導致 link 協議安裝失敗。
總結¶
dsh-opencode-go-usage 提供了一個低開銷、可視化的用量監控方案，結合了骨骼動畫與本地安全處理機制，適合追求實用性與隱私性的 DSH 用戶。
