前言¶

在 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