前言¶
用 DeepSeek Harness（DSH）跑智能體時，模型調用會不斷髮生，但 Web UI 默認並不彙總 token 消耗和費用。想覈對某次對話花了多少、高峯時段是否更貴、賬戶餘額還剩多少，往往要翻日誌或自己記賬。
下面介紹社區插件 dsh-usage-plugin（GitHub：feiyang-dev/dsh-usage-plugin）。它在 DSH Web 界面裏掛上「用量與消耗」和「剩餘餘額查詢」面板，自動記錄每次模型調用的 token 與緩存命中，按 DeepSeek 峯谷價計費，並支持導出與本地持久化。
這是什麼¶
dsh-usage-plugin 是 DeepSeek Harness 生態中的用量與消耗統計插件，由 feiyang-dev 維護，在 SkillHub 目錄中歸類爲客戶端插件。npm 包名爲 @feiyang666/dsh-usage-plugin，採用 MIT 許可證，要求 Node.js >= 18。
插件以 Host + Client 雙面一體 的 npm 包形式發佈：Node 側 Cordis 插件負責記錄、計費、餘額查詢與導出；瀏覽器側面板通過 /usage/api 與 host 通信。安裝後，Web UI 頂部「對話」「軌跡」之後會出現 「用量與消耗」 與 「剩餘餘額查詢」 兩個 tab。
核心功能¶
用量與消耗¶
每次模型調用會記錄 token 用量與緩存命中情況，包括輸入未命中、緩存命中、緩存寫入、輸出、推理和結束原因。費用按 DeepSeek 官方峯谷/基礎價格計算：
- 工作日高峯：北京時間 9:00–12:00、14:00–18:00
- 自 2026-08-23 起，週末全天按空閒價計費
模型名取自實際請求參數；非 DeepSeek 模型如實顯示，無官方價格的模型消耗按 0 統計。
概覽頁提供「按模型」彙總表和「按 API 服務商 × 模型」明細表，底部有總費用合計。支持日期篩選：今天、近 7 天、近 30 天、全部，以及自定義起止區間。
用量日曆與緩存命中列表¶
用量日曆按月展示每日用量熱力圖，可按消耗或調用數着色；懸停查看高峯/空閒消耗拆分，點擊某天可查看當日調用明細。
緩存命中列表按時間倒序排列，支持快捷篩選與自定義日期區間，彙總行區分高峯消耗、空閒消耗和總費用。列表分頁渲染，每頁 100 條。
價格表¶
面板內置 DeepSeek 官方 API 價格表，覆蓋 deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-v4-pro。高峯價與空閒價分列展示，可在面板內編輯並持久化到 pricing.json，也可一鍵恢復默認。
餘額查詢¶
使用當前配置的 DEEPSEEK_API_KEY 查詢 DeepSeek 賬戶餘額。需在 設置 → 模型 中配置與對話相同的 API Key。
導出與導入¶
支持將記錄導出爲 CSV、JSON 或 PNG 長圖（按最新在前，最多 2000 條，超出會提示；PNG 含高峯/空閒消耗分列）。可通過原生目錄選擇器指定導出位置，導出後自動打開所在目錄。
支持選擇 JSON 或 CSV 文件合併導入，按時間去重。
持久化與跨平臺¶
自 v1.9.2 起，記錄存放在固定專用數據目錄，不隨工作區切換而丟失。默認路徑因平臺而異，例如 Windows 爲 %LOCALAPPDATA%\dsh-usage-plugin\dsh-usage\usage-records.json。也可通過環境變量 DSH_USAGE_DATA_DIR 指定。記錄上限 100000 條。
插件支持 Windows、macOS、Linux，路徑處理使用 node:path，目錄選擇與「打開所在目錄」調用各系統原生方式。
安裝與啓用¶
DSH 生態遵循「一切皆插件」的思路；SkillHub（https://www.skillhub.cn）是獨立的社區插件目錄，與 DeepSeek / 幻方無官方從屬關係。
方式一：桌面端一鍵安裝（推薦）¶
安裝 DeepSeek Harness 桌面版，打開後進入 「安裝插件」→ 推薦插件 → 用量與消耗插件 → 一鍵安裝，完成後點 「立即重啓服務」。
方式二：命令行安裝¶
前提：已安裝 DSH 和 pnpm。
npm install -g @deepseek-ai/dsh
npm install -g pnpm
執行安裝命令：
dsh plugin --profile web add @feiyang666/dsh-usage-plugin
也可安裝到其他 profile，例如 headless：
dsh plugin --profile headless add @feiyang666/dsh-usage-plugin
裝完後重啓 dsh web 服務。該命令會通過 pnpm 將包安裝到 ~/.dsh/profiles/web，並根據包內的 cordis.patch.yml 自動接線，無需手動編輯配置文件。
注意：2026-08-16 起 npm 包名由
@feiyang666/deepseekharnessdesktop更名爲@feiyang666/dsh-usage-plugin。舊包名不再維護，安裝與升級請使用新包名。
典型用法¶
經過上面的安裝步驟並重啓服務後，刷新 http://127.0.0.1:3080 ，確認頂部出現「用量與消耗」和「剩餘餘額查詢」tab。
- 發一條對話消息，打開「用量與消耗」面板，查看本次調用的 token 與費用記錄。
- 在概覽頁切換日期範圍，對比不同時間段的消耗。
- 切換到「用量日曆」子頁籤，點擊某天查看明細。
- 在「剩餘餘額查詢」tab 點「查詢餘額」，確認賬戶餘額（需先配置
DEEPSEEK_API_KEY）。 - 在導出區域選擇格式（CSV / JSON / PNG），指定目錄後導出記錄。
「用量與消耗」面板內含 概覽 / 用量日曆 / 緩存命中列表 / 價格表 四個子頁籤。
卸載命令：
dsh plugin --profile web remove @feiyang666/dsh-usage-plugin
適用場景與注意¶
適合誰：
- 長期在 DSH 上跑智能體，需要追蹤 token 消耗和費用
- 使用 DeepSeek API 峯谷計費，想區分高峯與空閒時段成本
- 需要導出用量記錄做歸檔或外部分析
注意事項：
- 插件以當前 dsh 進程的權限運行，會讀寫本地數據目錄並調用 DeepSeek API 查詢餘額。安裝前應查看 GitHub 源碼 與 MIT 許可證，確認符合你的安全要求。
- 餘額查詢依賴網絡訪問
api.deepseek.com；國內網絡可能需要配置代理。 - 無官方價格的模型消耗統計爲 0，非 DeepSeek 模型的費用僅供參考，不代表實際賬單。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/feiyang-dev/dsh-usage-plugin
- GitHub 倉庫：https://github.com/feiyang-dev/dsh-usage-plugin
- npm 包：https://www.npmjs.com/package/@feiyang666/dsh-usage-plugin
dsh-usage-plugin 把每次模型調用的 token、緩存命中和峯谷費用收進一個面板，配合導出與餘額查詢，適合需要長期盯用量、控成本的 DSH 用戶。
