前言¶

用 DSH 跑會話時，本次對話花了多少錢、餘額還剩多少，通常要另開頁面翻賬單。DeepSeek 自 2026-08-17 起執行峯谷計費，同一模型不同時段單價不同，手動覈對成本更麻煩。

社區已有 dsh-cost-balance 做過類似的事，但原版存在槽位 id 衝突、ctx 傳遞錯誤等問題，統計條可能從未渲染出來，甚至掛掉整個前端。dsh-cost-balance-pro 在其基礎上修復了這些問題。下面介紹它的定位、功能、安裝方式，以及相對原版改了什麼。

這是什麼¶

dsh-cost-balance-pro 是一個 DSH 插件，作者爲 kingcharleslzy-ai，許可證 MIT，客戶端平臺爲 web。一句話定位：輸入框下方可見文字的會話花費/餘額統計條，帶設置頁與一鍵還原。

核心功能¶

摺疊態直接顯示 餘額（¥）· 本次花費（$），點擊展開明細面板，內容爲緩存命中 / Token / 花費 / 餘額。

峯谷計價¶

DeepSeek 自 2026-08-17 起執行峯谷計費，2026-08-23 起高峯僅限週一至週五，週末全天谷價。高峯時段爲 UTC 01:00-04:00 與 06:00-10:00（北京 09:00-12:00 / 14:00-18:00），谷價爲峯價一半。

插件按當前時段自動計價：

• 摺疊態顯示峯/谷徽標，峯爲橙色、谷爲綠色
• 展開面板顯示當前時段說明

價格自動同步（v0.2.0+）¶

1、啓動時及每 12 小時抓取官方英文定價頁。

2、自動識別新模型與價格變化（如 deepseek-v4-flash-vision-exp），無需升級插件即可跟隨官方價。

3、抓取失敗時回退到上次緩存，再回退到內置默認價。

價格優先級：用戶顯式配置 > 官方同步 > 內置默認價。同步結果緩存於 $DSH_HOME/dsh-cost-balance-pro-prices.json。

內置默認價兜底覆蓋 V4-Flash / V4-Flash-Vision / V4-Pro 的峯谷價（USD/1M）：

設置頁¶

入口在 設置 → 插件 → 餘額統計條，可調整：

• 顯示開關：餘額、花費、命中率
• 字號：10–16px
• 顏色：跟隨主題 / 灰色 / 自定義取色器
• 一鍵還原

完整字段與默認值如下：

配置持久化於 $DSH_HOME/dsh-cost-balance-pro.json，重啓保留，保存後統計條即時刷新。

安裝與啓用¶

1、運行安裝命令：

dsh plugin --profile web add dsh-cost-balance-pro

2、裝後重啓服務一次（或下次登錄）。

3、刷新頁面，即可看到輸入框下方的統計條；樣式去設置頁調整。

覆蓋價格¶

如果不想依賴官方同步，可在 profile 的 cordis.patch.yml 中按插件 id 覆蓋整行 config，傳入 prices 字段，結構如下：

{ 模型: { peak: { hit, miss, out }, offPeak: { hit, miss, out } } }

用戶配置始終優先於官方同步結果。

相對 dsh-cost-balance 修復了什麼¶

原版的問題都出在客戶端裝載鏈路上，這也是「裝了卻看不到」的常見原因：

1. 槽位註冊 id 改爲唯一 cost-balance-pro，不再與官方統計欄衝突——原版同槽同 id 同 priority 會掛掉整個前端。
2. ctx 經 props 傳入組件——原版模塊級裸 ctx 導致槽位條目渲染期 ReferenceError，藥丸從未渲染成功。
3. 摺疊態從 5px 無字細線改爲可見文字。
4. 客戶端工廠補上 return module.exports——缺失時加載器收到 undefined，插件靜默失效。
5. 客戶端模塊聲明 exports.inject = ['timer']——ctx.interval 需要 timer 注入。

開發與發佈¶

本地驗證跑客戶端契約測試：

npm test          # 客戶端契約測試（node:test）
npm pack --dry-run

發佈流程：push v* 標籤觸發 GitHub Actions，經 npm OIDC trusted publishing 自動發佈（帶 provenance）。

適用場景與注意¶

適合在 web 端使用 DSH、想即時看到會話花費與餘額、需要跟隨峯谷計價的人。如果只需要默認樣式，裝完即可用；想改字號、顏色或貨幣，去設置頁調整。

兩點注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證（本項目爲 MIT，README 與 package.json 均有標註）。
• 價格同步依賴官方英文定價頁，抓取失敗時會回退緩存與內置默認價，此時價格可能與官網存在時間差。

小結¶

dsh-cost-balance-pro 把會話花費與餘額放到了輸入框下方，峯谷計價與價格同步都自動處理，修復了原版在前端裝載上的幾個實際問題，適合想要「裝完即見」的成本可見性的 DSH 用戶。

• 插件目錄頁（社區維護的獨立站點，與 DeepSeek / 幻方無官方從屬關係）：https://www.skillhub.cn/plugins/kingcharleslzy-ai/dsh-cost-balance-pro
• GitHub 倉庫：https://github.com/kingcharleslzy-ai/dsh-cost-balance-pro