DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在使用 DeepSeek API 進行開發或對話時，實時掌握當前模型的輸出價格以及賬戶餘額很有必要。dsh-pricing-badge 插件正是爲此設計，它將價格表和餘額信息直接嵌入到 DSH Web UI 的輸入框下方，提供直觀的監控。
核心功能¶
這是一個 DeepSeek Harness Web UI 插件，由 ZhangBo-cmd 維護（MIT 許可證）。它主要解決以下問題：
- 實時狀態指示：在輸入框下方顯示一個純文字膠囊，包含當前是“高峯”還是“空閒”時段，以及節假日原因。
- 成本監控：顯示當前會話所選模型的輸出價格，以及 DeepSeek 賬戶餘額。
- 價格速查表：點擊膠囊展開價格表，支持對比不同時段（高峯/空閒）和不同場景（緩存命中/未命中）的價格。
工作原理¶
- 純工具、純前端：插件本身不發起任何模型請求，因此不會產生額外的 token 費用。餘額讀取由服務端代取。
- 自動刷新：按北京時間實時判定高峯/空閒，每 30 秒刷新一次狀態。
- 價格來源：價格與時段規則來自 DeepSeek 官方定價頁，內置 2026 年全年法定節假日。
安裝與啓用¶
安裝命令本質是將參數轉發給 profile 目錄裏的 pnpm，因此 --profile 是必填項。對於默認的網頁界面，使用 --profile web。
- 安裝插件：
dsh plugin --profile web add dsh-pricing-badge
- 啓動 Web UI：
dsh web
- 驗證安裝：
安裝後，刷新頁面即可在輸入框下方看到指示燈。可以通過以下命令驗證配置是否生效：
dsh --profile web --dump-config
輸出中應出現以 `dsh-pricing-badge` 命名的一層配置。
自定義與維護¶
如果需要調整價格或節假日規則，可以直接編輯 lib/client.js。
- 修改價格：編輯頂部的
DEEPSEEK_MODELS（DeepSeek 分時段模型）和THIRD_PARTY_MODELS（第三方固定價模型）數組。單位爲每 100 萬 tokens。 - 節假日配置：已內置 2026 年全年法定節假日。若官方調價，更新
HOLIDAYS數組即可。
注意事項¶
- 官方定價爲準：價格數據來自 DeepSeek 官方頁面，官方可能調價，請以官方頁面爲準。
- 構建授權：如果從 GitHub 源碼安裝，需要配置 profile 的
pnpm-workspace.yaml以允許構建授權（allowBuilds）。
結語¶
dsh-pricing-badge 是一個輕量級的成本監控工具，適合需要在 DSH 中頻繁切換模型、關注高峯時段費用的用戶。它不改變 DSH 的核心邏輯，僅提供直觀的視覺反饋。
- 目錄頁：zhangbo-cmd/dsh-pricing-badge
- GitHub 倉庫：zhangbo-cmd/dsh-pricing-badge
