dsh-workbuddy-usage

在 DeepSeek Harness（DSH Desktop）左侧栏底部加一行原生风格的「使用量」条目，点开是 Codex 统计风格的用量面板 —— 每日 Token、积分消耗、缓存命中、按模型单价、账号剩余额度，一屏看完。

数据来自 workbuddy2api / CodeBuddy 兼容网关自带的面板接口（/panel/api/usage、/panel/api/overview），插件只读，不改动网关。

侧栏条目

功能

侧栏常驻条目：使用量 · 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 模块，改完必须重启一次才会加载；客户端半侧之后可热更新。

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

配置

config.json（可用环境变量 WORKBUDDY_USAGE_BASE / WORKBUDDY_USAGE_KEY 覆盖前两项）：

字段	默认值	说明
`baseUrl`	`http://127.0.0.1:7863`	网关地址，含 scheme 与端口，不带尾斜杠
`apiKey`	—	面板 API Key（`Authorization: Bearer`）
`routePrefix`	`/dsh-workbuddy-usage`	注册到 DSH webServer 的前缀路由
`cacheTtlMs`	`25000`	用量数据缓存
`accountTtlMs`	`60000`	账号额度缓存
`timeoutMs`	`20000`	上游请求超时

路由（由宿主半侧注册到 DSH 同源 webServer）

路径	说明
`GET {routePrefix}/api/usage?scope=today\|7d\|30d\|all[&refresh=1]`	用量 + `account` 账号数据
`GET {routePrefix}/api/account[?refresh=1]`	仅账号额度与状态
`GET {routePrefix}/api/config`	读取当前配置（不返回 Key 明文，只给 `hasApiKey` 与 `apiKeyHint`）
`POST {routePrefix}/api/config`	保存 `{ baseUrl, apiKey?, timeoutMs? }`，写回 `config.json`、清缓存并立刻探活
`GET {routePrefix}/api/ping`	连通性 / 配置自检（不含 Key）

为什么必须有宿主半侧

面板响应带 Content-Security-Policy: connect-src 'self'、Cross-Origin-Resource-Policy: same-origin，且没有 Access-Control-Allow-Origin，浏览器无法直连。因此由宿主进程（Node）带 Bearer 拉取上游，再以同源前缀路由提供给渲染进程。

数据字段

上游 by_model[] / totals 每条记录会被规范化为：

{
  "requests": 306, "errors": 3,
  "promptTokens": 28890000, "completionTokens": 209000, "totalTokens": 29095704,
  "credits": 45.99, "creditTokens": 29095704, "creditsPer1M": 1.58,
  "cacheHitTokens": 27750000, "cacheMissTokens": 1345704, "cacheHitRate": 96.1,
  "avgLatencyMs": 14394, "tokensPerSecond": 250
}

账号侧来自 /panel/api/overview：totals{accounts,healthy,cooling,paused,disabled,credits,creditsTotal} 与 accounts[]{uid,nickname,realm,credits,creditsTotal,cooling,disabled,until,reason,lastModel,requests,totalTokens,earliestExpiry,earliestRemaining}。

开发与调试

客户端 bundle 由宿主 @deepseek-ai/dsh-client-hmr 每 500ms 轮询 mtime/size，变化即重新发布并经 SSE /plugins/events 推送 —— 改 client.js 后无需重启 DSH。
但 pnpm 对 file: 依赖是复制而不是软链：~/.dsh/profiles/desktop/node_modules/dsh-workbuddy-usage/ 里是副本，页面加载的是副本。改完源码必须同步：
```
cp client.js ~/.dsh/profiles/desktop/node_modules/dsh-workbuddy-usage/client.js
```
改 index.js（宿主半侧）没有热更新，重启 DSH 才生效。
快捷验证：curl -H "Authorization: Bearer $KEY" "http://127.0.0.1:7863/panel/api/usage?hours=24"。

排错

现象	原因 / 处理
侧栏没有「使用量」	profile `bundles` 未包含本包，或没执行 `pnpm install`，或没重启 DSH
面板显示「上游 401」	`apiKey` 与面板 `api_key` 不一致
面板显示「HTTP 404」	宿主半侧未加载（检查 bundles / 重启）
改了界面没变化	忘了同步 `node_modules` 里的副本（见上）
数字不更新	路由层有 25s 缓存，点标题栏右上角 ↻ 走 `refresh=1`
「设置」保存后提示失败 / 404	宿主半侧改过代码但没重启 DSH（index.js 无热更新）
账号额度区块不显示	宿主半侧未重启；或上游 `/panel/api/overview` 不可用（面板会显示原因）

兼容性

DSH Desktop 2.0.x（Web 客户端，http://127.0.0.1:43120）。
依赖的槽位：sidebar.footer.action（order: 25，原生「远程控制」为 26）、settings.section（order: 120）。
上游需提供 /panel/api/usage 与 /panel/api/overview 且支持 Bearer 鉴权（workbuddy2api 面板即满足）。

免责声明

第三方社区插件，与 DeepSeek / CodeBuddy 官方无关。插件只读取你自己网关的面板接口，不收集、不上传任何数据。

License

