DeepSeek Harness (DSH) 的設計理念是「一切皆插件」，這使得開發者可以通過擴展來增強客戶端功能。對於開發者來說，實時掌握 DeepSeek 賬戶的 API 餘額是一項基礎需求。outprinthelloli/dsh-piggy-bank 旨在解決這一問題，它是一個 DSH Web 插件，通過在頁面中掛載一個可拖動的懸浮組件，實時從官方接口獲取並展示餘額。
插件名爲 outprinthelloli/dsh-piggy-bank，由 outprintHelloLi 維護，許可證爲 MIT。
核心功能¶
-
懸浮存錢罐
- 組件可拖動位置，顯示在頁面任意位置。
- 提供 4 種內置透明 PNG 樣式：卡通豬、藍色鯨魚、黑金龍紋、陶瓷。
- 支持導入外部.svg文件作爲自定義樣式。 -
餘額展示
- 餘額數值直接顯示在存錢罐上方。
- 文字帶有深色背景，保證可讀性。 -
自動刷新
- 頁面打開時立即查詢。
- 任務開始或結束時立即刷新。
- 對話運行期間按設定間隔自動查詢（默認 30 秒），僅在頁面可見時進行輪詢。 -
餘額動畫
- 查詢時存錢罐會有搖晃動作。
- 餘額下降時，存錢罐抖動並顯示-¥xx.xx（淡入淡出 5 秒）。
- 餘額增加時，以金色顯示+¥xx.xx。 -
設置界面
- 在 DSH 的設置側邊欄中，可調整「查詢時間間隔」（範圍 5–600 秒）。
- 可切換存錢罐樣式。
- 可添加自定義 SVG。
安裝與啓用¶
本插件爲純 Node.js 實現，提供一鍵安裝腳本。
使用腳本安裝（推薦）：
node scripts/install.mjs
該腳本會自動完成以下步驟：
1. 查找 DSH profile（默認爲 web）。
2. 複製插件文件。
3. 在 profile 的 package.json 中登記依賴和 bundle。
4. 執行 pnpm install。
可選參數：
# 安裝到其它 profile（例如 headless）
node scripts/install.mjs --profile headless
# 只複製/登記，不執行 pnpm install
node scripts/install.mjs --no-install
使用 DSH 命令安裝：
dsh plugin --profile web add dsh-piggy-bank
安裝完成後，需重啓 dsh web 進程，並在瀏覽器中硬刷新頁面（Windows: Ctrl+Shift+R；macOS: Cmd+Shift+R）以加載新組件。
典型用法¶
安裝並啓用插件後，在 DSH 客戶端頁面右上角會出現存錢罐圖標。拖動圖標可改變其位置。點擊圖標或查看其上方數值，即可看到當前 DeepSeek 賬戶餘額。
在 DSH 設置側邊欄中，可以配置自動查詢的頻率。如果希望更實時地監控，可以將間隔調整爲較小的值（如 5 秒）；如果希望減少對 API 的請求，可調整爲較大的值（如 600 秒）。同時，可在設置中更換存錢罐的樣式。
注意事項¶
-
前置條件
- 需要在~/.dsh/.credentials.yaml中配置DEEPSEEK_API_KEY。
- 需要安裝 Node.js ≥ 20 以及 pnpm。
- 需要確保 DSH 已初始化 web profile（默認爲~/.dsh/profiles/web）。 -
數據來源與侷限
- 數據來源爲 DeepSeek 官方接口GET https://api.deepseek.com/user/balance。
- DeepSeek 開放平臺未提供 token 用量、費用或賬單接口，因此本插件僅展示餘額，不做本地用量記賬或費用估算。 -
安全性
- 插件以 DSH 進程的權限運行，安裝前建議檢查源碼與許可證（MIT）。
短結尾¶
outprinthelloli/dsh-piggy-bank 提供了在 DSH 界面內直接監控餘額的能力，通過可視化的動畫反饋餘額變化，降低了開發者手動查詢 API 的頻率。相關目錄與源碼可參考下方鏈接。
