DeepSeek Harness API 用量監控插件

DeepSeek Harness (DSH) 的核心架構基於插件擴展。在使用多模型或多供應商的場景下，實時掌握當前的 API 調用情況和 Token 消耗是控制成本和排查問題的關鍵。dsh-api-usage-monitor 插件旨在爲 DSH 提供統一的用量觀測能力，它不依賴於特定的 LLM 供應商，而是通用地讀取當前正在使用的 API。

定位與特性¶

這是一個 DeepSeek Harness (DSH) 永久插件（bundle）。它可以在設置頁呈現當前用量、分對話用量，並可掃描會話日誌讀取歷史用量。重啓後依然生效。

核心功能¶

該插件提供以下能力：

實時讀取當前 API：監測當前連接的模型提供商和模型名稱。
當前用量：展示累計的 Token 使用情況，支持按 API/模型分組，每 2 秒自動刷新。
分對話用量：按會話（sessionId）聚合的調用次數、Token 用量與所用 API。
歷史記錄：支持掃描持久化會話日誌中的用量記錄，讀取插件啓動之前的用量。
設置頁呈現：在 DSH 設置面板註冊獨立頁面展示數據。

安裝步驟¶

該插件通過 dsh plugin 命令安裝，並需在配置文件中登記。

執行安裝命令：

    dsh plugin --profile web add github:DrFaithinT/dsh-api-usage-monitor

編輯 $DSH_HOME/profiles/web/package.json，在 dsh.profile.bundles 數組中添加 "dsh-api-usage-monitor"：

    {
      "dsh": {
        "profile": {
          "bundles": [
            "@deepseek-ai/dsh-base",
            "@deepseek-ai/dsh-web-app",
            "dsh-api-usage-monitor"
          ]
        }
      }
    }

重啓 DSH Web 進程：

    dsh web

驗證：打開 設置 → API 用量 頁面查看數據。

典型用法¶

插件支持在對話中通過 @ 提及進行快速操作，或通過設置頁查看詳情。常用操作包括：

查看數據：詢問當前統計到的 Token 數量。
調整刷新：將設置頁刷新間隔從 2 秒調整爲 5 秒。
查看歷史：增加按天分組的用量統計。
版本管理：回滾到上一個版本。

注意事項¶

數據存儲：所有數據僅存於插件內存，不落盤、不上傳。
持久性：永久版插件重啓後依然生效；v1 動態掛載版本重啓後消失。
通信方式：Host ↔ Client 之間只走同源 HTTP JSON，不依賴 Typert RPC。
許可證：MIT 許可證。

總結¶

dsh-api-usage-monitor 爲 DSH 用戶提供了輕量級的 API 用量觀測方案。通過設置頁和歷史日誌掃描，它可以滿足從實時監控到歷史復盤的多種需求。