前言¶
DeepSeek Harness (DSH) 的核心架構基於插件化設計。在實際的智能體開發或運維場景中，管理多個訂閱賬戶、監控配額使用情況以及追蹤本地運行日誌是高頻需求。dsh-token-usage 旨在爲 DSH 提供一套統一的賬戶與配額觀察機制，以及本地使用賬本，解決在多提供者環境下難以追蹤成本和訂閱狀態的問題。
插件定位¶
這是一個針對 DeepSeek Harness 的管理安全類插件，專注於賬戶管理、訂閱配額觀察和本地使用記錄。插件由 shaomingbo 維護，採用 MIT 許可證開源。
核心能力¶
該插件提供了以下功能，覆蓋了從連接管理到運行時診斷的多個層面：
- 統一提供者連接：支持對多種提供者的統一連接管理。
- 賬戶與配額觀察：提供訂閱配額的觀察能力，支持本地使用賬本的記錄。
- Antigravity 賬戶池：支持主-詳情視圖的賬戶池管理，支持激活、移除賬戶、池內輪轉以及自動故障轉移。
- 原生
codex-runtime/v1能力：提供所有者綁定的原生codex-runtime/v1能力接口。 - 訂閱登錄管理：支持訂閱登錄狀態管理，包括
pending-login和顯式的取消操作。 - SDK 流診斷：提供 SDK 級別的流診斷，可識別
completed、failed、cancelled和timed-out四種終端狀態。 - 原生壓縮計數器：提供原生壓縮過程的計數統計。
安裝與啓用¶
插件通過 NPM 生態進行分發。在安裝前，請確保你的運行環境滿足依賴要求（見下方說明）。
- 確認 Node.js 版本。根據
package.json，插件要求node版本大於等於22.19.0。 - 執行安裝命令：
npm install dsh-token-usage
安裝完成後，插件將註冊到 DSH 的插件系統中。根據配置，bin/install.js 會被執行以完成必要的初始化設置。
典型用法¶
該插件通常需要與特定的配套組件配合使用，以發揮完整的診斷和壓縮功能。
- 配合壓縮組件：爲了獲得完整的診斷階段和壓縮計數功能，建議將此插件與
dsh-codex-compaction0.3.2 配對使用。 - 啓用可選診斷：在啓用壓縮 0.4.0 時，可以激活
completed、failed、cancelled和timed-out等可選的診斷階段。
插件會通過原生接口與 DeepSeek 的運行時進行交互，利用 codex-runtime/v1 的 seam 來獲取底層的運行狀態。
注意事項¶
在使用該插件時，請注意以下事實：
- 數據安全：插件在 SQLite、RPC、日誌或導出數據中不包含遙測數據、提示詞或任何密鑰信息。
- 驗證機制：假傳輸和隔離的配對快照是獨立於真實模型接受進行驗證的，僅用於測試環境。
- 已知非阻塞限制：在壓縮狀態中，取消操作可能會顯示
CODEX_RUNTIME_ERROR，這是一個已知的行爲，不會影響核心功能的運行。
結語¶
dsh-token-usage 爲 DSH 提供了堅實的賬戶管理和運行時診斷基礎。如果你需要深入監控 DeepSeek Harness 的運行狀態和賬戶配額，該插件是一個可以直接落地的選擇。
- 插件目錄: dsh-token-usage
- 源代碼: GitHub
