前言¶
DeepSeek Harness (DSH) 桌面版開發者在使用 API 開發過程中，常需要頻繁查看賬戶餘額和今日 Token 消耗量。打開網頁或主界面進行查詢會增加操作成本。dsh-api-balance 插件通過一個獨立的原生 Windows 窗口，將 API 狀態實時懸浮在桌面角落，方便在編寫代碼的同時監控資源消耗。
插件定位¶
- 插件名稱：dsh-api-balance
- 維護者：wwwwangpengggg
- 許可證：MIT
- 核心價值：在桌面角落浮出一個置頂小窗，實時顯示 DeepSeek API 賬戶的餘額，以及今天累計消耗的 token。
核心功能¶
- 桌面小窗：在桌面角落浮出無邊框、半透明的置頂小窗，支持高 DPI 渲染，在 125% / 150% 縮放下不模糊。
- 實時數據：
- 實時顯示 DeepSeek API 餘額。
- 顯示今日累計消耗的 token。
- 三頁顯示：
- 第 1 頁：餘額 + 今日累計消耗的 token（跨多次開關機累加）。
- 第 2 頁：今日消費的金額（基於餘額減少量估算）。
- 第 3 頁：計費時段（顯示當前是高峯期還是半價優惠時段，以及切換倒計時）。
- 交互與定製：
- 支持七套配色方案。
- 支持自定義背景圖片（右鍵菜單切換，無需重啓）。
- 點擊金額區域可在三頁間循環切換。
- 支持收進托盤，最小化主窗口不影響小窗。
安裝與啓用¶
前置條件¶
- Windows 10/11。
- 已安裝 DSH 桌面版。
安裝步驟¶
- 完全退出 DSH 桌面版：安裝前必須完全退出 DSH 進程（任務管理器確認
DSH Desktop進程消失）。DSH 正在運行時安裝會因 pnpm 鎖定文件而報錯。 - 執行安裝命令：將插件安裝進桌面版使用的 profile。
dsh plugin --profile desktop add git+https://github.com/wwwwangpengggg/dsh-api-balance.git
- 重新打開 DSH：安裝完成後，重新打開 DSH 桌面版，小窗會自動出現在屏幕角落。
使用方式¶
- 開關小窗：在任意會話中輸入
/balance命令，可以開啓或關閉小窗。 - 托盤操作：雙擊托盤圖標，或右鍵點擊托盤圖標選擇「顯示餘額小窗」。
- 右鍵菜單：
- 刷新頻率：支持 30秒 / 60秒 / 5分鐘 三個檔位。
- 頁面切換：右鍵菜單內可直接切換查看第 1、2、3 頁。
- 外觀設置：在右鍵菜單中選擇「外觀」可切換七套配色或更換背景圖片。
- 取消置頂：如需遮擋其他窗口，可取消置頂。
- 收起小窗：點擊小窗右上角的
×不會關閉程序，而是將其收進托盤。真要退出需在托盤右鍵菜單中選擇「退出小窗」。
計費時段說明¶
第 3 頁顯示當前的計費時段，幫助判斷是按高峯價還是半價計算。
- 起算時間：計費時段的「今天」從早上 08:00 起算，而非自然日的 00:00。凌晨 08:00 前仍算作上一時段。
- 高峯與優惠：
- 高峯時段：北京時間週一至週五 09:00-12:00 與 14:00-18:00（法定節假日除外）。
- 優惠時段：其餘全部時間（包括週末、節假日、午休 12:00-14:00）。
- 節假日判定：節假日判定基於 UTC 時間。插件內置了 2026 年的國務院法定節假日數據。如果提示未收錄年份，則默認按「不排除節假日」處理，寧可顯示高峯價也不誤報優惠價。
API Key 配置¶
小窗需要讀取 DeepSeek API Key。它按以下順序查找：
- 環境變量
DEEPSEEK_API_KEY。 $DSH_HOME/.credentials.yaml文件中的同名鍵。
Key 不會經過 DSH 的 IPC 通信，也不會出現在任何命令行中，小窗進程直接讀取文件，安全性較高。配置好 Key 後，點擊小窗內的「刷新」按鈕即可更新數據。
注意事項¶
- 今日消費估算：由於 DeepSeek API 只提供餘額接口，不提供賬單明細，今日消費金額是插件根據餘額的減少量倒推估算的。充值金額不計入消費計算。
- 安裝時機：務必在安裝前完全退出 DSH，否則會報
ERR_PNPM_EPERM錯誤。 - 手動安裝：如果網絡環境無法使用 pnpm，可以手動 clone 倉庫，編輯
package.json並創建 junction 鏈接，但官方推薦使用命令行安裝。
