前言¶
在 DeepSeek Harness（DSH）里做对话或开发智能体时，你需要在输入框下方的状态行看到两个关键信息：当前账号的余额，以及本轮对话已经消耗的 token 数量。如果没有直观的展示，要么要打开设置里的「账号」或「性能与用量 → 详细」页面，要么需要自己写脚本去查，多了一步跨页面查看的麻烦。dsh-balance-usage-widget 作为一个轻量的 composer-dock widget，把这两项信息直接放在输入框下方，用一行文字展示，悬停可看细分数据。
这是什么¶
这是一个为 DeepSeek Harness（DSH）设计的 composer-dock widget，由 XiongBangze 维护。它把 DeepSeek 账户余额和当前会话的 token 用量聚合到一行显示，帮助用户在不离开当前对话窗口的情况下掌握资源状态。它不是官方插件，而是社区项目，仅通过 DSH 客户端已有的接口读取余额和 token 数据，不发起额外网络请求，也不读写文件。
核心功能¶
一行显示余额与 token 用量
在 DSH 输入框下方的状态行中，左侧显示 DeepSeek 账号的充值余额，右侧显示本会话累计 token（未命中输入 + 缓存命中 + 缓存写入 + 输出）。示例格式为：
¥12.34 · 12.3K tok
悬停查看细分数据
将鼠标悬停在状态行上，会弹出细分数据，包括：
- 充值余额
- 赠金余额
- 本会话 token 分项（未命中输入、缓存读取、缓存写入、输出）
- 缓存命中率
容错显示
如果未登录或余额查询失败，状态行左侧会显示 余额 --，右侧的 token 数量仍正常显示。
安装与启用¶
从命令行安装
从 npm 安装，安装时需指定桌面端 profile（desktop profile 由桌面端独占管理）：
dsh plugin --profile desktop add dsh-balance-usage-widget
安装完成后重启 DSH，状态行即可出现余额与 token 显示。
从界面安装
在 DSH 侧栏中依次进入「插件 → 添加插件」，填写包名 dsh-balance-usage-widget，安装后重启 DSH。
本地开发安装
本地开发时，可在安装对话框中粘贴插件目录的绝对路径，通过命令行安装到临时 profile 进行测试：
dsh plugin --profile <profile> add /absolute/path/to/dsh-balance-usage-widget
典型用法¶
安装并重启 DSH 后，输入框下方会自动出现状态行，显示当前会话的余额和 token 用量。悬停可查看细分数据，帮助判断缓存命中率、输出 token 占比等。余额每 60 秒刷新一次，页面重新可见时也会刷新。
适用场景与注意¶
这个插件适合需要在对话过程中持续监控资源状态的 DSH 用户，尤其是使用充值余额而非纯 API key 的场景。余额需要 DeepSeek 账号登录，API-key-only 的环境会因为内置账号服务不暴露余额而显示 余额 --。
插件以当前 DSH 进程的权限运行，读取数据来自 DSH 客户端已有的接口，不发起额外网络请求，也不读取会话正文或写文件。使用前建议检查源码与许可证（MIT），确认隐私与边界行为符合预期。
结语¶
dsh-balance-usage-widget 把余额与 token 用量从设置页面拉到输入框下方，用一行文字和悬停展开的方式，减少跨页面查看的次数。如果你在 DSH 中需要频繁查看资源状态，可以尝试安装这个轻量 widget。
- 目录页：https://www.skillhub.cn/plugins/XiongBangze/dsh-balance-usage-widget
- GitHub：https://github.com/XiongBangze/dsh-balance-usage-widget
