前言¶

在 DSH 的插件式環境裏，會話側信息可以隨宿主一起擴展，而不必另開一個計費面板。dsh-billing 是一個 DeepSeek Harness 插件，用來在 Web UI 中顯示 DeepSeek 賬戶餘額和當前會話費用（人民幣）。它解決的是對話進行中需要確認“餘額還有多少”“這一輪花了多少”的問題。相比每次手動查詢賬單，它把餘額和本會話費用放在會話頭部，並提供斜槓命令、工具和 UI 三種入口。

這是什麼¶

dsh-billing 由 TheTianzz 維護，許可證爲 MIT。它的定位是 DeepSeek Harness 插件，將 DeepSeek 賬戶餘額與會話費用接入當前 Web UI，支持人民幣展示，並支持按模型查看 token 與費用拆分。

核心功能¶

會話頭部顯示¶

• Web UI 會話頭部雙膠囊常駐顯示餘額和本會話費用。
• 點擊任一膠囊，立即刷新余額和會話費用。
• 鼠標懸停餘額膠囊，顯示充值、贈金、美元明細。
• 鼠標懸停費用膠囊，顯示按模型的 token 與費用拆分。

命令入口¶

下面兩個斜槓命令用於在聊天框中查詢：

/balance
/cost

• /balance：查詢賬戶餘額（人民幣優先，附美元）。
• /cost：查看當前會話費用明細。

工具入口¶

如果直接問模型，可以使用工具：

deepseek_billing
query = balance / cost / both

deepseek_billing 支持 query = balance / cost / both，可以直接問模型“餘額多少”或“花了多少錢”。

刷新與價格同步¶

• 刷新是事件驅動的，空閒時零請求，無後臺常駐任務。
• 啓動時 + 每 12 小時自動拉取官方價格頁，解析最新單價（含峯谷價與生效時間）。
• 配置全部可選。
• 價格同步優先級：用戶顯式配置 > 官方在線同步 > 內置默認。

可選配置項如下：

config.pricing
config.priceSync

• config.pricing：按模型覆蓋單價（元/百萬 tokens），並支持峯谷價自動切換。
• config.priceSync：關閉或調整價格同步。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile web add dsh-billing

執行完成後，按下面步驟啓用：

1、重啓 dsh web。
2、刷新瀏覽器頁面（F5），使新 boot graph 生效。
3、在 Web 模型設置頁保存 DEEPSEEK_API_KEY 憑據引用。

典型用法¶

啓用後，可使用下面這些入口：

• 聊天框輸入 /balance 查詢賬戶餘額（人民幣優先，附美元）。
• 聊天框輸入 /cost 查看當前會話費用明細。
• 直接問模型“餘額多少/花了多少錢”，由 deepseek_billing 處理。
• 點擊 UI 會話頭部任一膠囊，立即刷新余額和會話費用。
• 鼠標懸停餘額膠囊查看充值、贈金、美元；懸停費用膠囊查看按模型的 token 與費用拆分。

適用場景與注意¶

適合在 DeepSeek Harness Web 會話中查看餘額、本會話費用和按模型拆分的用戶。需要注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼和許可證。
• 插件輸出爲估算值，實際扣費以 DeepSeek 官方賬單爲準。
• 子代理是獨立會話，各自單獨統計。
• 失敗重試也計入費用。
• config.pricing 與 config.priceSync 均爲可選項。

結尾¶

dsh-billing 的價值是把 DeepSeek 的賬戶餘額和會話費用放到當前 Web UI 會話附近，提供常駐顯示、即時刷新和命令/工具查詢入口。

• GitHub：https://github.com/TheTianzz/dsh-billing
• 目錄頁：https://www.skillhub.cn/plugins/TheTianzz/dsh-billing（URL 來自插件線索）