前言¶
在 DSH 裏調用 DeepSeek 模型時，常見需求有兩個：當前 DEEPSEEK_API_KEY 對應的 DeepSeek 開放平臺餘額還有多少，以及本機 DSH 會話累計花了多少錢。已有做法通常是去 DeepSeek 開放平臺查餘額，再手動查看日誌或記錄用量。
dsh-deepseek-balance 是一個 DSH 個人使用插件，把這兩類信息放到 DSH 左側底部入口中，減少來回切換。
這是什麼¶
Bob-Bo1/dsh-deepseek-balance 是一個用於 DeepSeek Harness（DSH）的個人使用插件。它由 Bob-Bo1 維護，採用 MIT License。
它解決的是：在 DSH 網頁界面裏查看 DeepSeek 開放平臺 API 餘額，以及本機 DSH 已保存會話的消費統計。
核心功能¶
下面介紹已覈實的能力：
- 在 DSH 左側底部提供入口
- 查看 DeepSeek 開放平臺 API 餘額
- 查看 DSH 本機保存會話的累計消費金額
- 查看今日消費金額
- 查看 Flash 和 Pro 的分別消費金額
- 讀取 DSH 憑據中的
DEEPSEEK_API_KEY - 請求 DeepSeek 官方餘額接口
- 根據 DSH 會話中的模型和 token 用量重新計算消費金額
- 提供本機路由
GET /api/deepseek-balance和GET /api/deepseek-balance/usage
餘額來自當前 DEEPSEEK_API_KEY 對應的 DeepSeek 賬戶；消費金額來自本機 DSH 會話記錄。兩者統計範圍不同。
安裝與啓用¶
先安裝插件。執行：
npx @deepseek-ai/dsh plugin --profile web add github:Bob-Bo1/dsh-deepseek-balance
如果第一次運行提示 Ok to proceed? (y)，輸入 y 並按回車。看到 Done 後啓動 DSH：
npx @deepseek-ai/dsh web
然後打開：
http://127.0.0.1:3080
如果 DSH 已經在運行，先在運行窗口按 Ctrl+C，安裝插件後重新啓動。
如果 Windows PowerShell 無法執行 npx，把命令中的 npx 改成 npx.cmd：
npx.cmd @deepseek-ai/dsh plugin --profile web add github:Bob-Bo1/dsh-deepseek-balance
配置與查看¶
插件讀取 DSH 憑據中的：
DEEPSEEK_API_KEY
配置步驟：
- 打開 DSH 的模型設置。
- 配置 DeepSeek 官方 API Key。
- 點擊左下角的“DeepSeek 餘額與費用”。
經過上面的步驟，頁面會展示餘額和本機消費統計。插件會讀取 DSH 憑據並請求 DeepSeek 官方餘額接口，瀏覽器頁面收到的是餘額和統計結果。
如果安裝後左下角沒有入口，在運行 DSH 的窗口按 Ctrl+C，再執行：
npx @deepseek-ai/dsh web
最後刷新網頁。
數據安全¶
- API Key 保存在用戶自己的 DSH 憑據存儲中。
- API Key 不會進入瀏覽器頁面。
- API Key 不會上傳到本項目，也不會發送到第三方服務器。
- 餘額請求只發送到
https://api.deepseek.com/user/balance。 - 消費統計只讀取本機 DSH 已保存的會話日誌。
- 插件不會上傳會話正文。
不要把 API Key 寫入 README、代碼、截圖、Issue 或 GitHub Actions 配置。
統計範圍與限制¶
消費金額根據 DSH 會話中的模型和 token 用量重新計算。當前版本不會自動獲得以下數據：
- 其他電腦上的 DSH 使用記錄
- DSH 以外客戶端的使用記錄
- 沒有保存 token 用量的歷史請求
- 其他 API Key 的獨立消費記錄
因此，頁面中的消費金額適合做本機 DSH 使用情況參考，不適合直接當作跨設備、跨客戶端或完整賬戶賬單。
如果你有多個 API Key，請先選擇一個作爲 DSH 當前使用的主 Key。多個 Key 屬於同一個 DeepSeek 賬戶時，餘額不能相加；屬於不同賬戶時，也需要分別查看，避免把金額混在一起。
價格可能隨 DeepSeek 官方公告調整。調整後需要更新插件中的價格常量再發布新版本。
適用場景與注意¶
適合使用 DSH Web 界面、需要查看當前 DEEPSEEK_API_KEY 餘額和本機會話消費的使用者。
安裝前應檢查源碼與許可證。該插件以當前 dsh 進程權限運行，並會讀取 DSH 憑據、請求 DeepSeek 官方接口、讀取本機 DSH 已保存的會話記錄。項目許可證爲 MIT License，詳見 LICENSE。
結尾¶
dsh-deepseek-balance 的價值在於把餘額查詢和本機消費統計收斂到 DSH 左側入口，適合日常查看當前 Key 的餘額和本機 DSH 使用情況。
