DSH Web 界面提供了 API 餘額監控的基礎能力，原版掛件功能完整但形象固定。fiven577 在原版基礎上進行了修改，將桌寵形象替換爲角色「三口」，並增加了語音互動、狀態機邏輯（生氣/喫撐）以及透明動畫，適合需要個性化桌寵監控餘額的開發者。
功能概覽¶
該插件在保留原版核心能力的基礎上，增加了以下特性：
- 常駐自啓：隨 DSH Web 界面打開自動出現在右下角。
- 餘額監控：支持 60s 自動刷新與手動點擊刷新，餘額變化帶有數字滾動動畫；支持「小鯨魚記賬」與「實時·令牌」兩種今日已用模式。
- 交互與操作：支持拖拽與四邊吸附、按壓 Q 彈效果、漢堡菜單（調整大小/音量/氣泡開關）。
- 峯谷文案：支持「默認 / 梁文峯谷 / !?強強?!」三套文案皮膚，並附帶峯谷計價功能。
- 隨機臺詞與動圖：桌寵會彈出隨機臺詞氣泡，並顯示 rua.gif 動圖。
- 三口皮膚版新增：
- 自定義形象：桌寵本體由鯨魚替換爲角色「三口」的透明立繪（可自行替換
assets/DSniang1.png）。 - 語音互動：點擊播放音效，對話消耗提示時同步播放音效。
- 生氣狀態：2 秒內連點 ≥6 次，形象切換爲生氣狀態，播放語音。
- 餘額提醒（喫撐）：支持固定檔位或自定義金額（0.1~1000），累計消耗達標後形象切換爲喫撐狀態，彈出氣泡提示。
- 喫透明動畫：每輪消耗提示時播放帶 Alpha 的喫動畫，加載失敗會降級爲純音效。
- 狀態協調：生氣與喫撐狀態互斥，喫動畫可被打斷，修復了菜單狀態失步與像素遮擋問題。
- 自定義形象：桌寵本體由鯨魚替換爲角色「三口」的透明立繪（可自行替換
安裝與啓用¶
安裝前需確保已配置 DEEPSEEK_API_KEY（拉取餘額必需），並已安裝 DSH Desktop / dsh CLI / pnpm。
- 執行以下命令安裝插件：
dsh plugin --profile web add github:fiven577/dsh-whale-widget-sankou
-
安裝完成後，完全退出並重新啓動 DSH Desktop，刷新頁面即可在右下角看到桌寵。
-
驗證安裝是否成功：
curl http://127.0.0.1:3080/dsh-whale/balance.json
curl http://127.0.0.1:3080/dsh-whale/image.png
使用方法¶
- 查看餘額與今日已用：點擊桌寵即可查看。
- 切換峯谷臺詞：點擊桌寵彈出的氣泡，約 45% 概率會出現「當前時間段爲」等隨機臺詞。
- 觸發生氣狀態：在 2 秒內快速點擊桌寵 6 次以上，形象會切換爲生氣狀態並播放語音。
- 設置喫撐提醒：點擊桌寵喚出漢堡菜單，進入「餘額提醒」選項，選擇檔位或手動輸入 0.1~1000 的金額。
- 更換音效：在漢堡菜單的「音效」選項中，選擇「語音·點擊(嗯？)」、「小黃鴨」或「音效1」。
注意事項¶
- 插件代碼遵循 MIT 許可證，但自定義素材（形象圖、語音、動畫）爲作者原創，二次分發素材需保留說明並註明出處。
- 動畫加載失敗會靜默降級爲僅播放音效。
- 如需恢復原版鯨魚形象，將原版
assets/DSniang1.png放回即可。 - 插件以當前 DSH 進程權限運行，請確保源碼與許可證符合使用規範。
