前言¶
DeepSeek Harness (DSH) 採用插件化架構。團隊在本地或內網環境開發時，需要監控每一步真實的 Token 消耗與成本，以便進行預算控制和成本覈算。dsh-team-reporter 插件將本機的使用數據上報到你自建的團隊看板，數據隱私由你自己掌控。
插件簡介¶
這是一個由 CHENKEYI-MAKER 維護的 DSH 插件（MIT 協議）。它的作用是收集本機的 Token 使用記錄，上報到你自行搭建的團隊看板上，以便團隊統一查看用量和成本。
核心功能¶
- 按次採集：從本機的
session/event流中收集單次調用的數據，包括 input_tokens、cache_read_tokens、output_tokens、模型名稱和項目目錄。 - 離線隊列：記錄會寫入磁盤隊列。即使進程重啓或網絡中斷，數據也能在恢復後重放，且通過冪等設計防止重複計數。
- 隱私安全：僅發送 Token 計數和成本信息。插件絕不會發送 Prompt、回覆、文件內容或任何憑證。
- 技能同步：支持從服務器同步團隊技能。插件每 30 分鐘同步一次，採用原子替換策略。服務器是技能權威，同步失敗不會刪除本地已安裝的技能。
安裝與啓用¶
-
獲取插件包
從團隊下載頁或 Releases 標籤頁下載dsh-team-reporter-0.2.0.tgz。 -
安裝插件
使用 DSH 的 CLI 命令安裝，路徑必須使用絕對路徑（相對路徑會被 pnpm 拒絕）：
dsh plugin --profile desktop add "C:\Users\you\Downloads\dsh-team-reporter-0.2.0.tgz"
或者在 DSH 側邊欄中：**插件** -> **添加插件** -> 粘貼文件絕對路徑 -> 安裝。
- 重啓與綁定
安裝後需要重啓 DSH。重啓完成後，右下角會出現一個灰點，點擊打開，輸入團隊服務器 URL 和管理員分配的註冊碼（Enrollment Code），點擊“綁定”。綁定成功後，灰點變綠，開始上報。
配置與注意事項¶
- 環境要求：需要 Node.js >= 22.5.0。
- 配置來源：服務器配置（如價格表、刷新間隔）通過本地的
/api/v1/config接口從服務器學習，本地無需手動配置。 - 隱私細節：離開本機的數據只有 Token 計數和 session ID 的哈希值。Workspace 字段僅爲項目目錄的名稱，不包含完整路徑。
- 註冊碼：註冊碼是一次性的，屬於特定個人。重新安裝或更換機器需要向管理員申請新的註冊碼。
- 技能目錄：服務器同步的技能存放在
~/.dsh/skills/dsh-team/，本地個人技能存放在~/.dsh/skills/my-skills/，兩者互不干擾。
總結¶
如果你需要在本機運行 DSH，同時希望團隊負責人能看到本機的真實 Token 消耗與成本，且堅持數據隱私，可以安裝此插件。它通過本地隊列和冪等重放機制保證了數據的可靠性，通過僅傳輸計數保證了隱私安全。
