前言¶

在 DeepSeek Harness（DSH）的 dsh web 界面里，Token 用量、供应商余额和订阅配额往往分散在不同后台或日志中。已有做法通常是逐个查询供应商接口，或手工整理用量记录。dawsondx/dsh-token-data 是一个 DSH 插件，把这几类信息集中到 dsh web 中。下面介绍它的功能、安装方式和常用查询。

这是什么¶

dsh-token-data 是 dawsondx 维护的 DSH 插件，许可证为 MIT（© dawsondx）。它面向 dsh web 图形界面，提供 Token 用量仪表盘、供应商余额查询和订阅或配额窗口查询。插件内部 id 为 usage-stats，通过 DSH profile bundle 挂载。

使用前置条件是 DSH 的 dsh web 可正常运行，以及 Node.js >= 20。

核心功能¶

dsh-token-data 主要提供以下能力：

• 实时 Token 用量仪表盘，支持 Hero 汇总卡片与每日热力图
• 按日、按模型 Token 用量明细和 7 日堆叠趋势图
• 供应商余额查询，支持 DeepSeek、OpenRouter、Moonshot/Kimi、Z.ai 等
• 订阅或配额窗口查询，支持 OpenCode Go、Z.ai、Kimi、MiniMax 等
• 每日缓存命中率展示
• 只读、仅回环 API，提供 5 个 GET 端点
• 插件自身不存储密钥，凭据在请求时经 DSH 凭据服务解析
• 增量聚合并缓存 usage-stats-cache.json
• 面板容错、本地化错误消息、退避重试与保留最后一次成功数据
• 本地化数字格式，zh/ja 用亿/万，en 用 K/M/B

安装与启用¶

1、确认 DSH 的 dsh web 可启动，并且运行环境包含 Node.js >= 20。

2、执行插件安装命令：

dsh plugin --profile web add dsh-token-data

也可以使用 GitHub 直接添加：

dsh plugin --profile web add --ignore-scripts --config.auto-install-peers=false github:dawsondx/dsh-token-data

3、安装完成后重启 dsh web。

配置与查询¶

在 web profile 的 cordis.patch.yml 中，可以通过 usage-stats 的 monitors 配置供应商监视器。例如：

- id: usage-stats
  config:
    monitors:
      deepseek-official:
        adapter: deepseek-balance
        allowPrivateNetwork: true

上面的示例配置了 deepseek-official 监视器，使用 deepseek-balance 适配器，并开启 allowPrivateNetwork。

插件提供 5 个只读 GET 端点：

适用场景与注意¶

适合在 DSH Web 中集中查看用量的开发者：

• 需要查看每日 Token 用量、模型明细和 7 日趋势
• 需要查询 DeepSeek、OpenRouter、Moonshot/Kimi、Z.ai 等供应商余额
• 需要查看 OpenCode Go、Z.ai、Kimi、MiniMax 等订阅或配额窗口
• 希望保留最后一次成功数据，避免面板因瞬时网络失败空白

使用前建议注意：

• 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证
• API 只读、仅回环，不会写入会话或日志，peer-socket 地址是主要校验
• 插件自身不存储密钥，凭据在请求时经 DSH 凭据服务解析
• 账户快照会脱敏 authorization、cookie、api-key 等敏感头
• 供应商请求带 15 秒超时与 1 MB 响应上限
• OpenRouter 余额查询需要 Management Key
• 没有公开余额 API 的供应商会显示无公开余额接口状态，不猜测数字

相关链接¶

• 插件目录页：https://www.skillhub.cn/plugins/dawsondx/dsh-token-data
• GitHub：https://github.com/dawsondx/dsh-token-data