DeepSeek Harness Usage 插件介紹

前言¶

DeepSeek Harness (DSH) 採用“一切皆插件”的架構，通過擴展插件來增強核心能力。對於開發者而言，監控 Token 使用量、估算模型成本以及分析調用趨勢是日常工作的重要部分。DeepSeek Harness Usage 插件旨在解決這一需求，它是一個本地優先的插件，直接從 DSH 的會話日誌中讀取數據，提供成本分析、趨勢圖表和活動熱力圖，而無需依賴外部遙測服務或創建並行數據庫。

這是什麼¶

該插件由維護者 syncended 開發，目前處於 MVP（最小可行性產品）階段，支持 DSH 的 0.1.5-rc.2 主面板 API，並保留了對舊版 0.1.1-rc.2 的導航回退支持。作爲本地工具，它嚴格遵循“只讀”原則，會話日誌是數據的單一來源。

核心功能¶

插件提供了一套完整的使用分析工具，主要包含以下功能：

全功能工作區：點擊側邊欄的 Usage 即可打開完整的工作區界面。
時間範圍篩選：支持 30 天、90 天、1 年以及全部時間範圍的數據查看。
成本分析：
- API 估算：提供除 Codex 以外的提供商的 Token 率估算。
- Codex API 等效值：提供 openai-codex 提供商的假設性成本估算。
- 實際費用：當前不可用，插件不導入發票或支付記錄。
交互式圖表：
- 趨勢圖：支持指針和鍵盤提示的交互式圖表，可查看 Token、估算成本或調用次數。
- Token 混合可視化：使用圓環圖展示輸入/輸出/緩存的 Token 比例。
- 活動熱力圖：交互式 365 天熱力圖，支持多種顏色模式和四分位數強度設置。
數據細分：支持按提供商、按模型進行使用量拆解，並按會話、調用次數、Token 體積和估算成本排序。
智能處理：
- 時區感知：瀏覽器時區感知的日期分組。
- 後臺掃描：Host 啓動後自動後臺掃描，並定期刷新，不干擾主界面渲染。
- 緩存機制：修訂感知緩存，跳過未更改的會話，支持磁盤檢查點複用。

安裝與啓用¶

在安裝或升級後，需要重啓 dsh web 進程以使插件生效。

dsh plugin --profile web add @syncended/dsh-usage

重啓後刷新頁面，在側邊欄中打開 Usage 即可查看數據。

配置與使用¶

插件支持通過配置文件覆蓋定價或掃描行爲。

編輯 $DSH_HOME/profiles/web/cordis.patch.yml 文件中的 usage 行：

- id: usage
  config:
    scanConcurrency: 2
    scanBatchSize: 32
    refreshIntervalSeconds: 60
    cachePath: /absolute/path/to/usage-checkpoint.json

定價說明¶

Token 率估算不是支付記錄：儀表盤區分 API 估算和 Codex 等效值，兩者均爲估算值，不構成實際賬單。
分類規則：分類使用提供商路由（不區分大小寫），而非模型名稱。這意味着通過企業網關訪問 GPT 模型不會被自動歸類爲訂閱使用。
語言設置：界面語言遵循 DSH Web UI 的 <html lang> 設置（即 DSH 內置語言），而非瀏覽器區域設置。

注意事項¶

只讀模式：插件不修改數據，僅讀取日誌。
依賴 Host：需要 Host 支持 appReady 信號以實現最佳的後臺掃描體驗（舊版 Host 仍可使用）。
開源許可：插件遵循 MIT 許可證，請自行檢查源碼與許可證後再行安裝。

生態與鏈接¶

該插件屬於 DSH 插件生態的一部分，與 DeepSeek 官方無直接從屬關係。更多詳情可訪問：
* GitHub 倉庫
* 技能社區插件目錄