前言¶

在 DeepSeek Harness（DSH）裏跑多會話、多模型時，token 消耗分散在各次 llm/stream 調用裏，事後很難回答「這個月花了多少錢」「哪幾個會話最費」。官方控制檯有餘額，但和本機 Harness 會話的對應關係並不直觀。

下面介紹社區插件 dsh-usage-billing（維護者 940842546）：監聽本機所有會話的模型調用，按 DeepSeek 官方定價分段計費，並在主界面與設置頁提供圖表化用量面板。當前版本 0.6.0，MIT 許可證，GitHub 約 9 stars。

這是什麼¶

dsh-usage-billing 是針對 DeepSeek Harness 的免構建雙面插件（Host 半體 lib/index.js + Client 半體 lib/client.js）。它自動統計本機所有會話的 DeepSeek 模型調用，按北京時間歸入「調價前舊價 / 調價後高峯 / 調價後空閒」三段計費，數據持久化到寫策略根目錄下的 .dsh-usage-billing.json（v0.5.4 前爲 .dsh-usage-stats.json，升級後自動遷移）。

計費口徑以 README 爲準：2026-08-17 00:00（北京時間）前按舊價；之後按峯谷定價——高峯爲工作日 9:00–12:00、14:00–18:00（2026-08-23 起生效，此前週末同樣計高峯），空閒價爲高峯價的一半。

核心功能¶

統計與計費¶

• 全自動統計：監聽 llm/stream，記錄每次調用的輸入/輸出/緩存命中/未命中 tokens。
• 歷史回填：首次啓動掃描本機會話日誌，重建歷史用量與消費，並附會話標題。
• 分段計費：按北京時間自動歸入三段價格；模型按名稱子串歸類（含 flash 按 flash 檔，含 pro 按 pro 檔，其餘歸入「未定價/免費」）。
• 定價可配置：價格表、高峯時段、調價邊界日期、美元匯率均可編輯（改動只對後續調用生效），支持一鍵恢復默認。

界面與交互¶

• 主界面：側邊欄底部「Token 用量」卡片（當前模型 + 本會話 tokens/費用）→ 點擊彈出「Token 用量與費用統計」彈窗（¥/USD 切換、總覽、按模型/按會話表格、預算進度、官方餘額、分段佔比、用量熱力圖）；輸入框下方常駐當前會話用量一行。
• 設置頁 → 用量統計：統計卡片、預算進度、分段佔比、日/周/月/年/累計熱力圖、按會話 Top 8（可點擊打開對應會話）、按模型、最近調用、回填/清空/導出、計費與預算設置。
• 中英雙語：界面文案跟隨應用語言設置切換。

預算、餘額與導出¶

• 預算告警：跨 80%/100% 閾值時桌面 toast 提醒（每日每檔一次），進度條臨近變橙、超支變紅；設置頁展示最近告警記錄。
• 官方餘額拉取：檢測已配置的 DeepSeek API Key，拉取賬戶餘額（總餘額 / 充值 / 贈金），每 10 分鐘刷新；未配置 Key 時靜默跳過。
• 餘額續航預估：按近 7 天日均花費估算可用天數與預計耗盡日期。
• 數據導出：一鍵導出 CSV（按日 / 按會話）或 JSON，文件名含日期範圍。

動態工具與穩健性¶

• 動態工具 usage_billing：模型可直接查詢統計，支持 today / month / all 等範圍（例如「現在用了多少錢？」「今天呢？」）。
• 寫入保護：統計文件帶 temp 副本，主文件損壞時自動恢復；雙實例心跳檢測告警。

安裝與啓用¶

推薦通過 npm 一鍵安裝（預構建包）：

dsh plugin --profile web add dsh-usage-billing

npm 包地址：https://www.npmjs.com/package/dsh-usage-billing

應用啓動時通過本包的 dsh.bundle.patch（cordis.patch.yml）自動掛載，無需其他配置。安裝後若面板未顯示，需重啓應用並刷新頁面（客戶端 bundle 由 clientModules 服務發現）。

本地路徑形式同樣支持：

dsh plugin --profile web add <本倉庫路徑>

也可將倉庫根目錄 cordis.patch.yml 內容加入用戶級補丁 %USERPROFILE%\.dsh\cordis.patch.yml：

- insert:
    - id: usage-billing
      name: 'dsh-usage-billing'

注意：不要直接修改官方 bundle（如 @deepseek-ai/dsh-web-app/cordis.patch.yml），也不要把插件放進 npm-cache\_npx 緩存。

典型用法¶

查看主界面用量¶

安裝並重啓後，主界面側邊欄底部會出現「Token 用量」卡片，點擊可打開統計彈窗，在右上角切換 ¥/USD。輸入框下方會常駐顯示當前會話的 tokens 與費用。

設置頁明細與導出¶

進入 設置 → 用量統計，可查看近 30 天日趨勢、熱力圖、按會話/按模型排行，並執行回填、清空或導出 CSV/JSON。

讓模型查詢花費¶

插件註冊了動態工具 usage_billing，可在對話中直接問用量相關問題，例如查詢今天或本月累計費用（範圍參數支持 today、month、all）。

計費參考¶

價格單位爲元 / 百萬 tokens（摘自 README，完整表見倉庫）：

官方定價參考：DeepSeek API 定價

適用場景與注意¶

適合誰：需要在本機 DSH 上持續跟蹤 token 消耗與費用、做預算管控或對賬的開發者。

使用注意：

• 插件以當前 DSH 進程權限運行，安裝前應檢查 源碼 與 MIT 許可證。
• 統計文件位於寫策略根目錄（通常爲用戶主目錄），多實例同時運行會互相覆蓋寫入，請保持單實例。
• 老版本若出現統計翻倍，v0.2.0 起已通過 schemaVersion 遷移標記在重啓時自動單次重建修正。

DSH 生態遵循「一切皆插件」思路；社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

鏈接¶

• 社區目錄頁：https://www.skillhub.cn/plugins/940842546/dsh-usage-billing
• GitHub 倉庫：https://github.com/940842546/dsh-usage-billing

若你已在 Harness 上長期跑多會話任務，這個插件能把分散的 token 調用收成可讀的賬單與圖表，並在接近預算時主動提醒。