前言¶

在 DSH 裏使用 DeepSeek 時，需要隨時確認當前會話已經產生多少花費，但不想手動查價格、手動乘單價，也不希望費用展示插件額外發起外部請求。

dsh-cost 是一個 DSH 原生插件：按 DeepSeek 峯谷價格表即時計算當前對話花費，並把金額徽標顯示在輸入框旁。

這是什麼¶

dsh-cost 由 kami-mura 維護，用於 DSH Web 端會話。它根據 DSH 內置 deepseek-official provider 上報的 token usage，把當前對話花費折算成 CNY 或 USD，並常駐顯示在輸入框旁。

許可證爲 MIT。

核心功能¶

• 輸入框旁常駐金額徽標，token 用量變化時自動更新。
• 貨幣可在 DSH 設置 > 插件 > Plugin configuration 中選擇 CNY 或 USD，默認 CNY，選擇保存在當前瀏覽器。
• 懸浮提示語言跟隨 DSH 系統語言：中文 / English。
• 懸停費用圖標後可查看輸入 tokens、輸出 tokens、flash 花費、pro 花費。
• 展示費用四捨五入保留兩位小數；不足 0.01 時顯示爲 <0.01。
• 按 DeepSeek 官方人民幣與美元價格表、北京時間峯谷時段計價。
• 分開計算緩存命中、緩存未命中、緩存寫入與輸出。
• 同一 turn/step 的 usage 按投影替換規則去重。
• 未識別第三方模型不猜價，顯示 ≈/¥0+ 或 ≈/$0+。
• Host 端 durable 會話投影 costLog 計算，翻頁、上下文壓縮、歷史補拉不改變累計值。
• 瀏覽器端只讀投影並渲染，不發外部請求。
• 樣式使用 DSH WebUI 設計令牌，明暗主題自動跟隨。

安裝與啓用¶

先添加插件：

dsh plugin --profile web add github:kami-mura/dsh-cost

安裝後需重啓 dsh web 服務生效。

卸載時使用：

dsh plugin --profile web remove dsh-cost-log

典型用法¶

1、打開任意會話，輸入框右側會出現費用徽標。

2、懸停費用徽標，查看輸入 tokens、輸出 tokens、flash 花費、pro 花費。

3、點擊費用徽標，查看 flash / pro 花費明細。

4、切換貨幣：打開 DSH 設置 > 插件 > Plugin configuration，選擇 CNY 或 USD。

5、如需運行測試：

node --test tests/*.test.mjs

計價口徑與限制¶

• 只給 DSH 內置 deepseek-official provider 的完整模型 ID deepseek-v4-flash 與 deepseek-v4-pro 計價。
• 未識別的第三方模型不猜價，顯示 ≈/¥0+ 或 ≈/$0+。
• 分開計算緩存命中、緩存未命中、緩存寫入與輸出。
• 同一 turn/step 的 usage 按投影替換規則去重，避免同一用量被重複計入。
• 金額是依據 provider 上報 token usage 的參考估算，不是 DeepSeek 官方賬單。

架構與隱私¶

• Host 端通過 durable 會話投影 costLog 計算累計花費；翻頁、上下文壓縮、歷史補拉不會改變累計值。
• 瀏覽器端只讀投影並渲染，不發外部請求。
• 不讀取 API Key、不查詢賬戶餘額、不發送外部請求。
• 不需要數據庫、代理或額外常駐服務。
• 依賴 DSH 運行時能力：Host sessionProjections；Client slots、locale、react 平臺模塊與 ui-conversation 的 conversation.input.right 插槽。

適用場景與注意¶

適合需要在 DSH Web 會話中持續查看 DeepSeek 對話花費的人，尤其是使用 deepseek-v4-flash 與 deepseek-v4-pro 的場景。

安裝前應檢查源碼與 MIT 許可證。插件以當前 dsh 進程權限運行，建議僅安裝來自可信來源的版本。

1.0.0 起進入穩定維護：不再增加功能，只在 DeepSeek 官方價格變化或 DSH 接口變化時更新。

鏈接¶

GitHub 倉庫：https://github.com/kami-mura/dsh-cost