前言¶

DeepSeek Harness（DSH）採用插件化架構，餘額小鯨魚掛件是其中用於展示餘額、今日已用額度及峯谷定價的組件。本倉庫是基於官方 dsh-whale-widget 0.3.9 的非官方衍生版，在保留原有餘額、定價、音效等核心功能的基礎上，新增了交互與可視化增強。

插件簡介¶

• 名稱: 621758/dsh-whale-widget-pet-feed
• 定位: DeepSeek Harness 餘額小鯨魚掛件非官方衍生版（基於 dsh-whale-widget 0.3.9）
• 功能: 新增摸頭、摸頭音效、互動統計和投餵按鈕，其餘功能原樣保留。
• 許可: MIT
• 安裝: npm i "https://github.com/621758/dsh-whale-widget-pet-feed"

核心功能¶

本插件主要包含以下四個功能點：

1. 摸頭切圖 + 摸頭音效
   通過特定的鼠標划動觸發，角色圖會切換爲摸頭圖，並伴隨音效。停手約 0.7 秒後切回。
2. 互動統計
   在菜單中提供二級面板，可查看今日/本月/總點擊數及摸頭數，支持一鍵清空。
3. 投餵按鈕
   點擊角色後展開三個 Emoji 按鈕（🍚 / 🥤 / 🪙），按下后角色圖切換爲對應食物圖，停留 2.2 秒後切回。
4. 內置兜底圖
   插件包內預置了摸頭圖與投餵圖的兜底資源，防止因本地文件缺失導致裂圖。

安裝與啓用¶

安裝前請確保 dsh.profile.bundles 中已包含 dsh-whale-widget（即已安裝過官方版）。

執行以下命令進行安裝：

npm i "https://github.com/621758/dsh-whale-widget-pet-feed"

安裝完成後，需執行以下操作使改動生效：

• 前端改動（掛件界面、摸頭、投餵、統計）：瀏覽器硬刷新（Ctrl + Shift + R）。
• 宿主代碼改動（新增圖片路由）：重啓 DSH（執行 dsh web）。

使用方法¶

1. 摸頭切圖¶

在角色身上左右來回劃，需滿足以下條件才觸發：
- 累計 3 次有效方向反轉。
- 1.4 秒內完成。
- 每一筆移動距離 ≥ 12px。

觸發後，停手約 0.7 秒，角色圖會切回當前狀態。在菜單中可關閉此功能或更換摸頭圖。

2. 投餵按鈕¶

點擊角色，左側會展開三個 Emoji 按鈕（🍚、🥤、🪙）。
- 按下按鈕：播放音效，角色圖切換爲對應食物圖，2.2 秒後切回。
- 無操作約 4.2 秒自動收起按鈕。

3. 互動統計¶

點擊角色右上角的菜單（☰），進入 互動統計 [查看]：
- 查看今日/本月/總點擊數及摸頭數。
- 點擊“清空統計”可將數據歸零。

注意事項¶

• 預載機制：首次打開頁面時會後臺預載摸頭圖與三張投餵圖（約 6.6MB）。預載未完成時不會強制切圖，避免出現空白。
• 重啓與刷新：宿主代碼改動（如新增路由）需要重啓 DSH；前端改動需要硬刷新瀏覽器。
• 音效複用：本衍生版未新增音頻素材，所有音效均複用上游的音效組機制。

適用場景¶

本插件適合希望在 DSH Web 界面右下角的小鯨魚掛件上增加更多趣味交互（如摸頭、投餵）的用戶。由於是 MIT 許可，開發者可以自由使用和修改，但需注意保留版權聲明。