前言¶
使用 DeepSeek Harness（DSH）網頁界面調用 DeepSeek API 時，剩餘額度、當前對話費用和今日消費往往需要另行查看。dsh-deepseek-quota 是一個 DSH web GUI 插件，把這些信息放到頁面右下角的懸浮卡片中。下面介紹它的功能、安裝方式和典型配置。
這是什麼¶
dsh-deepseek-quota 由 yingjunnan 維護，是一個面向 DSH 網頁界面的插件，許可證爲 MIT。它在 shell.overlay 槽位註冊一個懸浮卡片，用於顯示 DeepSeek API 剩餘額度、當前對話費用與今日消費。插件需要 pnpm，通過憑證服務讀取 DEEPSEEK_API_KEY，瀏覽器只訪問本地路由。
核心功能¶
懸浮卡片顯示內容¶
卡片顯示：
- 總餘額
- 可用狀態
- 當前對話費用
- 今日已消費
- 贈送餘額
- 充值餘額
自動與手動刷新¶
- 餘額每 60 秒自動刷新
- 當前對話費用每 5 秒自動刷新
- 支持手動刷新
峯谷計價時段提示¶
插件顯示 DeepSeek 的高峯、空閒或常規峯谷計價時段提示。峯谷計價自 2026-08-17 起，高峯時段爲北京時間 09:00–12:00 與 14:00–18:00。
當前對話費用¶
當前對話費用按每條 assistant/message 以 DeepSeek 官方價格表計價，並支持 2026-08-17 起的峯谷定價。
今日消費來源¶
- 配置
DEEPSEEK_PLATFORM_TOKEN時，可獲取官方今日消費 - 未配置時，按餘額差值估算，並在界面上標註約消費
路由與錯誤狀態¶
插件註冊宿主路由：
GET /api/deepseek-balanceGET /api/deepseek-session-cost
它會提供未配置 Key、網絡失敗、接口報錯等錯誤狀態，並自動跟隨應用淺色或深色主題。
安裝與啓用¶
安裝前需要 pnpm。
已安裝 dsh CLI：
dsh plugin --profile web add dsh-deepseek-quota
未安裝 dsh CLI：
npx @deepseek-ai/dsh plugin --profile web add dsh-deepseek-quota
安裝後按下面步驟啓用：
1、重啓網頁應用：
dsh web
或使用：
npx @deepseek-ai/dsh web
2、打開 http://127.0.0.1:3080 並刷新頁面。
完成後，右下角會出現額度卡片。
也可以使用手動方式：把包放入 profile 的 node_modules，並在 ~/.dsh/profiles/web/cordis.patch.yml 添加：
- insert:
- id: deepseek-quota
name: dsh-deepseek-quota
典型用法¶
配置 DeepSeek API Key¶
在“設置 → 模型”頁面配置 DEEPSEEK_API_KEY，或寫入 ~/.dsh/.credentials.yaml：
DEEPSEEK_API_KEY: <你的 API Key>
插件通過憑證服務讀取該 Key；API Key 不出本機，瀏覽器只訪問本地路由。
查看額度與費用¶
打開 http://127.0.0.1:3080 後，右下角卡片會顯示總餘額、可用狀態、當前對話費用、今日已消費、贈送餘額與充值餘額。餘額和當前對話費用會按上述週期自動刷新，也可以手動刷新。
可選：啓用官方今日消費¶
如需讀取官方今日消費，配置 DEEPSEEK_PLATFORM_TOKEN，例如寫入 ~/.dsh/.credentials.yaml：
DEEPSEEK_PLATFORM_TOKEN: <令牌>
配置後，插件讀取 platform.deepseek.com/api/v0/usage/cost 的官方今日消費。未配置該令牌時，仍會按餘額差值估算並標註約消費。
適用場景與注意¶
適合以下使用方式：
- 在 DSH 網頁界面中使用 DeepSeek API
- 希望常駐顯示剩餘額度、當前對話費用和今日消費
- 需要查看當前峯谷計價時段
- 希望瀏覽器只訪問本地路由
注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 許可證爲 MIT。
- 需要
pnpm。 - 修改
lib/client.js後，需重啓dsh web，重新生成引導哈希並強制刷新頁面。 - 本地開發可用：
dsh plugin --profile web add .
相關鏈接¶
目錄頁：https://www.skillhub.cn/plugins/yingjunnan/dsh-deepseek-quota
