前言¶
在使用 DSH Web 進行開發時，開發者通常能直觀地看到 Token 的消耗與用時，但往往缺乏對“具體花費”的量化。官方界面未提供按官方價格計算的計費入口。dsh-turn-cost 旨在解決這一問題，它通過在 DSH 原生 UI 中追加計價 Pill，展示基於 DeepSeek 官方 API 價格的每輪與累計花費。
插件簡介¶
這是一個適用於 DSH Web 的計價插件，由 Quimos-M 維護，遵循 MIT 協議。它不修改 DSH 官方源碼，而是通過公共接縫在界面中追加計算邏輯。核心價值在於將 Token 消耗實時轉化爲可感知的金額，並支持按輪次、按會話、按代理維度的明細查看。
核心功能¶
- 每輪與會話累計花費：在會話統計行和每輪動作行中顯示花費 Pill。會話累計爲各輪累加值，每輪花費爲該輪所有請求的總和。
- 分項金額統計：點擊花費 Pill 可查看明細。明細包含緩存命中輸入、緩存未命中輸入、輸出三部分的 Token 數與對應金額。
- 子代理聚合計價：支持將子代理的花費聚合到父會話中。彈窗支持分頁查看，第 1 頁爲總計，後續頁面分別展示主 Agent 和各子代理的明細。
- 動態價格與模型信息：計價依據當前請求時刻的模型價格，自動區分峯谷時段，並顯示當前模型信息。
安裝與啓用¶
使用 DSH 提供的插件命令進行安裝。確保你的 DSH 版本在兼容範圍內（見下方兼容性說明）。
dsh plugin --profile web add link:~/dsh-plugins/dsh-turn-cost
安裝完成後，重啓 DSH Web 服務，插件會自動裝配。
使用方法¶
- 查看概覽：在會話列表中，輸入框下方的統計行會顯示“會話累計花費”。
- 查看單輪：在對話流中，每輪迴答的動作行尾部會顯示“每輪花費”。
- 查看明細：點擊任意花費 Pill（例如
花費 1.23 CNY），會彈出分項明細窗口。 - 分頁操作：使用
←→或點擊‹›翻頁。第 1 頁爲該輪/該會話的總計，第 2 頁爲主 Agent，後續頁面爲各子代理。若沒有子代理，則無翻頁控件。
計價邏輯與邊界¶
本插件顯示的花費是基於 DSH 接口獲取的 Token 消耗，並乘以 DeepSeek 官方 API 價格計算得出的估算值。
- 計價精度：金額以微元整數累加，顯示保留四位小數。
- 峯谷定價：支持按模型家族與生效時間版本化，自動區分高峯與空閒時段（高峯爲平日 09:00-12:00、14:00-18:00，爲谷價的 2 倍）。
- 包含範圍：包含常規模型請求的計價。
- 不包含範圍：
- 不包含標題生成、聯網搜索等旁路調用費用。
- 不包含非官方 Provider（如經適配器接入的第三方模型）的計價，除非在配置中放開。
- 準確性聲明：此數值僅爲估算，實際價格以 DeepSeek 官方文檔和賬單爲準。
兼容性與注意事項¶
- DSH 版本：兼容 DSH
0.1.5-rc.1至0.2.0-rc.2。 - 共存性：插件僅使用公共接縫，不替換或隱藏原生元素，與其他插件共存時不會產生 DOM 衝突。
- 卸載：從 profile 的
bundles與dependencies移除dsh-turn-cost並重啓即可完全移除。
dsh-turn-cost 插件爲 DSH 開發者提供了一個透明、可視化的成本監控方案。你可以通過 GitHub 倉庫 獲取源碼與更多設計細節。
