前言¶
在 DSH 插件生態裏，router / mode-boost 一類插件通常處理路由或模式，persona 處理人格與表達。如果只調用 DeepSeek API 而不自部署，另一個常見問題是成本：會話花了多少錢、緩存命中率如何、峯谷和錯峯怎麼配合、預算花完後是否能停止新增計費。
sixtysevenlf/dsh-cost-guard 就是面向這個場景的成本插件。它裝配在 router / mode-boost 之上，不碰 persona，只做與「錢」相關的事。
這是什麼¶
dsh-cost-guard 是一個 DSH 成本插件，倉庫名爲 sixtysevenlf/dsh-cost-guard，許可證爲 MIT。
它面向「只用 API、不自部署」場景，按 DeepSeek 官方 2026-08-17 峯谷分級（¥/百萬 token）覈算 DeepSeek V4-Flash-0731 的會話成本，並提供預算守衛、會話級收斂開關、自動成本路由、峯谷感知、錯峯隊列、客戶端面板和 dsh-optab 子包。
核心功能¶
成本覈算與緩存統計¶
插件會覈算會話成本，並統計緩存命中率、全命中可省金額與已花 ¥。
cost_status 可用於查看當前狀態。
預算守衛¶
cost_budget {budget} 用於設置預算。預算即硬上限：花到預算後，由 llm/stream 短路攔截，不再產生新計費。
這裏有一個明確邊界：正在飛行的那一次請求會走完；之後的新請求短路，不再新增費用。
預算硬頂只在項目成本守衛開啓時生效。守衛關閉時，預算只記錄、不攔截。錯峯 daemon 和無 sessionId 的一次性調用不受預算閘門影響。
會話級收斂開關¶
輸入框按鈕可作爲會話級收斂開關：點一次注入收斂引導，再點一次撤回未消費的引導並退出收斂模式。
cost_guide {target} 也可用於注入收斂引導。
這裏有一個原則：不要向 system 注入動態內容，動態信號應走消息尾，避免破壞前綴緩存。
自動成本路由¶
複雜任務可按複雜度、峯谷、預算餘量自動選擇深度、收斂或錯峯。
峯谷感知與錯峯隊列¶
cost_peak 用於查看當前峯谷狀態與錯峯建議。
cost_defer {task, maxTokens?} 用於把任務登記到錯峯隊列，空閒時段由 daemon 自動執行。
cost_deferred 用於查看隊列狀態。
客戶端面板¶
客戶端面板提供監控卡片、預算三級作用域、錯峯隊列、延期結果、項目級啓用開關與項目分組。
dsh-optab 子包¶
dsh-optab 子包提供前綴瘦身、工具輸出壓縮、推理檔位自動，並支持峯時封頂與超支收緊。
安裝與啓用¶
先安裝插件包：
dsh plugin --profile web add <tgz>
如果已有本地目錄，資料中給出的安裝方式包括：
dsh plugin --profile web add <此目錄>
熱注入場景下，可以使用：
dev_inject_plugin D:\DSH\測試\優化\dsh-cost-guard
也可以執行：
dev_install_package
插件依賴 cordis：
cordis >=4.0.0-rc <5
面板註冊依賴重啓：client-modules 按包名緩存且永不過期，插件集變化需重啓 web 生效。熱注入場景下如果面板或「收斂」按鈕未出現，需要重啓 web 一次。
如果從源碼構建 dsh-optab：
cd optab && bash scripts/build.sh
該構建需要 DSH_CHECKOUT；lib/ 爲構建產物且不入庫。
典型用法¶
下面列出資料中給出的工具與接口示例。
查看狀態並設置預算：
cost_status
cost_budget {budget}
查看峯谷並登記錯峯任務：
cost_peak
cost_defer {task, maxTokens?}
cost_deferred
注入收斂引導，或切換項目級開關：
cost_guide {target}
cost_enable {mode: on|off|auto}
面板可調用以下接口：
GET /cost-guard/api/state
POST /cost-guard/api/enable
POST /cost-guard/api/optab {enabled}
適用場景與注意¶
這個插件適合只使用 API、希望統一查看成本、緩存命中、預算和錯峯任務的人。
它與 router / mode-boost 的分工是：它們管路由和模式，dsh-cost-guard 管成本。
使用注意：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與
MIT許可證。 - 預算硬頂只在項目成本守衛開啓時生效；守衛關閉時預算只記錄、不攔截。
- 正在飛行的請求會走完，之後的新請求才會被短路。
- 錯峯 daemon 和無
sessionId的一次性調用不受預算閘門影響。 - 不要向
system注入動態內容；動態信號應走消息尾，避免破壞前綴緩存。 - 面板刪除項目或會話使用兩步確認，因爲沙箱 iframe 中
window.confirm會被靜默攔截。 v0.1.17移除了基於越權訪問dsh-client-modules私有 API 的「開機自愈」。- 插件零依賴、前綴緩存中性，宿主平面裝配，不觸碰
dsh-client-modules內部狀態。
結尾¶
dsh-cost-guard 的價值在於把成本覈算、預算硬頂、收斂引導、自動成本路由和錯峯執行放在同一套 DSH 插件裏。
GitHub 倉庫地址：
https://github.com/sixtysevenlf/dsh-cost-guard
