前言¶
在 DeepSeek Harness（DSH）這類強調“一切皆插件”的 Web 運行環境裏，多模型調用後常見的問題是：各模型消耗了多少 tokens、哪部分命中了緩存、費用大約多少、DeepSeek 賬戶還剩下多少餘額。model-usage-plugin 是一個 DSH Web 插件，用於統計各模型 tokens 消耗並估算費用，同時顯示 API 賬戶餘額。它把 token 明細、費用估算和餘額查看放到設置面板中，適合需要在 DSH 裏覈對模型調用成本的使用者。
這是什麼¶
model-usage-plugin 是 DSH Web 插件，倉庫地址爲 https://github.com/AKS1st/model-usage-plugin，許可證爲 MIT。它解決的核心問題是：按模型查看 tokens 消耗、估算費用，並在頁面中展示 DeepSeek 賬戶餘額。
核心功能¶
下面按能力拆開看。
按模型統計 tokens 與調用¶
- 按模型統計 tokens，區分緩存命中 / 未命中 / 寫入。
- 統計調用次數與失敗次數。
- 基於價格估算費用。
默認價格與自定義價格¶
- 內置主流模型默認價格：國產模型按人民幣，海外模型按美元。
- 首次使用自動套用默認價格，之後可隨時修改。
- 每個模型卡片可以點“配置價格”修改單價與計價貨幣，也可以點“重置”恢復默認價。
峯谷定價¶
每個模型可勾選“峯谷定價”，最多支持兩個高峯時段（HH:MM，支持跨零點）。兩個高峯時段共用同一組高峯價；高峯期 token 按高峯價計費，非高峯期按正常價計費。如果高峯價留空，則沿用正常價。
DeepSeek 默認價按官方最新峯谷計費更新：
deepseek-v4-flash/deepseek-v4-pro預置官方 2026-08-17 定價，包括空閒價與高峯價、兩個高峯時段09:00–12:00/14:00–18:00，時段按服務器本地時間。deepseek-chat/deepseek-reasoner爲官方最新價。- 已知 DeepSeek 模型若仍停留在舊默認價或峯谷時段爲空，啓動時會自動升級爲官方默認配置；已配置有效高峯時段的用戶自定義價格不受影響。
匯率與餘額¶
- 費用統一按目標貨幣展示，默認人民幣。
- 匯率成功獲取後連同時間戳緩存到數據文件。
- 無緩存時啓動自動刷新一次。
- 打開設置頁時，如果緩存不超過一週，不自動刷新，需手動點擊“更新匯率”；無緩存或超過一週則自動刷新一次。
- 查詢 DeepSeek 賬戶餘額，並在頁面頂部大字展示總 Token 與賬戶餘額。
展示控制¶
設置面板提供“模型消耗”頁籤。勾選“僅顯示已調用模型”後，只展示實際使用過的模型，未使用過的模型會被隱藏。
安裝與啓用¶
該插件通過 dsh plugin（pnpm 轉發）安裝到 profile，並自動登記爲 bundle 層。倉庫說明標註爲純 JS，零構建，即裝即用。
從 GitHub 倉庫安裝¶
執行下面命令安裝，並重啓 web 服務使 profile 生效：
dsh plugin --profile web add github:AKS1st/model-usage-plugin
dsh web # 重啓 web 服務使 profile 生效
本地安裝¶
先 clone 倉庫，再指向倉庫目錄安裝：
git clone https://github.com/AKS1st/model-usage-plugin.git
dsh plugin --profile web add /path/to/model-usage-plugin
dsh web
卸載¶
執行下面命令移除插件：
dsh plugin --profile web remove model-usage-plugin
典型用法¶
經過上面的步驟後，可按下面方式使用：
- 打開 設置 → 模型消耗。頂部會顯示總 Token、賬戶餘額、目標貨幣與匯率狀態。
- 查看每個模型卡片中的 token 明細與費用。
- 點“配置價格”修改單價與計價貨幣、啓用峯谷定價，並設置高峯時段與高峯價。
- 需要恢復默認價時，點“重置”。
- 勾選“僅顯示已調用模型”，頁面只顯示實際使用過的模型。
數據、權限與注意¶
- 統計、價格與匯率緩存（含時間戳）保存在
$DSH_HOME/musage-stats.json。 - 頁面填寫的餘額 API Key 僅保存在內存，不會寫入磁盤；需要持久化時，請配置
DEEPSEEK_API_KEY環境變量或憑證。 - 插件以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證；該倉庫許可證爲 MIT。
- DSH 插件生態強調“一切皆插件”，該插件以獨立倉庫形式提供，使用時按倉庫說明和許可證判斷。
結尾¶
model-usage-plugin 適合需要在 DSH Web 中查看模型 tokens 消耗、緩存明細、費用估算和 DeepSeek 賬戶餘額的場景。它把常用成本信息集中到設置面板，方便按模型覈對調用情況。倉庫地址：https://github.com/AKS1st/model-usage-plugin。
