dsh-api-cost：DeepSeek Harness 會話與子代理的 API 成本監控插件

前言¶

DeepSeek Harness（DSH）的會話與子代理調用頻繁，開發者往往只能從 token 計數估算成本，缺乏細粒度的價格拆分和跨會話彙總。這個插件把 provider 報告的使用量摺疊到按路由計費，並在 composer 旁展示當前會話及所有子代理的實時成本，方便在對話中途覈對預算。

這是什麼¶

dsh-api-cost 是一個 DeepSeek Harness 插件包，包含 Host 插件與 Web Client 插件，由維護者 wei2yun 交付。它不作爲 skill 或 agent preset，而是 Harness 插件管理器安裝和啓用的 bundle。它通過註冊 apiCost 投影，將每條 settled 模型調用的 provider 報告用量摺疊到按路由計費桶，再由 Client 插件在 composer 的 ambient dock 渲染該值。

核心功能¶

當前會話與所有子代理的 API 成本實時彙總：Host 投影每條 settled 調用的 usage 與 provider/model 路由，Client 在 composer 旁顯示總金額與明細。
按時間範圍統計：支持 Today、Last 24h、Last 7 days、Last 30 days，彙總當前 Harness home 下所有存儲會話（跨工作區）的用量。
路由級價格拆分：按緩存命中/未命中、輸入/輸出、高峯/低谷時段，顯示各模型（如 deepseek-flash 與 deepseek-v4-pro）的用量與費用。
貨幣切換：支持使用 currency: USD 切換計價幣種。
節假日擴展：支持通過 offPeakDates 添加更多節假日，計費時段遵循 DeepSeek 公告。
舊模型兼容：deepseek-v4-flash 與 deepseek-v4-flash-vision-exp 按 Flash 價格計費。
不寫日誌：所有數據僅從 session store 讀取，不向日誌追加內容，不持久化數據。

安裝與啓用¶

安裝前請確認已安裝 DeepSeek Harness 0.2.1-rc.2 或其他 0.2.x 版本，並啓用 Web UI。

從 Web UI 安裝：

在側邊欄打開 Plugins。
選擇 Install。
輸入倉庫地址並確認：

https://github.com/wei2yun/dsh-api-cost

從 CLI 安裝：

dsh plugin --profile web add github:wei2yun/dsh-api-cost

從 agent 內安裝（需調用 plugin_manager）：

plugin_manager:
  action: install_bundle
  address: https://github.com/wei2yun/dsh-api-cost

安裝後刷新頁面，若頁面未出現控制項，可刷新瀏覽器以獲取最新 projection。

典型用法¶

在 composer 旁查看當前會話總費用與明細：點擊金額可打開面板，顯示各模型的輸入/輸出用量、緩存命中率與高峯/低谷分段價格。
切換時間範圍：點擊 Today/Last 24h/Last 7 days/Last 30 days 標籤，插件會彙總該 Harness home 下所有已存儲會話的用量。
切換幣種：在面板或控制項設置 currency: USD，按美元計價。
擴展節假日：在配置中添加 offPeakDates 以支持更多節假日（需按插件文檔格式）。
查看子代理費用：控制項會自動聚合所有子代理會話的 apiCost，未完成或未讀會話顯示 +。

適用場景與注意¶

適合需要在對話過程中實時瞭解成本分佈、按路由拆分費用、彙總多會話用量的 DSH 用戶與開發者。
插件以當前 DSH 進程權限運行，安裝前建議查看源碼與許可證（MIT）。
安裝後不改變 Harness 任何設置，僅讀取 session store 並在 Web UI 渲染。

短結尾¶

dsh-api-cost 把 DeepSeek Harness 的會話與子代理調用按路由與時段計費，並在 composer 旁提供實時彙總與明細。更多細節與源碼見：

目錄頁：https://www.skillhub.cn/plugins/wei2yun/dsh-api-cost
GitHub：https://github.com/wei2yun/dsh-api-cost