前言¶
在 DSH（DeepSeek Harness）裏使用 DeepSeek 做會話時，賬戶餘額和本會話消費金額通常不會直接顯示在操作界面上。dsh-deepseek-balance 是一個 DSH 插件，把 DeepSeek 官方賬戶餘額和本次會話消費金額常駐顯示在 Web 輸入框下方，並每 15 秒刷新。
DSH 的插件生態強調「一切皆插件」，社區目錄是獨立站點；本文只基於已覈實資料介紹這個插件，不把它寫成 DeepSeek 官方應用。
這是什麼¶
倉庫地址：
https://github.com/CN-Leo/dsh-deepseek-balance
一句話定位：DeepSeek 賬戶餘額即時顯示插件（DeepSeek Harness / DSH）。
已覈實資料中的許可證爲：
MIT
已覈實資料中的 package.json 版本號爲：
0.2.3
它解決的主要問題有兩個：
1、在 DSH Web 中快速看到 DeepSeek 官方賬戶餘額。
2、按 DeepSeek 官網定價規則，估算並顯示當前會話已經消費了多少金額。
核心功能¶
下面介紹已覈實的插件能力。
插件會在 DSH Web 輸入框下方（conversation.composer.dock）常駐顯示餘額信息。
conversation.composer.dock
顯示內容包括餘額和本會話消費金額。示例格式如下：
DeepSeek 餘額 ¥71.33 ｜ 本會話 ¥4.85
核心能力如下：
1、每 15 秒自動刷新余額和本會話消費金額。
2、按 DeepSeek 官網最新定價即時計算本次會話消費金額。
3、從官方接口獲取餘額數據：
GET https://api.deepseek.com/user/balance
4、API Key 由 Host 端從 DSH 憑據庫解析，不進入瀏覽器。
5、支持通過環境變量或 $DSH_HOME/.credentials.yaml 配置 DEEPSEEK_API_KEY。
6、懸停餘額條可查看餘額明細、按模型 token 用量、當前時段和會話消費金額。
7、按 deepseek-v4-flash / deepseek-v4-pro 分模型計價，並區分高峯/空閒時段。
安裝與啓用¶
下面介紹安裝步驟。
如果使用 Git 倉庫地址安裝，已覈實資料中的命令如下，其中倉庫地址保留佔位符：
dsh plugin add https://github.com/<你的用戶名>/dsh-deepseek-balance
如果插件源碼在本地目錄，也可以使用本地路徑安裝：
dsh plugin add /path/to/dsh-deepseek-balance
安裝後需要重啓 dsh web。當前進程不會熱加載新插件。
安裝後重啓 dsh web
配置 DEEPSEEK_API_KEY 是必需步驟。可以通過環境變量配置，也可以寫入 $DSH_HOME/.credentials.yaml：
DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxx
配置後無需重啓插件。每次請求都會重新解析憑據。
系統側需要 curl。Windows 自帶 curl.exe；其他平臺需要 PATH 中有 curl。
curl
典型用法¶
安裝並配置完成後，在 DSH Web 會話界面中可以看到餘額條。
餘額條顯示在會話輸入框下方，示例如下：
DeepSeek 餘額 ¥71.33 ｜ 本會話 ¥4.85
懸停餘額條時，可查看更完整的明細。已覈實資料中提到的內容包括：
各幣種餘額、賬戶可用狀態、按模型分列 token 用量、當前時段、本次會話消費金額
本會話消費金額會按會話實際使用的模型分模型計價。已覈實的計價範圍是 deepseek-v4-flash / deepseek-v4-pro，並區分高峯/空閒時段。
以下情況需要注意：
1、非 DeepSeek 模型不套用 DeepSeek 價格表、不計入消費金額。
2、緩存寫入按緩存未命中輸入價計。
適用場景與注意¶
這個插件適合在 DSH Web 中使用 DeepSeek 賬戶、並希望直接看到餘額和本會話消費的開發者或智能體流程使用者。
使用前的注意事項如下：
1、插件會在 Host 端解析 DEEPSEEK_API_KEY，並以當前 dsh 進程權限運行相關子進程。安裝前應檢查倉庫源碼、許可證和依賴。
2、API Key 只存在於 Host 進程的 curl 子進程參數中，瀏覽器端只能拿到餘額 JSON。
3、Host 依賴：credentials、subprocess、sandboxPolicy、webServer。
4、Client 依賴：slots 服務、react。
5、系統需要 curl。
卸載¶
如果不再使用該插件，可以使用下面的命令移除：
dsh plugin remove dsh-deepseek-balance
鏈接¶
GitHub 倉庫：
https://github.com/CN-Leo/dsh-deepseek-balance
目錄頁 URL 未在本次已覈實資料中給出，請以實際 DSH 社區目錄站點爲準。
