前言¶
在 DeepSeek Harness（DSH）裏跑多輪對話時，API 會返回 token usage，但界面默認不會把「這一輪大概花了多少錢」和「整段會話累計多少」擺在顯眼位置。自己對照官方價目表、峯谷時段和緩存命中去心算，既慢也容易和賬戶實際扣款混在一起。
DeepSeek Cost Meter（npm 包名 deepseek-cost-meter）是社區維護的 DSH 插件，在每輪迴復下方和輸入框底欄展示基於已記錄 usage 與配置價格的估算，不額外發起模型請求，也不讀取賬戶餘額。下面介紹它的定位、能力與安裝配置方式。
這是什麼¶
- 定位：Per-turn model cost estimates for DeepSeek Harness · 每輪對話費用統計插件。
- 維護者：luomuwen；源碼與說明見 GitHub，目錄頁見 SkillHub。
- 許可證：MIT；獨立社區插件，與 DeepSeek 官方無隸屬關係。
- 當前 npm 版本：0.3.0（以 package.json 爲準）。
插件沿用 dsh 的模型配置，不負責接入或切換模型；不需要 API Key。
核心功能¶
每輪費用條¶
在每輪迴復下方顯示類似 本輪模型費用約 CNY 0.012300 · 1 次調用 的摘要。點擊可展開模型、token、單價、峯谷時段及截至該輪結束時的累計費用。正常完成、錯誤和中斷的輪次都會處理。
底欄會話費用（0.3.0）¶
輸入框下方展示當前會話累計費用估算（或「已知費用約 …」「套餐用量」等狀態）。點擊打開彈窗，查看本會話累計、最近完成一輪，以及按渠道/模型彙總的金額、調用次數與已記錄 token。與 Harness 原生「會話統計」並列，不替換原有控件。生成過程中提示「本輪進行中，尚未計入」，避免把未完成請求當成實時賬單。
多渠道與套餐¶
| dsh 渠道 | 行爲概要 |
|---|---|
| DeepSeek 官方 / 賬號 | 保留峯谷價格估算 |
Kimi 國內 API moonshotai-cn |
內置 6 個模型價格；K3 緩存寫入價格不確定時顯示已知部分 |
MiniMax 國內 minimax-cn |
內置 MiniMax-M3.1-Flash；其餘模型顯示用量，可配置價格 |
| 千問 Token Plan、Kimi Coding、智譜 Coding | 展示套餐用量，不估算逐次扣費 |
| 海外 API、轉售、自定義兼容接口 | 展示已記錄用量；按 provider/model 配置價格後可估算 |
其他模型只要 dsh 保存了 usage，也能展示 token，並可單獨補充價格。沒有匹配價格不會顯示爲免費。完整標識與價格來源見倉庫內 多渠道使用說明。
計費口徑（閱讀數字前建議先看）¶
- 一輪對應
turn/start到turn/end，含會話內各步驟與已記錄的重試。 - 使用 API 持久化 usage，不用字符數估 token；輸入、緩存讀、緩存寫、輸出分桶，推理 token 含在輸出中不重複計。
- 不含子 Agent 獨立會話、標題生成、Search/Fetch、其他工具費用及賬戶優惠；與賬戶賬單不一致時屬預期——插件只做 usage × 配置價的估算。
- 金額用定點計算；多幣種分別顯示，不自動換匯。
DeepSeek 默認人民幣價表內置在插件中（覈驗日期 2026-10-29，來源爲官方 API 定價頁）；峯值爲北京時間工作日 09:00–12:00、14:00–18:00。內置表只回算 2026-10-29 00:00（北京時間）及以後的記錄。
安裝與啓用¶
需要已安裝的 DeepSeek Harness。0.3.0 已在 macOS 桌面版 DeepSeek Harness 0.2.1-rc.5 真實運行時驗證；其他版本需自行復驗。
桌面版推薦通過 npm 包名安裝：
dsh plugin --profile desktop add deepseek-cost-meter
macOS 若提示 dsh: command not found，可使用完整路徑：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add deepseek-cost-meter
Web 版將 --profile desktop 改爲 --profile web。安裝後重啓對應 Harness 應用或 Web 服務，完成一輪對話即可在回覆下方看到費用。
更新到最新 npm 版：
dsh plugin --profile desktop add deepseek-cost-meter@latest
從舊包名 @local/deepseek-cost-meter 升級時，先保存自定義 config.rates，移除舊包再安裝新包，不要同時啓用兩者：
dsh plugin --profile desktop remove @local/deepseek-cost-meter
dsh plugin --profile desktop add deepseek-cost-meter
市場展示名爲 DeepSeek Cost Meter（每輪費用）；若市場信息滯後，可直接使用上述 npm 命令。
典型用法：界面與自定義價格¶
日常使用¶
- 安裝並重啓 Harness。
- 正常對話；每輪結束後在回覆下方查看本輪估算，必要時展開明細。
- 在輸入框底欄查看會話累計，點擊彈窗按渠道/模型覈對調用次數與 token。
補充非內置渠道價格¶
在個人配置中爲插件條目添加 config.additionalRates，只覆蓋需要的 provider/model，避免改安裝包內文件（升級會被覆蓋）。修改後重啓 Harness。格式示例（數字需換成實際價）：
- id: local-deepseek-cost-meter
config:
additionalRates:
- provider: my-provider
models: [my-model]
currency: CNY
source: '填寫實際價格來源'
effectiveFrom: '2026-11-01T00:00:00+08:00'
offPeak:
input: '1'
cacheRead: '0.02'
cacheWrite: null
output: '4'
provider / models 必須與 dsh 實際記錄的標識一致。未知單價填 null；每條補充價格需 effectiveFrom。config.providerModes 可將渠道設爲 metered、subscription 或 usage-only，詳見 docs/providers.md。
適用場景與注意¶
適合：在 DSH 桌面版或 Web 版中長期調試 Agent、對比模型與渠道用量，希望在對話界面直接看到按輪與會話級費用估算的開發者。
注意：
- 插件以當前 dsh 進程權限運行；安裝前建議瀏覽源碼與 MIT 許可證，確認符合你的環境策略。
- 顯示「不完整」或無金額時，檢查該輪是否有 usage、價格是否配置、記錄時間是否在價格與日曆覆蓋範圍內；缺失數據不會按零費用處理。
- 價格配置變更會寫入 Harness 存儲域
local_turn_cost_prices的快照；卸載不刪快照，且插件不是財務賬本，丟失存儲域後只能按剩餘價格表回算。 - 卸載可在插件頁關閉，或執行
dsh plugin --profile desktop remove對應條目（具體以 Harness 插件管理爲準）。
結尾¶
DeepSeek Cost Meter 把 dsh 已記錄的 usage 轉成可讀的每輪與會話費用投影，並支持 DeepSeek 峯谷價與多渠道擴展配置，適合需要「邊聊邊看估算成本」的場景。進一步瞭解可打開 SkillHub 目錄頁 與 GitHub 倉庫。
