前言¶

在 DeepSeek Harness 中開發智能體時，除了查看 Token 總數和吞吐量外，監控 Session 的實際成本至關重要。現有的統計條缺乏直觀的成本顯示。dsh-session-cost 插件在 Session 的底部統計條（composer dock）中增加了一個成本藥丸，直接顯示基於模型目錄定價的分段成本。

插件概覽¶

名稱：dsh-session-cost
維護者：GalileoNio
類別：客戶端
許可證：MIT
依賴：Node.js >= 20
定位：一個客戶端插件，用於在 DeepSeek Harness 的 Session 統計條中顯示分段成本。

核心功能¶

1. 成本藥丸展示：在 Session 統計條中添加一個成本藥丸，顯示當前 Session 的總成本。
2. 模型目錄定價：成本基於模型目錄中的定價進行計算，涵蓋 41 個提供商和約 1495 個模型。
3. 按維度細分：點擊成本藥丸可查看按（模型，計費窗口）分組的詳細成本拆解。
4. 手動價格覆蓋：允許用戶在目錄定價之外進行手動價格覆蓋。

安裝與啓用¶

這是一個 Bundle 類型插件，安裝後會在 Harness 中註冊 Loader 條目。使用 Git 克隆到指定目錄：

git clone git@github.com:GalileoNio/dsh-cost.git "$HOME/.dsh/profiles/plugins/dsh-session-cost"

安裝完成後，可以通過 Plugins 頁面加載，或使用 plugin_manager install_bundle 配合絕對路徑進行程序化安裝。

配置與使用¶

插件配置位於 Plugins 頁面的對應卡片中。由於沒有自動生成的 Schema 表單，配置項需手動輸入。主要配置項包括：
* 價格列表：定義模型的價格。
* 計費窗口：定義價格生效的時間段。
* 符號與貨幣：設置成本顯示的符號和貨幣單位。

在 Session 交互過程中，統計條會出現成本藥丸。點擊該藥丸即可查看按（模型，計費窗口）分組的詳細成本數據。

實現細節與定價來源¶

• 計算位置：成本計算在 Host 端進行，使用 Session 的完整持久化日誌，而非僅依賴聊天窗口的分頁數據。
• 定價來源：
  • 模型目錄：默認從 Harness 自身的模型目錄（@earendil-works/pi-ai）獲取定價，支持長上下文分級定價。
  • DeepSeek 官方路由：單獨適配 DeepSeek 的官方路由，使用其發佈的定價表。
  • 手動覆蓋：目錄未覆蓋的模型或自定義折扣，可通過插件設置進行手動覆蓋。

注意事項¶

• 手動配置：當前版本沒有自動生成的配置表單，所有設置需手動輸入。
• 熱更新：插件源代碼修改後，通常只需刷新頁面即可生效，無需重啓 Harness。
• Node 版本：需確保運行環境 Node.js 版本大於等於 20。

總結¶

dsh-session-cost 爲 DeepSeek Harness 的 Session 提供了直觀的成本監控能力，通過統計條藥丸和明細麪板，幫助開發者實時掌握分段成本。對於需要精細控制成本的智能體開發場景，這是一個實用的輔助工具。

GitHub 倉庫：https://github.com/GalileoNio/dsh-cost
生態目錄：https://www.skillhub.cn/plugins/GalileoNio/dsh-cost