前言¶
用 DeepSeek Harness（DSH）跑智能体时，API 余额和本地用量往往要切到浏览器或第三方面板查看。DSH 本身支持 Cordis 动态插件，社区目录 SkillHub 上也有面向联网场景的扩展。yxxbc/dsh-balance-plugin（分类：联网工具）把余额查询、官方充值入口、用量统计和三方插件清单收进 DSH 界面，维护者为 yxxbc，当前版本 1.3.0，MIT 许可，GitHub 约 55 stars。
下面介绍插件定位、核心能力、安装步骤和典型用法。
这是什么¶
dsh-balance-plugin 是 DSH 的动态 Cordis 插件，在输入框工具行右侧提供三个图标入口，并在下方常驻余额条。它自动读取本机 DSH 凭据 DEEPSEEK_API_KEY，无需在界面里重复填写 Key；配置写入插件目录 config.json，重启后恢复。
核心功能¶
余额监控与告警¶
- 查询 DeepSeek API 余额，支持 CNY / USD 双余额池，多账户可并行查询。
- CNY / USD 各自设置低余额阈值（默认 ¥10 / $2），低于阈值时余额条标红。
- 提供直达官方充值页
platform.deepseek.com/top_up的入口，以及用量明细页链接。
用量统计¶
用量页参考 Miyu WebUI 用量页 的布局，包含：
- 统计瓦片、GitHub 贡献图风格的用量日历；
- 三段堆叠趋势柱状图；
- 模型消耗环形图与明细表；
- 最近 50 条调用记录。
性能指标覆盖轮次、步数、LLM 时长、工具调用时长、首 token 平均延迟、tok/s、缓存命中率。
三方插件管理¶
列出非官方（非 @deepseek-ai）Web 插件：包名、本地路径、Bundle rev、依赖；支持一键「打开目录」定位源码。
模型工具¶
注册 query_api_quota 工具。在对话里直接问「DeepSeek 余额还剩多少」即可得到余额摘要。
更新与持久化¶
插件面板内可检查更新并一键更新；也可用安装脚本带 UPDATE=1 更新。设置持久化到 config.json。
安装与启用¶
前置条件¶
- 已安装并运行 DeepSeek Harness。
- （可选）DeepSeek API Key。若本机已配置
DEEPSEEK_API_KEY，插件启动时自动读取。
一键安装¶
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | bash
Windows（PowerShell）：
irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex
安装完成后重启 DeepSeek Harness。输入框右侧出现三个图标按钮即表示生效。可用 DSH_PROFILE=<name> 指定其他 profile。
更新¶
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | UPDATE=1 bash
或在 DSH 面板内点击「检查更新」→「更新」。
卸载¶
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/uninstall.sh | bash
注意： README 说明 npm 上存在他人同名包 dsh-balance-plugin@0.1.0，裸包名 dsh plugin add dsh-balance-plugin 可能装错。请使用上述一键脚本或 github: 源安装。
典型用法¶
- 看余额：重启 DSH 后看输入框下方常驻余额条；或点钱包图标进入余额监控面板，配置阈值与刷新间隔。
- 查用量：点用量统计图标，切换时间范围，查看日历、趋势图和模型消耗明细。
- 对话查余额：在智能体对话中询问余额，由
query_api_quota返回摘要。 - 管理本地三方插件：打开三方插件管理页，核对包名与路径，需要改源码时用「打开目录」。
入口固定在输入框工具行右侧。DSH 侧边栏底部插槽可能被官方 Cordis 面板插件占用，本插件不依赖该插槽。
适用场景与注意¶
适合谁：
- 长期在 DSH 里跑智能体、需要随时看 CNY/USD 余额和本地用量的人；
- 本机装了多个非官方 DSH Web 插件、需要统一清点路径与依赖的人。
使用前注意：
- 插件以当前 DSH 进程权限运行，安装前建议阅读 源码 与 MIT 许可证。
- API Key 保存在本机插件目录
config.json，界面仅显示掩码；README 称源码与文档不含密钥。 - SkillHub 目录页与 DeepSeek / 幻方无官方从属关系，属于社区插件生态。
链接¶
- 目录页：https://www.skillhub.cn/plugins/yxxbc/dsh-balance-plugin
- GitHub：https://github.com/yxxbc/dsh-balance-plugin
- 配置与架构文档见仓库
docs/configuration.md、docs/architecture.md、docs/faq.md
