前言¶

用 DeepSeek Harness（DSH）跑智能體，模型供應商往往不止一家：官方 DeepSeek、OpenRouter 中轉、Kimi Coding Plan、Z.ai 訂閱窗口……對話在 Harness 裏發生，但餘額和配額卻散落在各家控制檯。Token 花了多少、緩存命中率如何、今天哪個模型最費 token，Harness 原生界面也缺少一張「總覽儀表盤」。

社區插件 dsh-usage-stats（維護者 Ychris12138，npm 包名 @ychris12138/dsh-usage-stats）面向 dsh web 網頁端，把多供應商賬戶監測與本地 Token 聚合分析收進側邊欄「用量/餘額」面板。該插件在 SkillHub 插件庫歸類爲「客戶端」，GitHub 約 119 stars、15 forks，採用 MIT 許可證。

需要說明的是：DSH 的核心理念是「一切皆插件」；SkillHub、deepseek-harness-plugin.com 等社區目錄由愛好者維護，與 DeepSeek / 幻方無官方從屬關係，安裝前請自行審閱源碼與許可證。插件以當前 dsh 進程權限運行，涉及賬戶查詢時會讀取你本機已配置的憑據引用，不會把 API Key 下發到瀏覽器。

這是什麼¶

一句話定位：爲 DeepSeek Harness Web GUI 提供供應商餘額、訂閱配額與 Token 用量分析的可視化客戶端插件。

數據來源分兩塊：

本地 Token 統計：從 Harness 持久化會話日誌中摺疊 assistant/chunk 或 assistant/message 裏 provider 上報的 usage 字段，按日期、供應商、模型聚合。
遠端賬戶快照：對配置了公開餘額/配額接口的 provider，服務端定時拉取餘額或 Token Plan 窗口剩餘量。

界面支持中文與英文；瀏覽器只請求當前選中的 provider，後臺每五分鐘刷新已配置賬戶，與面板是否打開無關。

核心功能與亮點¶

統一賬戶卡片¶

面板一次只展示當前選中的供應商：

餘額型（如 DeepSeek、Moonshot、OpenRouter）：顯示可用餘額與預警狀態。
訂閱/Token Plan 型（如 Kimi For Coding、MiniMax、Ollama 雲、Z.ai）：顯示分時間窗口的額度與剩餘比例。

沒有公開賬戶接口的供應商仍會統計 Token，卡片會標明「不支持」餘額查詢，不會猜測數值。

Token 用量分析¶

今日、本月、累計用量與緩存命中率。
月曆熱圖，支持 ‹ / › 切換月份，點擊日期下鑽到當天的 provider / model 明細。
「最近 14 天」按本地日曆計算，只顯示窗口內有記錄的日期。

可擴展適配器¶

除 DeepSeek、OpenRouter、Moonshot 等內置適配外，還支持：

New API、Sub2API / Passion 等中轉協議。
sub2api-auth：用 provider 自身推理 Key 讀 Sub2API 面板餘額，可自動識別真實 Sub2API 部署。
declarative：受限 GET + JSON Pointer 的聲明式自定義查詢，不執行 JavaScript。

warning.warnBelow / warning.criticalBelow 可設餘額絕對值閾值；有總額度的場景會自動產生 normal / warning / critical 剩餘比例狀態。

本機安全邊界¶

官方 README 強調的五條設計原則值得安裝前瞭解：

五個 API 端點僅接受迴環地址的 GET 請求；非 GET 返回 405，非迴環返回 403。
API Key、Cookie、管理 PAT 只在服務端解析，不會進入瀏覽器響應、插件緩存或日誌。
用量緩存 ~/.dsh/storages/usage-stats-cache.json 只保存聚合 Token 與會話 revision，不保存提示詞或回覆正文。
自定義 monitor 默認要求 HTTPS、同源相對路徑，並限制響應體大小。
請勿把插件端點經反向代理暴露到局域網或公網。

安裝與啓用¶

前提：需要 DSH 的 web profile，且 @deepseek-ai/dsh >= 0.1.0-rc.6。

推薦：dsh plugin 安裝¶

目錄頁與 README 給出的命令如下（注意 web profile 與 GitHub 源）：

dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats"

安裝後重啓已運行的 dsh web，並在瀏覽器中硬刷新。側邊欄底部會出現「用量/餘額」（Usage/Balance）入口。

如需可復現安裝，可固定 commit：

dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats#commit"

升級與卸載：

dsh plugin --profile web update "@ychris12138/dsh-usage-stats"
dsh plugin --profile web remove "@ychris12138/dsh-usage-stats"

deepseek-harness-plugin.com 目錄頁亦收錄該插件，簡寫安裝方式爲 dsh plugin add github:Ychris12138/dsh-usage-stats；若你日常使用 web profile，以上帶 --profile web 的寫法與 README 一致，更不易裝錯 profile。

備選：npx 兼容安裝器¶

無法使用 dsh plugin 時，可用同一條命令（PowerShell、cmd、macOS/Linux 終端通用）：

npx --yes github:Ychris12138/dsh-usage-stats

安裝器會把文件複製到 ~/.dsh/profiles/node_modules/@ychris12138/dsh-usage-stats，並冪等寫入 profiles/web/cordis.patch.yml。dsh plugin 與 npx 是兩條獨立路徑，不要同時保留手工 Cordis entry 與 bundle 註冊，否則會重複掛載。

預覽與檢查：

npx --yes github:Ychris12138/dsh-usage-stats --dry-run
npx --yes github:Ychris12138/dsh-usage-stats --check

插件市場 GUI 安裝（可選）¶

