前言¶
DeepSeek Harness (DSH) 的插件生態旨在解決特定場景下的開發與運維問題。在團隊協作或共享環境中，追蹤 DeepSeek 的實際消耗和成本往往依賴於 API 調用或手動統計，不夠直觀。該插件通過讀取本地日誌來計算使用量，從而回答“這臺機器消耗了什麼”和“公司預算還剩多少”這兩個問題。
插件定位¶
dsh-deepseek-budget 是一個 DeepSeek 花費計量器。它從本地 session 日誌中讀取 token 使用情況，按 DeepSeek 列表價格進行計費，不直接調用 API，因此可以使用共享 API 密鑰。
核心能力¶
本地日誌解析與內容發現¶
插件從本地日誌（./.l）讀取使用情況，無需 API 密鑰。它通過內容發現檢測本機上的所有 harness，不僅包含 DSH，還包括其他工具（如 Pi、Claude Code 等）的 DeepSeek 調用。DSH 使用專用適配器處理其 zstd 壓縮日誌，其他 harness 通過通用記錄讀取器解析。
重複記錄處理¶
同一次調用可能被記錄多次（如子代理轉錄和父會話日誌）。插件基於 DeepSeek 的響應 ID 或指紋（時間、路由、token 數）全局摺疊重複記錄。例如，在測試機器上，這刪除了 593 條記錄，避免了因重複記錄導致的 72% 支出高估。
定價與計費¶
插件使用 DeepSeek 的列表價格計算成本，而非發票金額。支持緩存命中/未命中統計，以及高峯和非高峯定價（UTC 時間）。
* 高峯時段：UTC 01:00-04:00 和 06:00-10:00，週一至週五（排除中國公共假期）。
* 緩存寫入：按未命中費率計費。
* 支持模型：deepseek-flash、deepseek-v4-pro 等。
公司賬戶預算¶
本地日誌只能描述本機。要查看公司賬戶的整體進度，需要配置 DEEPSEEK_USER_TOKEN（平臺要求）。提供 GET /deepseek-budget/account API 獲取賬戶餘額、當月支出和預算進度。
安裝與啓用¶
將插件鏈接到 web profile：
dsh plugin --profile web add link:$(pwd)
安裝後重啓 DSH。
典型用法¶
- 查看儀表盤：在 DSH 設置中進入 DeepSeek Budget 頁面，查看預算表、窗口選擇器（Today/7 days/30 days/All）、按模型/按天成本等。
- 本地報告：使用
GET /deepseek-budget/report?window=all獲取本地使用情況的 JSON。 - 設置預算：設置環境變量
DEEPSEEK_BUDGET_EUR（默認 50）。 - 公司賬戶：設置環境變量
DEEPSEEK_USER_TOKEN以查看公司賬戶支出。
適用場景與注意¶
- 僅限本機：插件以當前 DSH 進程權限運行，僅能統計本地日誌中的調用。無法看到數據庫日誌或未記錄的調用，也無法看到其他機器的消耗。
- 權限要求：公司賬戶部分需要
DEEPSEEK_USER_TOKEN，該 token 僅賬戶所有者可獲取。 - 配置靈活性：支持通過
DEEPSEEK_BUDGET_ROOTS或DEEPSEEK_BUDGET_HOME自定義日誌根目錄。
