在 DeepSeek Harness (DSH) 的 Web 环境中，插件系统极大地扩展了功能边界。DSH 的设计理念是“一切皆插件”，社区维护的独立目录与 DeepSeek 官方应用没有直接隶属关系，开发者可以据此构建定制化的工作流。
火山引擎的 Agent Plan 提供了公开的余量查询 API，但 Coding Plan 缺乏此类接口。控制台只能看到整体百分比，无法回溯单次请求或按模型拆分。本文介绍的 dsh-volcengine-usage 插件旨在解决这一问题，在 DSH 页面提供可拖动的 Coding Plan 用量监控卡片。
插件介绍¶
该插件由用户 helloworld1631 开发，当前状态为等待维护者审核，尚未在官方目录声明为已收录。它是一个 MIT 许可的开源项目，专注于在 DSH Web 界面展示 Coding Plan 的额度消耗情况。
与社区中已有的 dsh-billing-balance 或 dsh-quota-panel 等通用插件不同，此插件保留了特定的窄场景需求：仅显示火山 Coding Plan 的三个额度窗口（5 小时、每周、每月）。它使用控制台登录态而非要求用户配置 AK/SK，并提供一个简单、可拖动的完整卡片。代价是 Cookie 可能过期，且接口可能随控制台更新而变化。
核心功能¶
- 用量展示：在卡片上直观展示 5 小时、每周和每月的用量百分比。
- 刷新机制：点击右上角的
↻按钮可立即刷新，卡片也会每 5 分钟自动刷新。 - 交互与记忆：按住“火山 Coding Plan”标题栏即可拖动卡片，浏览器会保存卡片位置，刷新或重启后仍会保留。
- 安全处理：Cookie 和 Web ID 仅在 DSH 服务端读取，不会发送给浏览器端。
- 开发接口：服务端提供一个稳定的本机 JSON 接口，便于二次开发或集成。
安装与启用¶
在 DSH 插件目录中添加该插件：
dsh plugin --profile web add github:helloworld1631/dsh-volcengine-usage
安装完成后，重启 DSH Web 服务：
dsh web
配置凭据¶
插件依赖 DSH 的 credentials 服务来解析凭据。你需要配置以下环境变量：
VOLCENGINE_COOKIE：完整的 Cookie 字符串VOLCENGINE_WEB_ID：Web ID
在 credentials-local (version 1) 中通常以 YAML 格式写入：
version: 1
refs:
VOLCENGINE_COOKIE: "完整 Cookie"
VOLCENGINE_WEB_ID: "Web ID"
请使用 DSH 自带的凭据管理能力或 YAML 序列化器写入，不建议手工拼接长 Cookie。
使用方法¶
安装并配置完成后，DSH 页面会出现一个可拖动的用量卡片：
- 查看用量：卡片顶部显示 5 小时、每周和每月的用量百分比。
- 手动刷新：点击卡片右上角的
↻按钮立即获取最新数据。 - 自动刷新：卡片会每 5 分钟自动更新一次。
- 移动卡片：按住标题栏拖动，位置会被浏览器本地记录。
如果火山会话过期，更新本机凭据后重新刷新即可。
注意事项¶
- 接口稳定性：插件使用登录后的控制台网页 Cookie 调用控制台内部页面请求，并非火山引擎承诺稳定的公开 Coding Plan API。接口可能变化，Cookie 可能过期。
- 凭据安全：本仓库不包含、也不应提交任何 Cookie、API Key、Web ID 或
.credentials.yaml文件。服务端接口默认只接受本机环回连接，浏览器端无法读取原始凭据。 - 插件状态：请根据当前的审核状态和自身需求，选择更合适的插件或自行维护。
生态链接¶
- 插件目录：https://www.skillhub.cn/plugins/helloworld1631/dsh-volcengine-usage
- GitHub 仓库：https://github.com/helloworld1631/dsh-volcengine-usage
