在 DeepSeek Harness（DSH）中，會話的消耗、委託鏈路的成本歸屬以及高峯時段的定價策略，是開發者和管理員需要明確的關鍵信息。dsh-api-cost 旨在爲 DSH 提供精確的成本估算能力，支持區分高峯與低谷費率，並將委託或團隊花費歸因到觸發該花費的具體會話中。
這是一個 DeepSeek 成本估算插件，支持高峯/低谷費率、委託或團隊花費歸因，以及基於宿主會話預測的摺疊計算。由 NIRVANA-APOC 維護，屬於 admin-security 類別，開源協議爲 MIT。
核心功能¶
- 費率區分：支持區分高峯和低谷時段的費率。
- 花費歸因：將委託或團隊花費歸因到引發該花費的會話。
- 會話預測：基於宿主的會話預測數據進行計算。
- 可視化組件：提供 Composer Pill 和成本面板。
- 高峯規避：提供“避開高峯”開關，可掛起請求至低谷時段。
- 命令行工具：提供
/cost命令和session_cost工具。 - 數據讀取：支持通過 HTTP 讀取。
安裝與啓用¶
使用官方安裝命令即可將插件添加到 web 配置文件中：
dsh plugin --profile web add dsh-api-cost
安裝後需要重啓 DSH，因爲客戶端組件需要重新組合才能生效。
典型用法¶
1. 查看成本概覽¶
在界面中，插件提供了兩種展示方式：
- Composer Pill：顯示當前會話的估算花費和生效時段（高峯/低谷）。點擊 Pill 可打開詳細麪板。
- 成本面板：點擊 Pill（或按回車）後，會彈出包含以下內容的面板：
- 總金額、本次會話與其他會話的分攤
- 高峯與低谷的分攤
- 定價調用次數、覆蓋率
- 當前費率
- 下一個時段變更的倒計時
- 避開高峯 開關
2. 命令行查詢¶
使用 /cost 命令可以在終端打印與 Pill 相同的摘要，包括覆蓋率警告：
/cost [sessionId] [auto|self|tree|team]
使用 session_cost 工具，允許助手讀取某個會話的估算值，默認爲調用會話。
3. 作用域說明¶
命令和麪板支持以下作用域：
auto（默認）：驗證會話所屬團隊，否則使用委託樹。self：僅當前會話。tree：當前會話及其所有持久化子代理。team：整個團隊（需要驗證成員關係）。
適用場景與注意¶
該插件要求 DeepSeek Harness 版本爲 0.2.0-rc.2，並掛載 sessionProjections、sessionProjectionCache 和 sessionQuery 能力（web 和 desktop 配置文件默認包含這些）。
對於開發環境，源碼構建需要 Node.js 24 或更高版本；發佈的包自帶預編譯 JavaScript，無需本地編譯。
重要限制：“避開高峯”開關依賴 LLM 服務。如果沒有 LLM 服務，該開關無法掛起請求。此外，Token 桶和按模型的詳細拆分數據僅通過 /cost、session_cost 和 HTTP 讀取提供，不在面板中展示。
總結¶
dsh-api-cost 爲 DSH 提供了從會話到團隊層面的精細化成本管理能力。通過直觀的 Pill 和麪板，結合命令行工具，可以清晰地追蹤花費歸屬與時段費率。更多細節與源碼，可參考下方的目錄頁或 GitHub 倉庫。
