前言¶
在 DeepSeek Harness（DSH）裏使用智能體時，agent 當前處於哪個階段、正在調用哪個工具、跑了多久，以及 DeepSeek API 餘額還剩多少，通常會分散在日誌、終端輸出或不同面板裏。dsh-desktop-pet 把這些信息放到同一個桌面寵物 widget 中：官方鯨魚在 web UI 的 shell overlay 裏活動，圓形海平面的高度對應 API 餘額，狀態條則顯示當前 agent 的階段、工具和耗時。
這是什麼¶
dsh-desktop-pet 是一個 DeepSeek Harness 插件，由 FenyxHuang 維護，採用 MIT 許可證。它用於在 DSH web profile 中提供一個常駐桌面寵物，集中展示 agent 運行狀態和 DeepSeek API 餘額。
這個插件的打包產物是預構建的，聲明零運行時依賴；安裝時依賴 Harness 本身提供的 @deepseek-ai/* 服務，因此不需要額外 build step，也不需要 build authorization。
核心功能¶
即時 agent 狀態¶
鯨魚會按照 agent 狀態切換顯示，包括 resting、thinking、working 和 cries。
狀態條會展示當前階段、當前工具以及耗時。
餘額作爲海平面¶
圓形海面按 balance / balanceScale 填充，計算結果會被限制在最大 1。默認 balanceScale 爲 100，也就是 ¥100 爲滿格。
水面會顯示滾動波浪和慢潮效果，金額顯示在水面上。餘額較低時，鯨魚會下垂並顯示抱怨狀態。
可交互桌面寵物¶
點擊鯨魚可以觸發交互：多數情況下彈跳，約 40% 概率觸發一次帶 360° 旋轉的蓄力潛水，並伴隨濺水效果。
插件還包含隨機中英文臺詞、愛心、思考氣泡、可拖拽和最小化爲點等表現。
零運行時依賴¶
打包產物預構建後分發。@deepseek-ai/* 相關服務由已有 Harness 安裝提供，安裝過程不需要構建步驟，也不需要構建授權。
安裝與啓用¶
前置條件：已經安裝 DeepSeek Harness，推薦使用 web profile。
從 GitHub 直接安裝：
dsh plugin --profile web add github:FenyxHuang/dsh-desktop-pet
從本地 checkout 安裝時，將路徑替換爲實際目錄：
dsh plugin --profile web add link:/path/to/dsh-desktop-pet
也可以先打包成 tarball，再安裝：
pnpm pack
dsh plugin --profile web add ./dsh-desktop-pet-0.1.0.tgz
安裝完成後，需要重啓 dsh，因爲 bundle layers 在啓動時組合。重啓後，鯨魚會出現在 web UI 的右下角。
典型用法¶
查看 agent 狀態和餘額¶
安裝並重啓後，web UI 右下角會出現鯨魚 widget。
agent 運行期間，可以觀察鯨魚狀態、狀態條中的階段、當前工具和耗時。圓形海面則根據 DeepSeek API 餘額顯示水位。
宿主端配置行會通過 Harness 的正常憑據讀取 DEEPSEEK_API_KEY，並最多每 15 秒重新獲取一次餘額接口：
https://api.deepseek.com/user/balance
覆蓋配置¶
默認情況下，pet-status 的配置爲 balanceScale: 100。如果你希望更高餘額才顯示爲滿格，可以在自己的 profile 的 cordis.patch.yml 中覆蓋配置：
- update:
- id: pet-status
config:
balanceScale: 500
balanceRefetchMs: 60000
上面的示例將滿格閾值調整爲 500，並將餘額重新獲取間隔調整爲 60000 毫秒。
適用場景與注意¶
適合已經使用 DeepSeek Harness web profile，並且希望在一個常駐 widget 裏同時看到 agent 狀態和 API 餘額的使用者。
使用前需要注意：
- 該插件依賴已有的 DeepSeek Harness 安裝環境。
- 安裝後需要重啓
dsh，widget 纔會在 web UI 右下角出現。 - 插件會讀取
DEEPSEEK_API_KEY，並訪問 DeepSeek balance API，頻率最多每 15 秒一次。 - 該插件以當前
dsh進程權限運行，安裝前應檢查源碼、依賴範圍和許可證。 - 許可證爲 MIT；插件源自 DeepSeek Harness codebase（MIT，© 2026 DeepSeek）。鯨魚標誌是 DeepSeek 官方品牌圖案，用於 widget 自身顯示。
- 倉庫開發測試記錄爲 34 pass；其中 7 個 jsdom widget tests 需要 Node
^22.19 || >=24。
相關鏈接¶
- GitHub：https://github.com/FenyxHuang/dsh-desktop-pet
- 社區目錄頁：https://www.skillhub.cn/plugins/FenyxHuang/dsh-desktop-pet
