前言¶
DeepSeek Harness（DSH）會在狀態欄裏給出 token 用量、輪次、吞吐等指標，但通常不會直接回答「這次對話大概花了多少錢」。各家模型按 token 計費，輸入、輸出、緩存讀、緩存寫單價不同，部分供應商還區分峯時與谷時；聊得久了，花費很難憑直覺估算。
下面介紹社區插件 dsh-model-cost（維護者 SiskonEmilia，分類：模型推理）。它讀取本地會話日誌，按 LiteLLM Model Cost Map 把用量折算成美元，並把結果嵌進你已經在看的界面：輸入框下方狀態欄、新會話模型選擇器旁、左側欄「模型成本」頁。目錄頁：SkillHub 插件頁。
這是什麼¶
dsh-model-cost 是 DeepSeek Harness 插件，版本 0.1.0（MIT 許可證）。定位可以概括爲：本會話花了多少、當前是不是谷時、一段時間內各模型各花了多少——計價與峯谷規則來自 LiteLLM 公開價目表，計算在本地完成；只有你點擊「更新價目表」時纔會聯網拉取該 JSON。
與「只看 token 數」相比，插件補的是貨幣口徑和時段口徑：未在價目表中識別的路由可標爲「未定價」，並在價格映射裏手動指定條目。
核心功能¶
三個展示位置¶
| 在哪 | 看到什麼 |
|---|---|
| 輸入框下方的狀態欄 | 本會話累計花費，以及現在是峯時還是谷時 |
| 新會話的模型選擇器旁 | 當前模型在當前時段的單價：緩讀 · 緩寫 · 入 · 出（每百萬 token） |
| 左側欄「模型成本」 | 所有會話的統計、走勢、來源篩選與價格映射 |
本會話花費（狀態欄）¶
會話裏出現可計費調用後，花費 pill 與 22 輪 565 步 · 170 tok/s 等排在同一行。懸停看明細，點擊可釘住面板。
圖標顏色表示時段：峯時黃、谷時綠、無峯谷價時用普通文字色、未認到價目表條目時爲紅色。明細包括：當前模型路由及價目表條目、峯/谷與切換倒計時、四項單價、按本地時區畫的「今天」時間條、本會話 tokens/請求數/峯谷拆分（多模型時分模型花費）。尚無計費調用時不顯示，不佔位。
新會話價籤¶
新會話輸入框底部、模型選擇器旁，按當前時段列出緩讀 · 緩寫 · 入 · 出單價；換模型價格即時更新。發出第一條消息後價籤隱去，讓位給會話累計花費。
全局統計頁¶
左側欄進入「模型成本」。右上角「更新價目表」「刷新」。支持時間範圍（全部 / 今天 / 近 7 天 / 近 30 天）及按模型、Provider、會話、日期或峯谷分組；可按 provider 臨時剔除來源（選擇保存在瀏覽器）。概覽含總成本、tokens、請求數、緩存命中率、峯/谷佔比、未定價調用數；走勢支持花費 / Tokens / 請求切換；分組表與價格映射用於覈對路由與手動糾正「多義」「未定價」項。全局統計一次最多掃描最新 800 個會話，超出會提示截斷。
隱私與數據範圍¶
插件只讀會話日誌中的 provider、model、usage 和完成時間，不讀消息正文。緩存、價格映射、價目表落在本地 $DSH_HOME/model-cost/（默認 ~/.dsh/model-cost/）。除手動更新價目表外，插件不主動聯網。
fork 會話時，插件會跳過繼承的前綴，避免全局重複計費；面板可能顯示形如 $0.238 (+fork $1.23) 的對照說明。
安裝與啓用¶
官方 README 面向 Windows 上的 DeepSeek Harness Desktop，安裝腳本借用 Desktop 自帶的 Node 運行 dsh plugin。步驟如下。
git clone https://github.com/SiskonEmilia/dsh-model-cost
cd dsh-model-cost
pwsh -File .\install-desktop.ps1
裝完重啓 Desktop。之後若改 client.js，刷新頁面即可；若改 index.js，需重啓 Desktop，或在 Settings → Plugins 中關閉再打開 dsh-model-cost。界面中英文跟隨 DSH 語言設置。
插件以當前 DSH 進程權限運行，安裝前建議自行查閱倉庫源碼與 MIT 許可證。社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
典型用法¶
- 安裝並重啓 Desktop，在 Settings → Plugins 確認
dsh-model-cost已啓用。 - 在任意會話完成至少一次模型調用，在輸入框下方狀態欄查看本會話花費；懸停或點擊打開明細，確認峯/谷與四項單價是否合理。
- 開新會話，在模型選擇器旁查看當前時段價籤，再發消息觀察價籤讓位給會話 pill。
- 打開左側欄「模型成本」，選時間範圍與分組方式；若出現「未定價」，到「價格映射」爲對應
provider / model選擇價目表 key 並保存。 - 需要與 LiteLLM 上游單價同步時，在統計頁點擊「更新價目表」。
若裝好後新會話價籤也不見：確認插件已啓用並重啓過 Desktop；若顯示「未定價」，先發一條消息產生路由，再到價格映射裏指定條目。
適用場景與注意¶
適合誰： 長期在 DSH Desktop 上調模型、關心單次會話與階段性總花費的開發者；需要對照 LiteLLM 公開單價做估算、並處理峯谷或未映射路由的場景。
估算與賬單的差異： 插件用 LiteLLM 公開單價 × 實際用量估算，供應商賬單口徑可能不同；緩存寫入價缺失時按輸入價兜底（LiteLLM 口徑）。長上下文階梯價、批量/優先檔、圖片和音頻計費目前不參與計算。峯谷按每次調用的完成時間與價目表 off_peak_pricing 判定，時間條按瀏覽器時區繪製。
更深層的計價細節、映射配置與緩存策略見倉庫內 docs/reference.md。
結尾¶
dsh-model-cost 把 DSH 已有的用量日誌接上 LiteLLM 價目表，在狀態欄、價籤和統計頁三處給出美元估算與峯谷提示，本地計算爲主、映射可手工糾正。進一步瞭解與問題反饋：
- 目錄頁：https://www.skillhub.cn/plugins/SiskonEmilia/dsh-model-cost
- 倉庫：https://github.com/SiskonEmilia/dsh-model-cost
