前言¶
日常使用 DeepSeek Harness（DSH）的 Web 界面時，經常需要查看 DeepSeek 賬號餘額，但不一定想反覆切出當前窗口、打開別的頁面查詢。Ho11ow8/deepseek-harness-balance-pet 是一個 DSH 插件：打開 DSH Web 界面時，在屏幕右下角顯示一個 Deepseek 娘，並用對話框即時顯示 DeepSeek 賬號餘額，默認每 20 秒刷新一次。
下面介紹這個插件做什麼、怎麼安裝、怎麼配置，以及排障時看哪些日誌。
這是什麼¶
- 倉庫/插件 ID：
Ho11ow8/deepseek-harness-balance-pet package.json包名：deepseek-balance-pet- 維護者：
Ho11ow8 - 許可證：
MIT
它的作用是把 DeepSeek 賬號餘額掛到 DSH Web 瀏覽器窗口旁。桌寵默認出現在屏幕右下角，對話框內顯示類似 餘額：¥xx.xx 的單行文字，並自動縮放字號防止溢出。
該插件面向 Windows 10/11。桌寵是編譯好的原生 WPF 程序，需要 .NET Framework 4.8，資料中標明系統自帶。插件端需要 Node.js ≥ 18，並已安裝 DeepSeek Harness 的 web profile。
核心功能¶
只跟隨 DSH Web 瀏覽器窗口¶
啓動 dsh web 時，桌寵會自動出現，並且只掛在 DeepSeek Harness 界面對應的瀏覽器窗口上。
當發生以下情況時，桌寵會隱藏：
- 切換到別的應用
- 最小化瀏覽器窗口
- 關閉瀏覽器窗口
恢復 DSH Web 瀏覽器窗口後，桌寵會重新顯示。
它還會跟隨瀏覽器所在顯示器，並出現在該顯示器的右下角，邊距爲 14px。
即時顯示 DeepSeek 賬號餘額¶
桌寵對話框內顯示：
餘額：¥xx.xx
餘額即時刷新，調用接口爲：
GET /user/balance
默認刷新間隔爲 20 秒，可通過 pollSeconds 配置項覆蓋。
窗口大小與基本操作¶
桌寵默認大小爲 220×209px，大小可配置。
日常操作包括：
- 按住左鍵拖動桌寵；同一顯示器內的拖動位置會保留
- 右鍵菜單中選擇刷新余額或退出
- 雙擊桌寵也能刷新余額
關閉 DSH 時，桌寵會自動退出。如果服務失聯約 2 分鐘，桌寵也會自動消失。
本地運行與密鑰邊界¶
插件端僅使用 Node 內置模塊。桌寵端是編譯好的原生 WPF 小程序。
餘額代理只監聽：
127.0.0.1
資料中明確說明：API Key 不會進入瀏覽器。
安裝與啓用¶
環境要求¶
安裝前確認以下環境：
- Windows 10/11
.NET Framework 4.8- Node.js ≥ 18
- 已安裝 DeepSeek Harness，並啓用 web profile
從 GitHub 安裝¶
執行：
dsh plugin --profile web add github:Ho11ow8/deepseek-harness-balance-pet
該命令會把插件加入 web profile。
然後重啓 dsh web。可以關掉再重新打開，也可以雙擊桌面的 DeepSeek Harness 快捷方式。重啓後，桌寵會自動出現。
從本地目錄安裝¶
開發或調試時，可以從本地目錄安裝：
dsh plugin --profile web add file:D:\DeepseekHarness\DeepseekBalance\deepseek-balance-pet
如果之前用 file: 安裝過，現在想改用 github:，先移除舊依賴，再重新添加，避免同一包名出現兩個來源。
典型用法¶
覆蓋配置項¶
在 profile 的 cordis.patch.yml 中覆蓋配置項。示例如下：
- id: balance-pet
config:
port: 41999
pollSeconds: 20
petWidth: 220
shadow: true
這些示例值來自已提供的用法說明：
pollSeconds: 20：對應默認每 20 秒刷新一次petWidth: 220：對應默認寬度 220port: 41999：本地餘額代理使用shadow: true：覆蓋桌寵顯示相關配置
API Key 讀取位置¶
插件讀取 DeepSeek API Key 的順序是：
- 環境變量
DEEPSEEK_API_KEY ~/.dsh/.credentials.yaml中的DEEPSEEK_API_KEY行
如果餘額獲取失敗，優先檢查這裏的 Key 是否有效、賬號是否欠費。
重新生成形象¶
如果有原始圖片，可以重新生成桌寵形象：
node tools/make-pet-image.mjs <原圖.jpg> pet.png
這一步用於把原始圖片處理成插件使用的 pet.png。
重新編譯桌寵¶
需要重新編譯 WPF 桌寵時，執行：
pwsh -File src\build.ps1
這一步會重新生成桌寵可執行文件。
排障¶
桌寵沒出現¶
先確認兩點：
deepseek-balance-pet已加入 web profile 的 bundles- 安裝後已經重啓
dsh web
顯示“獲取失敗”¶
檢查 ~/.dsh/.credentials.yaml 中的：
DEEPSEEK_API_KEY
確認 Key 是否有效、賬號是否欠費。餘額接口返回 is_available: false 時也會報錯。
查看日誌¶
桌寵端日誌位於：
%LOCALAPPDATA%\DeepseekBalancePet\pet.log
插件端日誌在 dsh web 控制檯中查看，帶有 [balance-pet] 前綴。
適用場景與注意¶
這個插件適合在 Windows 下長期使用 DSH Web 界面的開發者。如果你的工作流經常需要確認 DeepSeek 賬號餘額，把餘額掛在瀏覽器窗口旁可以減少來回切換。
使用前建議注意：
- 插件會隨當前
dsh進程權限運行 - 安裝前應檢查源碼、依賴和許可證
- 餘額代理只監聽
127.0.0.1，但仍應避免把 API Key 暴露給不可信環境 - 如果從
file:切到github:，先移除舊依賴再添加
結尾¶
這個插件做的事情比較具體：打開 DSH Web 界面時，在屏幕右下角顯示一個 Deepseek 娘，並在對話框裏持續顯示 DeepSeek 賬號餘額。它使用本地餘額代理，API Key 不會進入瀏覽器，安裝和配置路徑也比較直接。
倉庫地址：
https://github.com/Ho11ow8/deepseek-harness-balance-pet
目錄頁線索未確認，本文不把未覈實地址列爲事實。
