DSH 的上下文圓環展示的是 token 消耗，開發者真正關心的往往是費用。隨着上下文拉長，緩存前綴變貴，輪次增加導致累計開銷變大，當窗口積攢到一定厚度，每輪的輸入和輸出成本都會顯著上升。dsh-cache-billing 插件將賬單計算集成在上下文圓環彈層中，提供當前步、當前輪、會話累計三塊明細，按峯谷費率實時算賬，幫助判斷是否需要更換窗口。
插件定位¶
dsh-cache-billing 是一個 DSH 客戶端插件，由維護者 better-er 提供。它解決了“緩存命中率高但累計成本不可見”的問題，在客戶端側實時展示費用明細，支持第三方中轉的記賬邏輯，默認按 DeepSeek-V4.1-Flash 模型計價。
核心功能¶
第三方中轉支持¶
不限定 DeepSeek 官方路由，只要 Provider 不爲空即顯示。中轉的價格表與官方不同時，按模型名匹配價目表估算金額，顯示“按 DeepSeek-V4.1-Flash 計價”，確保有賬可算。
三級賬單明細¶
支持三種計時級別的統計：
1. 當前步：單次 API 調用的費用。
2. 當前輪：本輪內多步累加的費用。
3. 會話累計：整會話的累計花費，逐筆按各自事件時刻的費率累加，跨輪不比價。
賬單層級縮進清晰，分別列出緩存命中、緩存未命中（輸入/輸出）的 token 數與金額。
峯谷自動計價¶
根據北京時間自動判定費率：
* 高峯時段：工作日 09:00–12:00、14:00–18:00。
* 谷價時段：其餘時段、週六日及中國法定節假日全天。
價格配置在 src/index.ts 的 MODEL 常量中，法定節假日表位於同文件的 HOLIDAYS_2026。
單一模型與精度分級¶
- 計價模型：統一按 DeepSeek-V4.1-Flash 計價。
- 顯示精度：
- 當前步：四位小數
- 當前輪：三位小數
- 會話累計：兩位小數
- 尾零不省，精確到 0.0001 元也能識別。
安裝¶
使用以下命令安裝插件。安裝完成後插件會自動掛載，重啓 DSH web 後生效。
dsh plugin --profile web add github:better-er/dsh-cache-billing
使用方式¶
安裝完成後，打開 DSH web 界面，點擊輸入框右側的上下文圓環。在彈層底部即可查看當前的賬單明細，與“上下文用了多少”的信息同屏展示。
開發與配置說明¶
- 插件形態：標準的主機加客戶端雙半身插件。
- 記賬範圍：只認
usage中的 input、cacheRead、cacheWrite、output 四類 token。 - 源碼配置：價格、峯谷時段、模型名白名單與顯示名均寫在
src/index.ts的 MODEL 常量裏。修改配置後需執行npm run build重建。 - 節假日：法定節假日列表爲
HOLIDAYS_2026，位於src/index.ts。
生態鏈接¶
- GitHub：https://github.com/better-er/dsh-cache-billing
- 目錄頁：https://www.skillhub.cn/plugins/better-er/dsh-cache-billing
