前言¶
用 DeepSeek API 驅動 DSH 時，有兩個常見的麻煩：一是查餘額要切到官網後臺，打斷手頭工作；二是估算「還夠用多久」很費勁——DeepSeek 的計價分低峯和高峯時段，緩存命中與未命中價格又差一個量級，手工換算基本不現實。
dsh-quota-meter 解決的就是這個問題。它在 DSH Web 界面的側邊欄底部直接顯示 API 剩餘額度，並按「當前模型 × 低峯/高峯計價」估算可用 token 數，還附帶每輪對話的實際花費圖。
這是什麼¶
dsh-quota-meter 是一個 DSH Web 插件，由 huolianJiao 維護，許可證爲 MIT，當前版本 0.1.0。它要求 dsh ≥ 0.1.0-rc.6，且已配置 DeepSeek API key。
一句話定位：把 DeepSeek API 的餘額、估算可用 token 和實際花費，搬進 DSH 的側邊欄。
核心功能¶
- 餘額徽章：收縮側邊欄時是帶狀態圓點的圖標；展開時顯示「餘額 · 估算 token · 時段」一行。
- 詳情面板：總餘額 / 贈送餘額 / 充值餘額、可用狀態、按模型 × 低峯/高峯的混合估算與緩存區間（0%–100% 命中邊界，當前時段高亮）。
- 實測用量：緩存命中率、輸入/輸出佔比、每輪實際花費柱狀圖。柱狀圖按每輪自己的時間戳計價，懸浮可顯示明細。
- 可視化配置：設置頁直接編輯計價表、高峯時段、回退佔比等，保存即生效，無需重啓。
- 安全：API key 只在本地 host 進程解析，絕不下發瀏覽器；餘額接口僅迴環地址可訪問。
其中「實測用量」這部分值得說明：混合估算和緩存區間給出的是「如果緩存命中率在 0% 到 100% 之間波動，餘額大概能撐多少」，而每輪花費柱狀圖基於真實請求的計費口徑（含緩存命中比例、輸入輸出 token 數），兩者對照看，對預算的把握會準很多。
安裝與啓用¶
先確認 dsh 版本 ≥ 0.1.0-rc.6，然後執行：
dsh plugin --profile web add github:huolianJiao/dsh-quota-meter
如果是從本地 checkout 安裝，用：
dsh plugin --profile web add link:./dsh-quota-meter
裝好後重啓 web profile（重新執行 dsh web），刷新頁面即可看到側邊欄底部的餘額徽章。
配置 API Key¶
插件默認讀取憑據引用 DEEPSEEK_API_KEY（可在設置頁切換）。任選其一：
環境變量：
DEEPSEEK_API_KEY=sk-...
或寫入 DSH 憑據文件 $DSH_HOME/.credentials.yaml：
DEEPSEEK_API_KEY: sk-...
插件配置¶
有兩種方式。
設置頁（推薦）：進入 Settings → 「DS API 計費 / DS API Billing」，可視化編輯計價表、高峯時段、回退佔比等。保存立即生效，不用重啓。
補丁文件（固化默認值）：在 profile 的 cordis.patch.yml 裏按 id 覆蓋配置，重啓生效：
- id: dsh-quota-meter
config:
apiKeyEnv: DEEPSEEK_API_KEY
baseURL: https://api.deepseek.com
pollIntervalMs: 60000
summaryModel: deepseek-v4-pro
peakWindows:
- { start: "09:00", end: "12:00" } # 北京時間，[start, end)
- { start: "14:00", end: "18:00" }
pricing: # 元 / 百萬 token
- model: deepseek-v4-flash
offPeak: { input: 1.5, cacheHit: 0.05, output: 4.5 }
peak: { input: 3.0, cacheHit: 0.10, output: 9.0 }
- model: deepseek-v4-pro
offPeak: { input: 4.5, cacheHit: 0.15, output: 13.5 }
peak: { input: 9.0, cacheHit: 0.30, output: 27.0 }
可覆蓋的鍵包括 apiKeyEnv、baseURL、pollIntervalMs、summaryModel、peakWindows、pricing 等。注意 peakWindows 是北京時間、左閉右開區間；pricing 的單位是元 / 百萬 token。當官方價格調整時，直接改這張表就行。
兩者的分工：設置頁適合日常調整、立即生效；補丁文件適合把團隊統一的計價表和高峯時段固化下來。
二次開發說明¶
插件零構建，改完即用：
- 改
lib/client.js（瀏覽器端）：刷新頁面即可生效； - 改
lib/index.js（host 端）：重啓 web profile 生效。
npm test # 運行 smoke 測試
package.json 中的 peerDependencies（@deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-client-runtime / dsh-client-locale / dsh-client-ui-model-selection ^0.1.0-rc.6）均標記爲 optional，不會強制拉取依賴。
適用場景與注意¶
適合這些場景：
- 長時間用 DSH + DeepSeek API 的開發者，想隨時掌握餘額，不想頻繁切官網後臺；
- 需要精確控制預算的批量任務：混合估算給出 token 數量級，每輪花費圖給出真實消耗；
- 同時使用多個模型、關心低峯/高峯差價的人：詳情面板按模型 × 時段分開展示，差價一目瞭然。
安裝前請注意兩點：
- 插件以當前 dsh 進程的權限運行。dsh-quota-meter 在安全設計上做了限制（API key 只在本地 host 進程解析、餘額接口僅迴環地址可訪問），但安裝任何第三方插件前，都應先閱讀其源碼，確認行爲符合預期。
- 插件採用 MIT 許可證，README 與
package.json均有標註。使用前確認許可證滿足你的使用場景。
結尾¶
dsh-quota-meter 做的事很剋制：把 DeepSeek API 的餘額、按模型和時段估算的可用 token、每輪實際花費，直接顯示在 DSH 側邊欄裏，並且把計價表開放成可配置項。如果你在 DSH 上重度使用 DeepSeek，這個插件能省掉不少切後臺、算差價的時間。
- 目錄頁：https://www.skillhub.cn/plugins/huolianJiao/dsh-quota-meter
- GitHub：https://github.com/huolianJiao/dsh-quota-meter