該倉庫已按 DSH Community Market 標準來源（Path A）接入。因 npm 上 dsh-usage-stats 名稱已被佔用，目錄身份使用 @ychris12138/dsh-usage-stats（當前 catalog 版本 0.2.10）。若要通過市場 GUI「安裝」按鈕一鍵安裝，需維護者先發布 scoped 公共 npm 包並將 catalog 發佈到 GitHub Pages；在此之前，GitHub / dsh plugin 路徑更直接。

憑據與典型配置¶

憑據由 Harness 從 ~/.dsh/.credentials.yaml 解析；安裝器不會讀取或修改該文件。不要把真實 Key 提交到 Git 或粘貼給編碼 Agent。

餘額型供應商示例¶

DeepSeek、Moonshot 等默認複用對應 provider profile 的 apiKeyEnv：

# ~/.dsh/.credentials.yaml
DEEPSEEK_API_KEY: sk-your-key-here

OpenRouter 是明確例外：賬戶 credits 接口要求 Management Key，不能複用普通推理 OPENROUTER_API_KEY：

OPENROUTER_MANAGEMENT_KEY: sk-or-v1-your-management-key

Token Plan 供應商示例¶

OPENCODE_GO_API_KEY: sk-opencode-your-key
ZAI_API_KEY: your-zai-key
KIMI_API_KEY: your-kimi-key
MINIMAX_API_KEY: your-minimax-key
OLLAMA_API_KEY: sk-ollama-your-key

中國區 Z.ai / MiniMax 可分別設置 ZAI_API_REGION=bigmodel-cn、MINIMAX_API_REGION=cn。

自定義 monitor（節選）¶

在現有 @ychris12138/dsh-usage-stats 的 Cordis entry 下合併 config，不要追加第二個插件 entry。monitor 鍵須對應 Harness 中真實的 provider id：

# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
    - id: usage-stats
      name: "@ychris12138/dsh-usage-stats"
      config:
        monitors:
          relay-a:
            adapter: new-api
          relay-b:
            adapter: sub2api-auth

Sub2API 面板若已作爲普通 provider 配置進 DSH，插件可探測 GET /api/v1/settings/public 並自動按 sub2api-auth 讀取餘額，通常無需單獨寫 adapter。

典型用法¶

啓動 dsh web 並打開對話界面。
點擊側邊欄「用量/餘額」。
用「當前供應商」下拉切換賬戶卡片。
在熱圖區域用 ‹ / › 切換月份，點擊某天查看 provider / model 明細。
標題欄刷新會更新 Token 聚合、provider 列表，並強制刷新當前賬戶快照。

統計口徑來自 provider 上報的 usage，不是本地估算；同一 turn 的後續樣本會替換舊樣本。手動刷新不會批量強制請求其他供應商的遠端賬戶。

適用場景與注意事項¶

適合誰：

長期在 dsh web 裏開發，同時使用多家 API 或 Coding Plan 的開發者。
需要在本機一眼看清「今天花了多少 token、哪家餘額快見底」的智能體用戶。
運營 New API / Sub2API 中轉，希望在 Harness 內直接看 relay 餘額的人。

注意事項：

僅適用於 web 客戶端；TUI 或其他 profile 不在設計範圍內。
安裝前閱讀 SECURITY.md，確認網絡邊界與憑據處理方式符合你的安全要求。
OpenCode Go 等上游 Bearer usage 接口可能隨官方變化，需關注插件版本更新。
插件依賴 Harness 預發佈接口（Cordis、session persistence 等），大版本升級後可能需要同步更新插件。

結尾¶

如果你已經在 Harness 裏接了好幾家模型，卻還在瀏覽器標籤頁和各家控制檯之間來回切換，dsh-usage-stats 把餘額、配額與 Token 熱力圖收進側邊欄，是目前社區裏較完整的一類「用量儀表盤」方案。GitHub 約 119 stars 也說明不少 DSH 用戶確實需要這層可視化。

目錄頁：SkillHub — Ychris12138/dsh-usage-stats
源碼與文檔：github.com/Ychris12138/dsh-usage-stats
社區目錄（同插件另一入口）：deepseek-harness-plugin.com

安裝命令再抄一遍：

dsh plugin --profile web add "github:Ychris12138/dsh-usage-stats"

重啓 dsh web 後，打開「用量/餘額」，從你最常用的那家 provider 開始看即可。

用 dsh-usage-stats 在 DeepSeek Harness 網頁端看清餘額、配額與 Token 用量

前言¶

這是什麼¶

核心功能與亮點¶

統一賬戶卡片¶

Token 用量分析¶

可擴展適配器¶

本機安全邊界¶

安裝與啓用¶

推薦：dsh plugin 安裝¶

備選：npx 兼容安裝器¶

插件市場 GUI 安裝（可選）¶

憑據與典型配置¶

餘額型供應商示例¶

Token Plan 供應商示例¶

自定義 monitor（節選）¶

典型用法¶

適用場景與注意事項¶

結尾¶

精选优惠券

用 dsh-usage-stats 在 DeepSeek Harness 網頁端看清餘額、配額與 Token 用量

前言¶

這是什麼¶

核心功能與亮點¶

統一賬戶卡片¶

Token 用量分析¶

可擴展適配器¶

本機安全邊界¶

安裝與啓用¶

推薦：dsh plugin 安裝¶

備選：npx 兼容安裝器¶

插件市場 GUI 安裝（可選）¶

憑據與典型配置¶

餘額型供應商示例¶

Token Plan 供應商示例¶

自定義 monitor（節選）¶

典型用法¶

適用場景與注意事項¶

結尾¶

精选优惠券

相關文章