前言¶
在 DeepSeek Harness 中運行 DeepSeek 相關任務時，通常會遇到兩個直接問題：賬戶餘額是否還夠用，以及當前會話已經消耗了多少 token。
dsh-deepseek-usage 是一個面向 DeepSeek Harness 的 DSH 插件，把這兩件事封裝成模型可調用工具：deepseek_balance 用於查詢 DeepSeek 賬戶餘額，usage_summary 用於彙總當前 live 會話的 token 用量。
這是什麼¶
插件名是 dsh-deepseek-usage，維護者爲 ben7am1n，許可證爲 MIT。
它的定位是 DeepSeek Harness 使用監控插件，提供兩個工具：
deepseek_balance：查詢 DeepSeek 賬戶餘額。usage_summary：彙總當前 live 會話的 token 用量。
核心功能¶
deepseek_balance¶
deepseek_balance 會查詢：
GET https://api.deepseek.com/user/balance
返回內容包括賬戶可用性，以及按幣種給出的餘額字段：total、granted、topped-up。
如果配置了 lowBalanceThreshold，當主要幣種餘額低於該閾值時，工具會在結果中追加一條低餘額警告。
usage_summary¶
usage_summary 從 Harness 的 token meter 中聚合當前 live 會話的每會話 token 用量，並按 total tokens 從高到低排序。
這個工具可用於估算上下文佔用，也便於發現 token 用量異常高的會話。
安裝與啓用¶
插件需要 DeepSeek API key，且該 key 需要能作爲 DEEPSEEK_API_KEY 從 env 或 credential 中讀取。
安裝命令如下：
dsh plugin --profile <name> add dsh-deepseek-usage
命令中的 <name> 是 profile 佔位符，需要替換爲要安裝該插件的 profile 名稱。
peerDependencies 要求如下：
@deepseek-ai/cordis ^4.0.1@deepseek-ai/dsh-session ^0.1.0-rc.6@deepseek-ai/dsh-token-meter ^0.1.0-rc.6@deepseek-ai/dsh-tools ^0.1.0-rc.6
配置¶
插件配置包含以下字段：
| 字段 | 默認值 | 說明 |
|---|---|---|
apiKeyEnv |
DEEPSEEK_API_KEY |
API key 對應的 env var 或 credential reference |
baseURL |
https://api.deepseek.com |
DeepSeek API base URL |
lowBalanceThreshold |
— | 可選的低餘額警告閾值 |
下面是一個 profile 示例，啓用 deepseek-usage，並把低餘額閾值設爲 20：
# profile cordis.patch.yml
- id: deepseek-usage
config:
apiKeyEnv: DEEPSEEK_API_KEY
lowBalanceThreshold: 20
典型用法¶
安裝並啓用後，可以在 Harness 中調用以下工具：
1、調用 deepseek_balance，獲取賬戶可用性和各幣種餘額。
2、調用 usage_summary，查看當前 live 會話按 total tokens 排序的 token 用量。
如果配置了 lowBalanceThreshold，deepseek_balance 在主要幣種餘額低於閾值時會附帶警告。
適用場景與注意¶
適合在 DeepSeek Harness 中使用 DeepSeek API，並且希望把餘額檢查和 token 用量彙總納入日常檢查的場景。
使用前注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 DEEPSEEK_API_KEY可用於查詢賬戶信息，建議只放在可信環境中。lowBalanceThreshold是可選配置；不配置時不會觸發低餘額警告。
鏈接¶
- 社區目錄頁：https://www.skillhub.cn/plugins/ben7am1n/dsh-deepseek-usage
- GitHub：https://github.com/ben7am1n/dsh-deepseek-usage
