前言¶

在 DSH 的插件化環境中，社區插件目錄是獨立站點，不等同於官方應用商店。如果你的 dsh 會話已經接入 DeepSeek Open Platform，但缺少餘額和當前會話費用提示，可以安裝 dsh-balance。

它用於 deepseek-harness 的 Host + Web Client，查詢 DeepSeek Open Platform 賬戶餘額，並估算當前會話費用。

這是什麼¶

dsh-balance 是一個用於 DeepSeek Harness（DSH）的插件，倉庫爲 LemCAE/dsh-balance，npm 包名爲 @lemcae/dsh-balance，許可證爲 MIT。

它主要解決兩類問題：

1、查看 DeepSeek Open Platform 賬戶餘額。

2、基於本地會話日誌，估算當前會話的費用消耗。

核心功能¶

查詢餘額¶

插件會查詢 DeepSeek Open Platform 官方餘額接口：

GET https://api.deepseek.com/user/balance

調用過程中，API key 只通過有界 node 子進程 stdin 傳遞，不出現在命令行、日誌或 UI。

估算當前會話費用¶

插件根據會話日誌中的用量估算當前會話費用消耗，並按北京時區峯谷計價。

估算僅供參考，官方賬單爲準。

會話頭部 chip¶

打開任意會話後，會話頂部會顯示：

餘額 ¥x | 會話 ≈¥y

點擊 chip 可刷新，懸停顯示詳情。

設置頁¶

在 設置 → DeepSeek 餘額 中，可以查看餘額，並管理：

• 自動刷新開關
• 刷新間隔
• 界面語言
• 可編輯價格表

模型工具¶

插件提供模型工具：

deepseek_balance

該工具無參數，返回餘額和調用會話的預估費用。

暫停感知刷新¶

連續 2 次刷新沒有新消息後，自動刷新暫停。

新會話出現時恢復。

暫停時按 5 分鐘探測一次，恢復可能最多延遲該間隔。

自包含部署¶

部署不需要修改宿主倉庫。

通信通過內置 commands Remote namespace 進行。

安裝¶

執行：

dsh plugin --profile web add @lemcae/dsh-balance

宿主需要提供 peer dependencies，包括：

@deepseek-ai/cordis ^4.0.1
@deepseek-ai/* ^0.1.0-rc.5
react

典型用法¶

下面列出常用入口。

1、會話頭部

查看：

餘額 ¥x | 會話 ≈¥y

點擊刷新，懸停查看明細。

2、設置頁

進入：

設置 → DeepSeek 餘額

管理餘額、自動刷新間隔、自動刷新開關、界面語言和價格表。

3、命令

可使用命令：

/dsh-balance [refresh | interval <毫秒> | prices <JSON> | language <auto|zh-CN|en> | auto-refresh <on|off>]

4、模型工具

讓模型調用：

deepseek_balance

注意與限制¶

費用估算基於本地會話日誌，可能與官方賬單存在差異。

官方賬單爲準。

使用時需要關注這些限制：

• 未知模型使用 default（v4-flash 費率）計價。
• Subagents 有獨立 session id，不包含在估算中。
• Compaction 可能導致估算保留壓縮前總量。
• 每次自動刷新會追加 command/run 和 command/done 事件；暫停機制可減少噪聲。
• 餘額緩存 10 秒，工具和 chip 可能共享一次 API 調用。

插件以當前 dsh 進程權限運行，安裝前應檢查源碼、依賴和 MIT 許可證。

鏈接¶

倉庫地址：

https://github.com/LemCAE/dsh-balance