前言¶

在 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