MIT

dsh-workbuddy-usage

数据来自 workbuddy2api / CodeBuddy 兼容网关自带的面板接口（/panel/api/usage、/panel/api/overview），插件只读，不改动网关。

侧栏条目

功能

侧栏常驻条目：使用量 · 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. 写配置（二选一）

或者：先手写配置文件

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 模块，改完必须重启一次才会加载；客户端半侧之后可热更新。

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

配置

config.json（可用环境变量 WORKBUDDY_USAGE_BASE / WORKBUDDY_USAGE_KEY 覆盖前两项）：

字段	默认值	说明
`baseUrl`	`http://127.0.0.1:7863`	网关地址，含 scheme 与端口，不带尾斜杠
`apiKey`	—	面板 API Key（`Authorization: Bearer`）
`routePrefix`	`/dsh-workbuddy-usage`	注册到 DSH webServer 的前缀路由
`cacheTtlMs`	`25000`	用量数据缓存
`accountTtlMs`	`60000`	账号额度缓存
`timeoutMs`	`20000`	上游请求超时

路由（由宿主半侧注册到 DSH 同源 webServer）

路径	说明
`GET {routePrefix}/api/usage?scope=today\|7d\|30d\|all[&refresh=1]`	用量 + `account` 账号数据
`GET {routePrefix}/api/account[?refresh=1]`	仅账号额度与状态
`GET {routePrefix}/api/config`	读取当前配置（不返回 Key 明文，只给 `hasApiKey` 与 `apiKeyHint`）
`POST {routePrefix}/api/config`	保存 `{ baseUrl, apiKey?, timeoutMs? }`，写回 `config.json`、清缓存并立刻探活
`GET {routePrefix}/api/ping`	连通性 / 配置自检（不含 Key）

为什么必须有宿主半侧

数据字段

上游 by_model[] / totals 每条记录会被规范化为：

{
  "requests": 306, "errors": 3,
  "promptTokens": 28890000, "completionTokens": 209000, "totalTokens": 29095704,
  "credits": 45.99, "creditTokens": 29095704, "creditsPer1M": 1.58,
  "cacheHitTokens": 27750000, "cacheMissTokens": 1345704, "cacheHitRate": 96.1,
  "avgLatencyMs": 14394, "tokensPerSecond": 250
}

开发与调试

客户端 bundle 由宿主 @deepseek-ai/dsh-client-hmr 每 500ms 轮询 mtime/size，变化即重新发布并经 SSE /plugins/events 推送 —— 改 client.js 后无需重启 DSH。
但 pnpm 对 file: 依赖是复制而不是软链：~/.dsh/profiles/desktop/node_modules/dsh-workbuddy-usage/ 里是副本，页面加载的是副本。改完源码必须同步：
```
cp client.js ~/.dsh/profiles/desktop/node_modules/dsh-workbuddy-usage/client.js
```
改 index.js（宿主半侧）没有热更新，重启 DSH 才生效。
快捷验证：curl -H "Authorization: Bearer $KEY" "http://127.0.0.1:7863/panel/api/usage?hours=24"。

排错

现象	原因 / 处理
侧栏没有「使用量」	profile `bundles` 未包含本包，或没执行 `pnpm install`，或没重启 DSH
面板显示「上游 401」	`apiKey` 与面板 `api_key` 不一致
面板显示「HTTP 404」	宿主半侧未加载（检查 bundles / 重启）
改了界面没变化	忘了同步 `node_modules` 里的副本（见上）
数字不更新	路由层有 25s 缓存，点标题栏右上角 ↻ 走 `refresh=1`
「设置」保存后提示失败 / 404	宿主半侧改过代码但没重启 DSH（index.js 无热更新）
账号额度区块不显示	宿主半侧未重启；或上游 `/panel/api/overview` 不可用（面板会显示原因）

兼容性

DSH Desktop 2.0.x（Web 客户端，http://127.0.0.1:43120）。
依赖的槽位：sidebar.footer.action（order: 25，原生「远程控制」为 26）、settings.section（order: 120）。
上游需提供 /panel/api/usage 与 /panel/api/overview 且支持 Bearer 鉴权（workbuddy2api 面板即满足）。

免责声明

第三方社区插件，与 DeepSeek / CodeBuddy 官方无关。插件只读取你自己网关的面板接口，不收集、不上传任何数据。

License

MIT

xiebrooooo/dsh-workbuddy-usage

dsh-workbuddy-usage

功能

安装

1. 放置插件

2. 写配置（二选一）

3. 挂进 profile

4. 重启 DSH Desktop

配置

路由（由宿主半侧注册到 DSH 同源 webServer）

为什么必须有宿主半侧

数据字段

开发与调试

排错

兼容性

免责声明

License

Community comments

xiebrooooo/dsh-workbuddy-usage

dsh-workbuddy-usage

功能

安装

1. 放置插件

2. 写配置（二选一）

3. 挂进 profile

4. 重启 DSH Desktop

配置

路由（由宿主半侧注册到 DSH 同源 webServer）

为什么必须有宿主半侧

数据字段

开发与调试

排错

兼容性

免责声明

License

Community comments