前言¶

DSH（DeepSeek Harness）的插件生態支持通過插件擴展宿主功能。除了實用的記賬、狀態監控類插件外，社區中也存在一些爲增強交互體驗而設計的附加組件。

dsh-whale-food-expack 是爲 DSH 小鯨魚記賬掛件（dsh-whale-widget）設計的互動附加包。它不修改本體插件，而是通過疊加層的方式，給小鯨魚增加了“喂白米飯”、“幹活敲鍵盤”以及“工具實時顯示”等行爲邏輯。本插件由 Mynaniao 維護，採用 MIT 許可證。

核心功能¶

該插件主要實現以下能力：

1. 喂白米飯

   • 支持拖拽交互：將白米飯拖到鯨魚身上即可餵食。
   • 自動續飯：滿碗喂掉後會留一個空碗，左鍵點擊空碗可自動盛滿，開始下一輪進食。
   • 飽食度反饋：餵食會增加飽食度，數值顯示在右上角的小氣泡中。

2. 飽食度系統

   • 自然消耗：空閒狀態下，飽食度每分鐘下降 1%。
   • 工作消耗：Agent 幹活時，飽食度會根據 Token 消耗量下降（設定爲 3000 tokens = -1%）。
   • 飢餓反饋：當飽食度 ≤ 50% 時，每 30 秒小鯨魚會喊一次餓，越餓喊得越慘。

3. 敲鍵盤與工具顯示

   • 視覺反饋：Agent 幹活時，鯨魚會露出手並敲擊鍵盤。
   • 工具報錯：每次調用工具會在界面上彈出吐司提示（如 🛠 read），若工具調用失敗，鯨魚會變紅並抖動。
   • 實時狀態：界面上會實時顯示當前正在使用的工具。

安裝與啓用¶

在安裝本插件前，請確保宿主環境已安裝並啓用本體插件「DSH 小鯨魚記賬掛件」（包名 dsh-whale-widget），且版本 ≥ 0.3.0。

本插件是附加層，沒有本體不會顯示任何內容。

dsh plugin --profile web add dsh-whale-food-expack

命令執行完成後，需要重啓 dsh web 進程，插件才能生效。

使用指南¶

安裝並重啓後，使用方法如下：

1. 餵食操作

   • 將白米飯🍚拖拽到鯨魚身上進行餵食。
   • 滿碗喂掉後會留下一個空碗🥣，此時無法拖動空碗。
   • 左鍵單擊空碗，系統會自動盛滿米飯，開始新一輪餵食。

2. 狀態查看

   • 飽食度數值實時顯示在右上角的小氣泡裏。
   • 深藍色代表正常狀態，橙色代表餓了，紅色代表快餓死了。

3. 位置校準

   • 如果疊加層位置錯位（例如嘴跑到額頭、手飄在半空），按 Ctrl+Alt+M 進入調整模式。
   • 此時會出現紅色虛線框，拖動嘴、鍵盤、左手、右手即可調整位置。
   • 再次按 Ctrl+Alt+M 或 Esc 退出模式，位置會自動保存。

數據與隱私¶

本插件的數據存儲和運行邏輯完全在本地瀏覽器中：

• 存儲位置：所有數據存儲在瀏覽器的 localStorage 中，包括飽食度數值、餵食次數、位置校準數據等。
• 隱私安全：插件不會向任何服務器發送數據，也不讀取對話內容，僅訂閱 Agent 的狀態事件（如開工、收工、工具名、成敗）。

注意事項¶

• 依賴本體：必須先安裝並啓用 dsh-whale-widget ≥ 0.3.0，否則本插件無任何顯示。
• 重啓生效：安裝或卸載後，必須重啓 dsh web 才能加載或移除插件。
• 層級衝突：本插件可能會與某些皮膚插件或全屏插件發生層級衝突（z-index 問題）。如果遇到設置點不開或顯示不全，可以使用 Ctrl+Alt+M 調整模式重新校準，或檢查皮膚插件的兼容性配置。

參考資料¶

• 項目主頁：https://github.com/Mynaniao/dsh-whale-food-expack
• 插件目錄：https://www.skillhub.cn/plugins/Mynaniao/dsh-whale-food-expack