前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者根据需求扩展功能。对于需要频繁查询 API 消耗的开发者来说，现有的监控方案往往需要浏览器权限或配置复杂。dsh-balance-status 插件解决了这个问题，它将 DeepSeek 账户的余额与用量信息直接集成到 DSH Web 界面的底部状态行中，无需额外的弹窗或复杂的配置，实现了轻量级的监控。
这是什么¶
这是一个由 yknBugs 维护的轻量级插件，用于查询 DeepSeek 账户余额。它通过在 DSH Web 界面的底部状态行追加余额信息，并提供一个左键单击弹出的详情面板，让用户可以直观地查看余额、充值、赠送以及当前对话和进程的已用量。插件采用余额差值记账法，不依赖价格表。
核心功能¶
- 状态行集成：在 DSH 默认状态行（如
x 轮 xx 步 · xx tok/s xx M tok · 缓存命中 xx%）之后追加余额显示。 - 用量详情面板：左键单击余额，弹出包含余额、充值、赠送、当前对话已用、当前进程已用的详情面板。
- 强制刷新：点击余额可强制立即刷新数据，绕过缓存。
- 自动刷新策略：默认每 5 分钟自动刷新一次，与 DeepSeek 余额接口的延迟对齐。
- 余额差值记账：不依赖外部价格表，通过余额差值计算用量，调价不影响计算结果。
- 未配置状态：当未配置 API Key 时，状态行显示“余额 未配置”。
安装与启用¶
插件支持通过本地打包文件或 GitHub 仓库安装。
本机打包安装（推荐）¶
直接复制源码目录安装会导致插件失效，建议先打包再安装。
# 1) 在插件目录执行打包命令
cd <插件目录>
pnpm pack
# 2) 安装打包后的 tarball 文件
dsh plugin --profile web add file:<插件目录>\dsh-balance-status-1.0.2.tgz
安装后需重启 dsh web 进程。
从 GitHub 仓库安装¶
如果 pnpm 提示拦截构建脚本，需在 pnpm-workspace.yaml 的 allowBuilds 中添加本包名。
dsh plugin --profile web add github:<用户名>/<仓库名>
配置与用法¶
- 配置凭据：在 DSH 凭据页配置
DEEPSEEK_API_KEY。这是查询余额的必要条件。 - 配置 Base URL（可选）：如需走内部网关，可配置
DEEPSEEK_BASE_URL，插件会自动跟随 DSH 设置中的llm-deepseek的baseURL。 - 查看与刷新：
- 刷新浏览器页面，状态行末尾应出现
余额 ¥xx.xx。 - 左键单击余额：强制立即刷新并打开详情面板。
- 关闭面板：点击空白处或按 Esc 键。
- 自动刷新：默认每 5 分钟自动刷新一次，点击可打断并强制刷新。
- 刷新浏览器页面，状态行末尾应出现
实现细节与限制¶
- 安全机制：密钥不进入浏览器，余额查询接口仅在本地访问。建议将 DSH 监听在
127.0.0.1。 - 数据持久性：“当前对话已用”和“当前进程已用”数据存储在宿主进程内存中，重启进程后数据会丢失。
- 显示精度：余额接口为 0.01 元粒度，小额消耗可能不显示。
- 会话消耗：多个对话同时进行时，会话会互相包含对方的消耗，这是余额差值记账法的固有限制。
- 功能范围：不支持画图、动画或会话历史记录。
- DSH 版本兼容：依赖 DSH 版本 0.1.7-rc.2（兼容 0.1.5-rc.x）。
许可与生态¶
本插件采用 MIT 许可证。其余额接口与记账思路参考了开源项目 DeepSeek-Balance-Whale-Widget。DSH 的插件生态独立于 DeepSeek 官方，旨在构建一个灵活的扩展系统。
- GitHub 仓库: https://github.com/yknBugs/dsh-balance-status
- DSH 生态目录: https://www.skillhub.cn/plugins/yknBugs/dsh-balance-status
