DeepSeek Harness 显示 API 余额的三种方法
想让 DeepSeek Harness（DSH）显示 API 余额，最直接的方法是安装一个专用的余额显示插件。以下介绍几种主流且好用的方法，你可以根据自己的喜好选择。
一、安装专用余额显示插件（推荐）
这是最方便、显示信息最全面的方法。DSH 拥有丰富的插件生态，可以通过其内置的插件管理命令一键安装。
1. dsh-balance（推荐首选）
这是一个功能全面的实时余额显示插件。
| 项目 | 说明 |
|---|---|
| 主要功能 | 在 Web UI 输入框下方实时显示账户余额和当前会话的预估消耗。悬停或点击可查看余额构成（赠送/充值）、定价策略等详细信息。 |
| 安装命令 | dsh plugin add dsh-balance |
| 指定配置文件安装 | dsh plugin --profile web add dsh-balance |
| 生效方式 | 安装后重启 dsh web 服务即可生效 |
2. dsh-balance-meter
这是一个在输入框旁（Composer dock）显示余额的轻量级插件。
| 项目 | 说明 |
|---|---|
| 主要功能 | 显示账户总余额和当前会话的预估成本。点击可查看更详细的余额构成和成本分解。它能自动检测你使用的模型（如 deepseek-v4-flash 或 deepseek-v4-pro）并按相应价格计算成本。 |
| 安装命令（从 Git 仓库安装） | dsh plugin --profile web add https://github.com/Ghost011118/dsh-balance-meter |
| 生效方式 | 安装后重启 dsh web 服务 |
3. dsh-usage-dashboard-plus
这是一个功能更强大的仪表板插件，会在侧边栏底部显示信息。
| 项目 | 说明 |
|---|---|
| 主要功能 | 除了显示 API 余额，还会统计今日花费，并提供一个可点击的详情卡片，展示调用次数、各模型消耗等详细数据。 |
| 安装命令 | dsh plugin --profile web add dsh-usage-dashboard-plus |
| 生效方式 | 安装后重启 dsh web 服务 |
通用提示：以上插件安装后，如果界面没有立即显示，可以尝试硬刷新浏览器页面（如 Cmd+Shift+R 或 Ctrl+Shift+R）。
二、启用“生存模式”（内置功能）
根据部分信息，DSH 可能内置了一个名为“生存模式”的功能。
| 项目 | 说明 |
|---|---|
| 功能描述 | 开启后，界面左下角可能会通过“血条”和“法力值”的方式来直观显示上下文长度（HP）和账户余额（MP）。 |
| 操作方法 | 在 DSH 的设置或偏好中寻找并开启“生存模式”或类似名称的选项。 |
三、手动调用 API 查询（技术向）
如果你想通过代码或脚本查询，可以直接调用 DeepSeek 官方的余额接口。这也是所有插件在背后做的事情。
| 项目 | 说明 |
|---|---|
| API 端点 | GET https://api.deepseek.com/user/balance |
| 请求方式 | 在请求头中添加你的 API Key 进行鉴权 |
| 示例命令 | curl -L -X GET 'https://api.deepseek.com/user/balance' -H 'Authorization: Bearer <你的API_KEY>' |
返回示例（JSON 对象，包含账户余额详情）：
{
"is_avAIlable": true,
"balance_infos": [
{
"currency": "CNY",
"total_balance": "110.00",
"granted_balance": "10.00",
"topped_up_balance": "100.00"
}
]
}四、总结与建议
总的来说，最推荐的方法是通过 DSH 的插件系统一键安装 dsh-balance。这种方式最简单，无需手动配置，重启后即可在界面上直观地看到余额，并且信息展示也很全面。
安装插件前，请确保你的 DeepSeek API Key 已经通过 DSH 的凭证服务（DEEPSEEK_API_KEY）配置好，插件会自动读取。如果插件安装后未显示，可以尝试检查 DSH 和插件的版本是否兼容，或查看 DSH 的日志输出（通常在终端运行 dsh web 的窗口）以排查错误。
说明：
• 以上信息整理自 DeepSeek Harness 社区及公开资料。
• 插件功能以实际版本为准，建议在安装前查看插件的最新文档。
• API 余额查询接口由 DeepSeek 官方提供，具体参数以官方最新文档为准。