前言¶
DeepSeek Harness（DSH）是用於構建智能體的開發平臺。在開發調試過程中，實時掌握 API 調用成本有助於控制預算並優化提示詞。官方賬單通常存在延遲，且無法在開發階段提供細粒度的成本反饋。下面介紹 dsh-api-cost 插件，它通過本地會話日誌實時計算並顯示成本。
這是什麼¶
dsh-api-cost 是 DeepSeek Harness 的一個客戶端插件，由開發者 CCCq-C 維護，採用 MIT 許可證。它通過本地會話投影計算 API 用量成本，無需修改宿主倉庫即可獨立運行。
核心功能¶
該插件主要提供以下能力：
- 實時成本顯示：在瀏覽器輸入欄上方顯示一個“成本芯片”，實時更新當前的 API 消耗。
- 會話投影：基於會話日誌的
apiCost投影，計算並展示每條樣本的成本。 - 可配置費率：支持按美元/百萬 tokens（USD/M tokens）配置費率表，並支持針對特定模型覆蓋默認費率。
- 雙語 UI：界面支持中文/英文切換，跟隨宿主語言設置。
- 獨立插件：作爲獨立的插件包，通過
cordis.patch.yml注入，不侵入宿主代碼。
安裝與啓用¶
使用官方 CLI 安裝：
dsh plugin --profile web add dsh-api-cost
安裝完成後，重啓 dsh web 服務，加載器會自動應用插件包內的配置。之後在任意會話中發送消息，輸入欄上方就會出現成本芯片。
典型用法¶
啓用插件後，發送消息即可在輸入欄上方看到類似 API cost $0.0023 1.2K + 3.4K tok 的實時顯示，其中包含總成本、輸入 Token 和輸出 Token 的數量。
如果需要調整費率或貨幣，需編輯配置文件 $DSH_HOME/profiles/web/cordis.patch.yml，在 api-cost 行中添加 config 字段。配置結構通常包含貨幣類型、默認費率以及針對特定模型的覆蓋配置。
適用場景與注意¶
該插件適合需要在開發階段即時監控成本的 DSH 用戶。
在使用時需要注意以下幾點：
- 估算值差異：成本是基於本地會話日誌的估算值，可能與 DeepSeek 官方賬單存在差異。這可能源於官方側的緩存策略、價格變動或模型重命名。
- 模型切換計費：如果在會話中切換模型，後續的使用樣本將按切換後的模型費率計費。
- 子代理獨立顯示：子代理擁有獨立的會話 ID，其成本不會聚合顯示在父會話的成本芯片中。
結尾¶
dsh-api-cost 爲 DSH 開發者提供了一個輕量級的成本監控手段。通過本地計算和靈活的配置，能夠有效輔助開發過程中的成本控制。更多詳情可參考插件目錄或 GitHub 倉庫。
