前言¶
DSH 的插件生态强调「一切皆插件」。在智能体开发中，费用、Token 用量和订阅额度往往分散在不同平台：会话里可以统计输入、缓存、输出 Token 及费用，但 DeepSeek 余额、OpenCode GO、Kimi For Coding、GLM Coding Plan、火山方舟等额度仍需要分别查看。
dsh-quota-dashboard 把这类信息集中到一个 Web 看板里，同时保留会话费用统计能力。下面介绍它的定位、核心功能、安装方式以及使用限制。
这是什么¶
dsh-quota-dashboard 是 CyBerKitTen0009 维护的 DeepSeek Harness 插件，分类为费用、Web UI、观测，许可证为 MIT。
它主要解决两件事：
- 会话费用统计：展示输入、缓存、输出 Token 及费用，并支持当日费用、预算、余额、历史记录等统计。
- 统一额度看板：在设置页查看 DeepSeek 余额、OpenCode GO、Kimi For Coding、GLM Coding Plan、火山方舟订阅额度。
本插件与 dsh-cost-meter 功能重叠，二者互斥，不要同时安装。
核心功能¶
会话费用统计¶
已核实的统计能力包括：
- 会话费用徽章：输入、缓存、输出 Token 分列展示，并显示费用；位置可配为输入区下方或会话标题栏。
- 展示当日费用、预算图框、官方账户余额和历史记录；预算图框包含预算、已用%和进度条。
- 支持峰谷计价，资料标明 DeepSeek 自 2026-08-17 起两档；支持官方价格一键同步。
- 提供 26 周 Token 用量热图、按模型 Token 桶拆分，以及中英双语。
统一额度看板¶
看板入口为设置 → 额度看板 · Quota。默认包含 5 个 Provider：
- DeepSeek 余额
- OpenCode GO
- Kimi For Coding
- GLM Coding Plan
- 火山方舟
额度看板配置可按需启用/禁用或修改。看板行为如下：
- 每行可展开查看进度条与重置倒计时。
- 自动刷新默认 5 分钟，可配置；页面隐藏时暂停。
- 未配置凭证的行显示中性提示，不阻塞其他 Provider。
- 查询失败的行红色标注错误信息。
- 全部 Provider 并行查询，单行失败互不影响。
安装与启用¶
- 使用本地源码安装，将路径替换为实际仓库目录：
dsh plugin --profile web add link:/absolute/path/to/dsh-quota-dashboard
- 安装后重启 dsh web 生效。
- 进入设置 → 额度看板 · Quota 查看看板。
配置与凭证¶
额度看板配置存于账本配置，默认包含 5 个 Provider，可按需启用/禁用或修改。
凭证解析优先序为：
DSH 凭据库(ctx.credentials) → 环境变量
已核实的兼容用法包括：
- OpenCode GO 支持 OPENCODE_API_KEY 旧名与 opencode CLI 登录态。
- Kimi 支持 KIMI_API_KEY，以及 Kimi Code CLI 登录态。
安全与兼容¶
- 兼容 DeepSeek Harness >= 0.1.0-rc.5，当前 rc.6 验证通过；Node >= 20。
- 依赖 @deepseek-ai/dsh-credentials、@deepseek-ai/dsh-home-paths、zod。
- 凭证只在宿主进程解析，不进入浏览器或日志。
- 看板数据经同源 /quota-dashboard-api/state 下发，资料标明使用 loopback Host + 自定义头双重守卫。
- 火山方舟 AK/SK 经火山 SigV4 签名，密钥不出现在 URL / 命令行。
- 账本与配置仅写 DSH_HOME/storages/quota-dashboard/ledger.json，采用原子写。
- 网络权限声明限定于以下地址：
https://api.deepseek.com
https://api-docs.deepseek.com
https://opencode.ai
https://api.kimi.com
https://open.bigmodel.cn
https://api.z.ai
https://open.volcengineapi.com
适用场景与注意¶
适合需要同时查看多个 Provider 额度、统计会话费用、并在 Web 端管理预算的 DSH 用户。使用前注意：
- 本插件与 dsh-cost-meter 互斥，二者功能重叠（同款账本/服务），不要同时安装。
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 未配置凭证的行会显示中性提示，不阻塞其他 Provider。
- 网络权限声明只覆盖上述声明地址。
- 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-quota-dashboard 的价值在于把分散的会话费用、Token 用量和多平台额度放到同一个 DSH Web 看板中。若只需要本地试用，可按上面的 link 安装流程接入；若需要公开引用，建议以下列目录页和仓库为准。
- 目录页：https://www.skillhub.cn/plugins/CyBerKitTen0009/dsh-quota-dashboard
- GitHub：https://github.com/CyBerKitTen0009/dsh-quota-dashboard
