DeepSeek Harness 侧栏用量插件

前言¶

在 DeepSeek Harness（DSH Desktop）左侧栏底部加一行原生风格的「使用量」条目，点开是 Codex 统计风格的用量面板 —— 每日 Token、积分消耗、缓存命中、按模型单价、账号剩余额度，一屏看完。数据来自 workbuddy2api / CodeBuddy 兼容网关自带的面板接口（/panel/api/usage、/panel/api/overview），插件只读，不改动网关。

这是什么¶

dsh-workbuddy-usage 是一个 DSH 客户端插件，由维护者 xiebrooooo 开发。它在 DSH 左侧栏底部增加一个常驻条目，点击展开用量面板，显示 Token、积分、缓存命中率、按模型单价、账号剩余额度等指标。

核心功能¶

侧栏常驻条目¶

在「远程控制」正上方增加「使用量 · 2467 万」条目，图标 + 文案 + 右对齐数值，沿用 DSH 原生行高（36px）、圆角、hover 色与折叠态（只留图标）。

计数单位与区间切换¶

Token 未破 1 亿一律按「万」（948.1 万），破亿按「亿」（1.154 亿），并自动处理 10000 万 → 1 亿 的进位。
支持区间切换：今日 / 近 7 天 / 近 30 天 / 全部。

面板指标¶

区间 Token 总量、请求数（含错误数、平均延迟）、积分（含每百万 Token 均价）、缓存命中率、输出速度、输入/输出占比条、时序柱状图。

按模型明细¶

每个模型的请求数、Token 量，以及每百万 tokens 的积分消耗（1.25 积分/M；零消耗模型标「免费」）。

账号额度¶

账号池总剩余 / 总额度进度条
可用 / 冷却 / 禁用数量
逐账号剩余额度迷你条与状态点，悬停可看冷却原因、最近使用模型、累计请求与套餐到期时间。

面板内设置¶

标题栏右上角 ⚙ 直接改服务器地址与 API Key，保存后写回 config.json、清缓存并自动探活；同时注册到 DSH 设置页的「WorkBuddy 用量」分区，两条路都能进。

自动刷新¶

面板收起时 3 分钟、展开时 30 秒；标题栏右上角 ↻ 走 refresh=1 绕过缓存，刷新时图标旋转。

深/浅色自适应¶

按祖先背景亮度自动切换色板，全部使用 DSH 设计 token（--dsw-alias-*、--dsw-radius-*）。

安装与启用¶

1. 放置插件¶

git clone https://github.com/xiebrooooo/dsh-workbuddy-usage.git \
  ~/.dsh/plugins/dsh-workbuddy-usage

Windows 即 C:\Users\<你>\.dsh\plugins\dsh-workbuddy-usage。

2. 写配置¶

推荐：装好后在界面里填 —— 重启 DSH 后点侧栏「使用量」→ 面板右上角 ⚙（或打开 DSH 设置页 →「WorkBuddy 用量」），填写服务器地址与 API Key，点「保存并测试」。插件会把配置写进自己的 config.json 并立刻验证连通性，无需手改文件。

或者：先手写配置文件

cd ~/.dsh/plugins/dsh-workbuddy-usage
cp config.example.json config.json
# 编辑 config.json：填 baseUrl 与 apiKey

config.json 已被 .gitignore 忽略，不会误提交。

3. 挂进 profile¶

编辑 ~/.dsh/profiles/desktop/package.json：

{
  "dependencies": {
    "dsh-workbuddy-usage": "file:../../plugins/dsh-workbuddy-usage"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-workbuddy-usage"
      ]
    }
  }
}

然后在 profile 目录执行：

cd ~/.dsh/profiles/desktop
pnpm install

4. 重启 DSH Desktop¶

宿主半侧是 ESM 模块，改完必须重启一次才会加载；客户端半侧之后可热更新。

重启后左下角「远程控制」上方会出现「使用量」条目。

典型用法¶

查看今日用量¶

点击侧栏「使用量」条目，面板默认显示今日数据。顶部区间切换可切换到近 7 天 / 近 30 天 / 全部。

查看按模型明细¶

面板中「按模型明细」区块显示每个模型的请求数、Token 量、积分消耗（每百万 tokens 积分）。零消耗模型标「免费」。

查看账号额度¶

面板中「账号额度」区块显示账号池总剩余与总额度进度条，以及每个账号的剩余额度迷你条与状态点。悬停可查看冷却原因、最近使用模型、累计请求与套餐到期时间。

手动刷新¶

点击面板标题栏右上角 ↻ 走 refresh=1 绕过缓存，图标会旋转。

修改配置¶

点击面板标题栏右上角 ⚙ 修改服务器地址与 API Key，点「保存并测试」。配置会写回插件目录的 config.json。

适用场景与注意¶

适合使用 workbuddy2api / CodeBuddy 兼容网关、需要监控每日 Token 消耗与积分消耗的开发者。

插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

结尾¶

该插件在 DSH 左侧栏提供用量监控，支持 Token、积分、缓存命中率、按模型单价、账号剩余额度等指标，通过面板内设置可配置服务器地址与 API Key。

插件目录页：https://www.skillhub.cn/plugins/xiebrooooo/dsh-workbuddy-usage
GitHub：https://github.com/xiebrooooo/dsh-workbuddy-usage