前言¶
在 DeepSeek Harness（DSH）Web GUI 中，一次會話往往包含多輪迴復、緩存讀寫和輸出 token。如果價格後來發生調整，直接用當前價格重算曆史，會讓同一條會話的成本不斷變化。
DSH Cost Meter 針對這個問題提供成本追蹤能力：以價格快照錨定的按輪次計價、賬戶餘額展示，以及流式過程中的成本估算。
這是什麼¶
DSH Cost Meter 是一個面向 DSH Web GUI 的成本追蹤插件，npm 包名爲 @gamegeek-saikel/dsh-cost-meter，GitHub 倉庫爲 https://github.com/Saikel-Orado-Liu/dsh-cost-meter，許可證爲 MIT。
它解決的問題可以概括爲：讓每一輪已完成回覆的成本錨定到該次用量事件發生時的價格快照，後續價格變化不會改寫已經寫入的會話行。
核心功能¶
下面是已覈實的插件能力：
- 按輪次成本：提供 snapshot-anchored per-turn cost，即基於價格快照錨定的每輪成本。
- 賬戶餘額：通過
GET /user/balance獲取餘額，並緩存 60 秒，限制爲單飛行請求。 - 成本視圖頁籤：提供 cost view tab，用於查看成本信息。
- 逐條消息成本標識：提供 per-message cost chips，在消息處展示成本。
- 頭部即時估算：提供 header pill with live streaming estimates；流式估算使用當前價格，步驟完成後由精確錨定值替換。
- 峯谷計價：支持 peak/off-peak aware pricing。
- 子代理成本彙總：支持 subagent cost aggregation。
- 價格簿快照：使用 append-only pricebook snapshots，避免後續價格變化重新計算已完成用量。
- 界面語言：提供 Simplified Chinese and English interface。
安裝與啓用¶
安裝前確認 DSH 版本在插件聲明範圍內：
DSH >=0.1.1-rc.1 <0.2.0
宿主機側要求 Node：
Node ^22.19.0 || >=24.0.0
開發環境使用：
pnpm@11.7.0
使用官方 DSH CLI 將插件安裝到 web profile：
npx @deepseek-ai/dsh plugin --profile web add @gamegeek-saikel/dsh-cost-meter
安裝完成後啓動 DSH Web GUI：
npx @deepseek-ai/dsh web
典型用法¶
安裝後，插件會在 DSH Web GUI 中提供以下已覈實的界面與行爲：
1、Composer dock readout
顯示 anchored session spend 和 account balance，並每分鐘刷新。
2、Cost view tab
展示整段會話總計、分類總計、子代理列表，以及每輪迴復的 anchored ledger。
3、Per-message cost chips
在逐條消息上展示成本信息。
4、Header pill
流式過程中顯示 anchored total 或 live estimate；點擊進入詳情面板。
如果需要手動刷新，可調用：
POST /cost-meter
請求體爲：
{"action":"refresh"}
注意 /cost-meter 路由只回應 loopback 或 declared trusted host 請求，因此只應在本地或明確聲明的可信主機環境中使用。
適用場景與注意¶
DSH Cost Meter 適合需要在 DSH Web GUI 中查看會話成本、賬戶餘額和子代理成本彙總的使用者。對於希望歷史成本不被後續價格變化重寫的場景，它的價格快照錨定機制尤其有用。
安裝前建議檢查源碼、許可證與依賴範圍。插件運行在 DSH 進程中，會繼承當前 dsh 進程的權限；因此只從可信來源安裝，並確認 MIT 許可證與代碼行爲符合預期。
結尾¶
DSH Cost Meter 的價值在於把“現在看到的成本”和“當時計費的成本”分開：流式階段給出當前價格估算，步驟結算後錨定到價格快照，餘額和成本視圖在 DSH Web GUI 內集中展示。
GitHub 倉庫：https://github.com/Saikel-Orado-Liu/dsh-cost-meter
npm 包名：@gamegeek-saikel/dsh-cost-meter
