DeepSeek Harness（DSH）採用「一切皆插件」的架構。在進行智能體開發或模型調用時，開發者往往需要實時監控 Token 消耗、費用計算以及錢包餘額。如果不借助額外工具，這些信息往往散落在日誌或控制台中，難以直觀查看。下面介紹一款專爲 DSH 打造的插件，用於解決上述痛點。
該插件名爲 dsh-usage-meter-harness，由開發者 faith1688 維護。它是一個標準的 DSH Cordis 插件，能夠爲 DeepSeek Harness 提供實時的用量、費用與餘額計量功能。
功能概覽¶
插件提供以下核心能力：
- 實時監控：在聊天輸入框旁直接顯示 Token 數量、花費金額與真實餘額。
- Token 細分：支持輸入、緩存命中、緩存寫入、輸出四個維度的 Token 細分。
- 回合與速度：提供回合使用面板，展示單輪用量與單位價格（高峯/低谷）；支持實時 Token 速度監控。
- 緩存統計：提供會話的緩存命中率統計。
- 錢包與預算：展示真實 DeepSeek 錢包餘額（其他提供商可使用本地記賬估算），並支持預算與剩餘額度追蹤。
- 計費引擎：
- 提供 6 種計費模板（基礎、緩存命中/未命中、峯谷、緩存寫入+命中、輸入+輸出、批量半價）。
- 支持自定義價格行（最多 4 行）。
- 峯谷計費基於北京時間工作日及小時窗口，支持跨午夜計費。
- 支持按模型定價、共享錢包。
- 內置 137 個模型（19 個廠商）的價格表。
- 自動匯率轉換（USD -> CNY）。
- 支持同步官方價格（需提供官方 API Key）。
- 設置與體驗：
- 雙語 UI（中文/英文）。
- 提供 20+ 內置主題。
- 生成時鎖定價格，確保一致性。
- 所見即所得的彈出窗口。
安裝與啓用¶
安裝前需確保已安裝 DSH CLI。安裝方式取決於你是否使用 pnpm。
前置條件（方法 1 和 2 需要 pnpm）¶
DSH CLI 本身運行在 pnpm 上，若使用方法 1 或 2，需先安裝 pnpm：
npm install -g pnpm
# 或
corepack enable
安裝方法¶
方法 1：通過 DSH CLI 使用 npm 倉庫（需要 pnpm）
dsh plugin --profile web add --verbose @faith1688/dsh-usage-meter-harness@latest
方法 2：通過 DSH CLI 使用 GitHub 倉庫（需要 pnpm）
dsh plugin --profile web add --verbose github:faith1688/dsh-usage-meter-harness#main
方法 3：一行命令安裝（推薦，不依賴 pnpm）
此方法直接使用 npm，無需配置 pnpm 協調：
npx -y @faith1688/dsh-usage-meter-harness@latest
安裝完成後，必須重啓 dsh web 以應用更改：
dsh web
使用與更新¶
安裝成功後，在聊天界面即可看到實時用量面板。若需更新插件：
- 全新安裝或使用 npx 方法：直接再次運行上述安裝命令即可。
- 使用 pnpm 更新：在配置目錄下運行：
pnpm update @faith1688/dsh-usage-meter-harness
- 強制更新：如果 pnpm 報告版本未更新（由於新版本發佈後的 24 小時冷卻期），或綁定方式爲
file:路徑，請直接使用npx命令：
npx -y @faith1688/dsh-usage-meter-harness@latest
該命令具有冪等性，會自動升級配置。
注意事項：
* 安裝程序不會修改 profile 根目錄的 cordis.patch.yml，因此你手動添加的其他插件配置不會被覆蓋。
* 如果在 pnpm 環境下更新遇到“已滿足”提示，請使用 npx 命令強制拉取最新版本。
適用場景¶
該插件適用於所有使用 DeepSeek Harness 進行模型調用的開發者，特別是需要精細控制成本、監控緩存命中率以及需要多模型共享錢包的場景。
總結¶
dsh-usage-meter-harness 爲 DSH 提供了一套完整的成本控制與用量監控方案。通過實時面板、峯谷計費及官方價格同步，開發者可以更直觀地管理資源消耗。
