前言¶
在 DSH 中使用 DeepSeek 時，賬戶餘額、價格檔位和本會話花費通常分散在外部頁面或日誌裏。峯谷計價生效後，同一模型的成本會隨北京時間變化，開發者需要在調用前判斷當前是否處於 peak 或 off-peak。下面介紹 dsh-balance-tide，它把賬戶餘額、峯谷計價潮汐提示和本會話估算花費放進 DSH Web 插件中。
這是什麼¶
dsh-balance-tide 是由 huanyuLv 維護的 DSH Web 插件，定位爲：DeepSeek Harness (DSH) Web plugin: account balance + peak/off-peak pricing tide indicator。
它主要解決三件事：
- 查看當前賬戶餘額。
- 判斷當前價格檔位以及距離下一次峯谷切換的時間。
- 按當前計價週期估算本會話花費。
當前版本爲 0.4.0，許可證爲 MIT。
核心功能¶
- 顯示
standard/peak/off-peak價格檔位徽章，按北京時間即時判斷。 - 顯示距下一次峯谷切換的倒計時，並每秒刷新。
- 從官方
/user/balance端點讀取賬戶餘額，區分granted與topped-up。 - 按當前計價週期估算本會話花費，複用
sessionProjections；同一turn/step樣本替換而非重複計算。 - 懸停時顯示當前與下一週期完整價格表、峯谷價差（
peak = off-peak × 2）、峯谷時間窗和使用建議。 - 提供
?圖標，打開官方定價頁。 - 零配置場景下複用 DSH 憑證中的
DEEPSEEK_API_KEY，倉庫中不存放密鑰。 - 支持中文 / English 界面語言。
峯谷計價規則¶
根據已覈實信息：
- 峯谷計價自
2026-08-17 00:00生效；之前爲當前平價。 - 北京時間
09:00–12:00與14:00–18:00爲peak。 - 其餘時間爲
off-peak。 off-peak爲peak的一半。
安裝與啓用¶
安裝前需要 pnpm 環境。下面按 npm、Git URL、本地目錄三種方式安裝。
npm：
dsh plugin --profile web add dsh-balance-tide
Git URL：
dsh plugin --profile web add https://github.com/huanyuLv/dsh-balance-tide
本地目錄：
dsh plugin --profile web add file:/path/to/dsh-balance-tide
安裝後重啓 dsh web 生效。
配置¶
插件配置放在：
$DSH_HOME/profiles/web/cordis.patch.yml
可配置項包括：
refreshIntervalMs
clientPollIntervalMs
currency
allowedHosts
如果官方價格或日程變化，也可以用配置覆蓋：
tideCutoff
peakWindows
tidePrices
安全與限制¶
安全方面：
- 優先使用 DSH 憑證中的
DEEPSEEK_API_KEY。 apiKey配置項僅爲逃生通道，避免明文寫入配置。baseUrl必須爲https，明文http會被拒絕。/query-tide會檢查讀取方：Host必須爲localhost、IP 字面量或allowedHosts中註冊的域名。- 攜帶
Origin的請求必須同源。 - 被拒絕的讀取返回
403。 - 服務器僅向瀏覽器發送少量錯誤碼，原始異常文本進入日誌，自定義
baseUrl不泄露到前端。
限制方面：
- 成本爲按當前計價週期估算，官方賬單爲準。
- 多幣種賬戶的讀出行只顯示第一個幣種，其餘幣種顯示在
tooltip中。 deepseek-chat/deepseek-reasoner未再列於官方定價頁，靜態價格僅爲fallback，不是已驗證報價。
適用場景與注意¶
適合：
- 使用 DSH web profile 的開發者。
- 需要在 Web 界面中查看餘額、峯谷計價和本會話估算花費的場景。
- Node.js
20/22/24環境。
兼容：
- DeepSeek Harness
0.1.0-rc.6+（web profile）。 - 純 JavaScript + 標準瀏覽器 CSS，無原生模塊。
注意：插件以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證；本項目許可證爲 MIT。
結尾¶
dsh-balance-tide 提供賬戶餘額、峯谷計價潮汐提示和本會話花費估算，適合放在 DSH Web 日常使用。項目地址：https://github.com/huanyuLv/dsh-balance-tide
