前言¶
在 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
