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