DeepSeek Harness 採用插件化架構，允許通過插件擴展功能。dsh-meter 是一個專注於會話級別的成本監控與計費插件，它在每個會話右上角展示當前會話的 token 用量與費用，並提供價格配置功能，解決了在長時間對話或開發過程中難以量化成本的問題。
核心功能¶
會話頭部入口
每個會話右上角有一個常駐的費用徽標，顯示當前會話的費用及高峯/空閒狀態。若會話使用的模型未配置價格，徽標會顯示琥珀色的“未登記價格”標籤。徽標旁會顯示狀態標籤：當前處於高峯顯示紅色“高峯”，否則顯示灰色“空閒”。判定按 provider 時區進行（默認北京時區）。
統計卡片
鼠標懸停或點擊徽標可展開統計卡片。卡片展示了當前會話的詳細用量：緩存命中與未命中的 token 數、緩存寫入情況、輸出 token 數。費用按幣種並列顯示。卡片還包含上下文佔用條與壓縮預測，以及每輪新增的迷你圖（展示 token 佔用變化）。卡片底部會列出派生的子代理及其費用，狀態點（實心綠點、旋轉環、中性點）複用官方 StateDot 組件，反映子代理的運行狀態。
逐輪消耗詳情面板
提供“按輪次”（工具調用 step 合併）和“按請求”兩種視圖。視圖切換會改變圖表與表格的粒度。費用柱狀圖與四段 token 堆疊圖展示了每輪的消耗。明細表按輪次倒序排列，支持摺疊。
設置與計價邏輯
通過 GUI 設置頁（插件配置頁）可編輯價格表。支持分段計價（按請求長度）和高峯時段感知（可配置多個高峯窗口及生效星期）。內置法定節假日日曆，命中當天則不觸發高峯價。計價核心支持按請求時刻歸屬時段、按請求長度取檔、以及緩存未命中/命中/寫入分開計價。
安裝與啓用¶
源碼目錄安裝（推薦）
當前源碼線（0.3.3x）尚未發佈到 npm，建議使用源碼目錄方式安裝：
npx @deepseek-ai/dsh plugin --profile web add ./dsh-meter
包安裝
npm 上的 dsh-meter 停留在 0.3.18 版本。運行 0.2.x 及更新宿主時，安裝前的 peer 校驗會直接拒絕安裝。僅在 0.1.7 線（0.1.7-rc.2 ~ 0.1.7.x）的宿主上，npm 上的 0.3.18 才能安裝：
npx @deepseek-ai/dsh plugin --profile web add dsh-meter@0.3.18
安裝完成後，重啓 GUI 或 host 即可生效。
配置定價¶
通過配置文件定價
也可以使用配置文件維護價格表，Agent 可據此直接生成配置。默認路徑爲 $DSH_HOME/dsh-meter/prices.yaml（未設 DSH_HOME 則在 ~/.dsh/dsh-meter/prices.yaml）。
# 校驗價格配置
node scripts/check-prices.mjs
# 或指定文件
node scripts/check-prices.mjs my-prices.yaml
單位爲元/百萬 tokens。優先級爲：顯式配置 > 價格文件 > 內置默認。
遷移與維護¶
插件是獨立包，遷移到另一臺機器時，只需將 dsh-meter/ 目錄（不帶 node_modules/）或 .tgz 文件拷貝過去，重新運行安裝命令即可。
遷移後務必重新安裝一次，以確保 profile 配置正確更新。價格以整數（1/100000 單位）存儲，無浮點誤差。
注意事項¶
- 版本兼容性：npm 上的
dsh-meter停留在 0.3.18，peer 區間爲^0.1.0-rc.7。運行 0.2.x 及更新宿主時，peer 校驗會拒絕安裝。 - 許可證：未在資料中找到明確的許可證信息。
- 精度：價格存儲爲高精度整數，顯示時保留兩位小數。
