前言¶
在 DeepSeek Harness（DSH）Web 聊天界面中發送大請求時，通常無法立即得知本次調用的大致成本。dsh-cost-estimate 插件在回答開始前，會在聊天流中插入一行內聯通知，預估輸入/輸出 token 區間和費用區間；回答結束後，同一行自動更新爲實際 usage、費用和緩存命中率。
與社區已有插件（如 dsh-session-cost）的區別在於，本插件專注於事前預估——由於輸出長度天然不可預測，它給出區間，並通過會話內歷史實際值做持續校準。
核心功能¶
- 事前預估：模型開始生成前，先顯示預估的輸入 token、輸出 token 區間和費用區間。
- 事後對賬：回答結束（拿到 provider 真實 usage）後，同一行翻轉爲實際 token 與費用，並展示緩存命中率。
- 閾值觸發：默認“預估輸入 >= 8000 token 或預估費用 >= ¥0.01”才顯示，小問題靜默，大問題必提示。
- 峯谷計價：支持 deepseek-v4-flash / v4-pro，自動根據當前時間選擇高峯/低谷檔位。
- 輸入側精度：優先錨定每次請求真實返回的 usage，中間穿插用 CJK 感知的啓發式計數兜底。
- 輸出側校準：使用滑動均值持續修正後續預估。
- 純客戶端：計算與渲染在 Web 客戶端完成，零侵入會話日誌。
- 多步支持：工具調用循環會標註並累計真實費用。
安裝與啓用¶
dsh plugin --profile web add dsh-cost-estimate
安裝後重啓 dsh web，並在瀏覽器中強制刷新（Ctrl+Shift+R）以加載新插件。
注意事項：
* 該命令依賴 pnpm（npm install -g pnpm）。
* Windows 路徑含空格時需使用 junction 或無空格路徑。
* 估算僅供參考，以 DeepSeek 實際扣費爲準。
配置¶
在 cordis.patch.yml 的 config 中支持以下鍵：
minInputTokens：默認 8000。預估輸入超過該 token 數才顯示。minCostCny：默認 0.01。預估費用超過該元數才顯示。defaultModel：默認deepseek-v4-flash。首次 usage 錨定前的模型回退值。headerTokensEstimate：默認 6000。首次 usage 錨定前，系統提示詞 + 工具 schema 的啓發式 token 數。defaultCacheHitRatio：默認 0.5。首次 usage 錨定前假定的緩存命中率。
示例配置：
- id: cost-estimate
name: dsh-cost-estimate
config:
minInputTokens: 20000
minCostCny: 0.05
效果示例¶
發送大問題後，回答前會顯示：
預估：輸入約 9.9K tok · 輸出 2.2K–7.3K tok · 費用約 ¥0.0096–¥0.0198（v4-flash）
回答結束後，同一行更新爲：
實際：輸入 9.1K tok · 輸出 1.1K tok · 費用 ¥0.02（緩存命中 87% · v4-flash）
注意事項¶
- 輸入側在錨定後精確，輸出側爲區間估計。
- 插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證。
總結¶
dsh-cost-estimate 適合需要在開發調試階段精細化控制成本、評估大模型調用開銷的開發者。它通過客戶端計算實現了對 DeepSeek API 費用的實時監控與預估。
- 插件目錄：https://www.skillhub.cn/plugins/Yvesgao/dsh-cost-estimate
- 源碼倉庫：https://github.com/Yvesgao/dsh-cost-estimate
