前言¶

在使用 DeepSeek Harness (DSH) 進行智能體開發時，需要同時管理多個項目或長期運行任務。追蹤 token 消耗和費用分佈是常見痛點。手動逐個打開項目查看日誌效率低下，且難以直觀對比不同模型的成本。dsh-cost-tracker 旨在側邊欄實時展示全局花費統計，無需切換項目即可掌握成本，並自動同步官方定價。

插件定位¶

這是一個用於 DSH 的側邊欄任務花費統計插件，由 ruozhi5067 維護。它解決了跨項目追蹤費用和同步官方定價的問題，屬於記憶類插件。

核心功能¶

• 側邊欄卡片：在側邊欄底部顯示總花費、當前項目花費、token 明細（輸入命中、輸入未命中、輸出）。支持摺疊態和展開態，展開態可查看各項目明細。
• 官方定價同步：自動更新 DeepSeek 官方人民幣單價。抓取邏輯爲啓動時、每 12 小時或超過 6 小時未更新時刷新，也可手動點擊 ↻ 刷新。若抓取失敗，會回退到內置人民幣價格。
• 增量讀取日誌：除了內存中的活躍會話，還增量讀取持久化的會話日誌，因此側邊欄裏未打開的其他項目也會自動顯示花費，無需逐個打開項目。
• 插件管理：可在插件管理頁管理（批准/停止/移除）。
• 熱加載支持：支持熱加載補丁（cordis.patch.yml），無需重啓即可生效。
• 計費邏輯：僅對會話日誌中帶 usage 的模型調用計費。
• 內置價格表：內置價格表適配 deepseek-v4-flash / deepseek-v4-pro。

安裝與啓用¶

本插件作爲 profile bundle 安裝。

1、進入 profile 目錄

cd ~/.dsh/profiles/<profile>

2、安裝插件包

pnpm add dsh-cost-tracker

3、將插件加入 bundle 列表
在 ~/.dsh/profiles/<profile>/package.json 中修改 dsh.profile.bundles 字段，將 dsh-cost-tracker 加入列表：

{
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "...", "dsh-cost-tracker"]
    }
  }
}

該配置會自動插入插件行。

使用方法¶

安裝後，側邊欄底部（cordis 插件面板上方）會出現花費卡片。
- 查看數據：卡片默認顯示總花費和當前項目花費。點擊卡片可摺疊或展開，展開後顯示 token 明細和官方模型單價。
- 快捷操作：在窄側欄（56px 圖標欄）下會顯示緊湊的 花費 ¥x 按鈕，點擊可展開側邊欄。
- 刷新單價：點擊卡片上的 ↻ 圖標可手動刷新官方單價。
- 組件管理：在側邊欄 Cordis 插件面板中，可以批准/停止/移除動態組件「任務花費統計」。

注意事項¶

• 瀏覽器端授權：瀏覽器端授權不跨進程。重啓後首次加載動態組件時，需要在 Cordis 插件面板點擊一次「允許」。
• 計費依據：費用按官方主表價格計算，峯值/谷值分時價僅展示，費用計算使用官方主表價格。
• 數據隱私：所有數據本機計算，不發送任何會話數據。從官方定價頁只讀取價格數字。
• 許可證：MIT 許可證。