在使用 DeepSeek Harness (DSH) 进行智能体开发或日常调用时，实时掌握账户余额与 Token 消耗情况是调试和计费的基础。手动查询接口或查看日志往往不够直观。下面介绍 dsh-plugin-quota，一个能将 DeepSeek 账户额度与会话用量直接挂载到 DSH Web 设置界面的插件。
这是什么¶
插件名称为 dsh-plugin-quota，由 ArvenWang 维护。它是一个独立的安装插件，核心价值在于将原本需要额外查询或从日志中获取的数据，一键接入 DSH 的 Web 设置界面，实现余额与用量的可视化监控。
核心功能¶
插件提供两类监控视图：
-
账户额度
实时查询 DeepSeek 账户余额。支持按币种展示总额度、赠送额度与充值额度。具备可用性状态徽标（可用/不可用），并包含完整的加载、失败与重试状态。若失败，会明确提示原因（如未配置 Key、HTTP 错误等）。 -
Token 用量
统计当前会话的累计消耗。将数据分为未缓存输入、输出、缓存读取、缓存写入四个独立桶，并显示合计值。行内展示使用紧凑的 k/M 格式，悬停可查看精确数值。数据源为 harness 的tokenUsage投影，随会话实时更新。
安装与启用¶
使用官方命令安装到 Web Profile：
dsh plugin --profile web add dsh-plugin-quota
安装完成后，需要重启 dsh web（或重启桌面 App），并在设置界面找到“额度”分区查看。
典型用法¶
在使用前，需确保已配置 DeepSeek API Key。可以通过环境变量 DEEPSEEK_API_KEY 设置，或在 设置 → 模型 页面配置。进入设置 → 额度后，即可看到账户余额状态及当前会话的 Token 消耗明细。
适用场景与注意¶
- 环境要求：DeepSeek Harness 版本需 >= 0.1.0-rc.5（Web profile）。
- 兼容性：需提供有效的 DeepSeek API Key。若使用自定义 OpenAI 兼容端点，该端点必须支持
/user/balance路由，否则会显示 HTTP 错误。 - 安全机制：该插件遵循 DSH 的安全原则。路由仅只读，API Key 不经过浏览器传输，全部留在宿主进程内，不会落盘或写入日志。
- 开发细节：插件零构建、零运行时依赖（仅 peer 依赖）。代码可直接运行，主要依赖 Harness 官方包。
结尾¶
通过接入 dsh-plugin-quota，开发者可以在日常使用 DSH Web 界面时，无需离开设置页面即可掌握资源状态与消耗情况。其 MIT 许可证允许自由使用与修改。更多详情或源码，可参考项目仓库：https://github.com/ArvenWang/dsh-plugin-quota
