前言¶
在 DeepSeek Harness 裏跑對話和子代理時，token 會隨每次模型調用累加，但界面默認不會把「今天花了多少」「當前會話花了多少」擺在眼前。要對照官方價目自己心算，或等平臺賬單，既慢也不利於調 prompt 和控成本。
下面介紹社區插件 dsh-api-cost-meter（維護者 mzqmzqmzqmzq）：在輸入框下方加一行常駐讀數，按會話日誌裏的 usage 推算人民幣費用，並通過 SSE 在每次調用結束後推送更新。插件歸類爲 admin-security，源碼與說明見 GitHub，社區目錄頁：https://www.skillhub.cn/plugins/mzqmzqmzqmzq/dsh-api-cost-meter。
這是什麼¶
dsh-api-cost-meter 是面向 DSH Web 界面（dsh web）的只讀計量插件：展示今日（本機時區當天 00:00 起、含子代理會話的合計）與本窗口（當前會話從第一條消息起的合計，切換會話即切換）兩檔 API 調用費用。金額由 Host 根據 assistant/message 上的 token 用量與內置價目結算，不向外網發送對話內容。
界面與交互¶
安裝成功後，輸入框下方會出現類似讀數：
今日 ¥0.5488 · 本窗口 ¥0.1372
點擊讀數會在其上方彈出明細麪板（position: fixed，不改變對話區佈局），列出分模型的費用、調用次數，以及輸入 / 緩存命中 / 輸出 token。點面板外、按 Esc 或再次點擊讀數可關閉。
模型調用進行中（llm/stream 在途）時，讀數左側會有呼吸小圓點表示「正在生成」——此時金額尚未計入，需等該次調用返回 usage 後才結算。金額變化以約 420ms 緩動滾動，避免硬跳。
實時更新機制¶
Host 在每次模型調用結束時通過 SSE 推送一幀，前端路徑爲 /plugin/cost-meter/stream，不做高頻輪詢。SSE 不可用時自動退回 1.5 秒輪詢；單次快照可用 GET /plugin/cost-meter/state?sessionId=<SessionId>。
費用如何計算¶
每次模型調用在會話日誌中留下 assistant/message，其 usage 含 inputTokens、cacheReadTokens、cacheWriteTokens、outputTokens。插件按 README 記載的官方價目（人民幣 / 百萬 tokens）逐條累加：
| 模型 | 緩存命中輸入 | 緩存未命中輸入 | 輸出 |
|---|---|---|---|
deepseek-flash |
空閒 0.02 / 高峯 0.04 | 空閒 1 / 高峯 2 | 空閒 4 / 高峯 8 |
deepseek-v4-pro |
空閒 0.15 / 高峯 0.30 | 空閒 4.5 / 高峯 9 | 空閒 13.5 / 高峯 27 |
高峯時段爲北京時間週一至週五 09:00–12:00、14:00–18:00；其餘爲空閒時段（價格爲高峯的一半）。法定節假日未內置日曆，按高峯計價。deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-chat、deepseek-reasoner 按 deepseek-flash 計價。價目來源見 DeepSeek 官方定價文檔（README 標註 2026-11 抓取）；調價後需更新 index.js 頂部 PRICES。
未收錄的模型仍統計 token 與調用次數，費用記 0，讀數旁會以「未配置價格」提示模型名。
數據從哪來¶
- 實時：Host 訂閱
session/event，僅對assistant/message做 O(1) 累加。 - 歷史：加載時通過
sessionPersistence從磁盤日誌回填當天用量（最多最近 200 個會話，自日誌尾部回讀）；重啓不會清零當天已計費用。session/created時也會補讀舊會話。
實時與回填用各自 seq 下界去重，避免重複計費。
安裝與啓用¶
要求 DSH Web 界面；插件無第三方運行時依賴。安裝命令如下：
dsh plugin add dsh-api-cost-meter
或在 Harness Web UI 的 設置 → 插件 → 添加 中粘貼包名 dsh-api-cost-meter。裝好後輸入框下方應出現讀數；若沒有，刷新頁面一次。
隱私與 Host 路由¶
插件只讀本地會話日誌。Host 僅註冊兩條只讀本機路由，均只接受 GET；sec-fetch-site 非 same-origin 時返回 403。響應僅含費用與 token 統計，不含對話正文。
適用場景與注意¶
適合長期在本地或內網用 DSH 開發智能體、需要即時感知 token 成本、又不想把會話內容發到第三方的開發者。
務必知曉：
- 插件以當前 dsh 進程權限運行；安裝前請自行查看源碼與 MIT 許可證。
- 金額是按 token 用量推算的費用，不等於 DeepSeek 平臺賬單；實際扣費以平臺賬單爲準。
- 僅覆蓋
deepseek-flash與deepseek-v4-pro兩檔官方價目；其他模型顯示 token 但不計價。
DeepSeek Harness 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
經過上面的步驟，你可以在對話輸入框旁持續看到今日與本窗口的 API 費用，並在需要時展開分模型明細。進一步細節見 GitHub README 與 SkillHub 目錄頁。
