前言¶
用 DeepSeek Harness 開發或調試智能體時，經常要確認 DeepSeek API 賬戶還剩多少額度。手動切到官方平臺查詢，不如在宿主側邊欄直接看方便。下面介紹一個 DSH 插件：cn-scuo-oo/dsh-deepseek-quota。它在 DSH Web 側邊欄加入 DeepSeek API 剩餘額度卡片，並提供一個充值入口。
它屬於 DSH 插件生態中的社區插件，不等同於 DeepSeek 官方應用商店內置功能；社區目錄也是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係。
這是什麼¶
cn-scuo-oo/dsh-deepseek-quota 由 cn-scuo-oo 發佈，採用 MIT License 開源。它解決的是一個具體問題：在 DSH Web 側邊欄直接查看 DeepSeek API 餘額、充值/贈送構成、期間已用和更新時間，並在卡片中進入充值面板，掃碼打開 DeepSeek 官方充值頁完成支付。
核心功能¶
下面列出的能力都圍繞「餘額展示」和「充值入口」：
- 即時餘額展示：對接 DeepSeek 官方
GET /user/balance，展示總餘額、充值/贈送構成、期間已用、更新時間。 - 自動刷新與手動刷新：每 60 秒自動刷新，也可點擊手動刷新；刷新失敗時保留舊值。
- 低餘額警示：餘額
≤ 0時主數字變紅；側邊欄收起態顯示!。 - 充值入口：卡片頭部「充值」按鈕打開居中充值面板，金額檔位/支付方式與官網一致。
- 官方支付二維碼：面板生成官方充值頁二維碼
https://platform.deepseek.com/top_up，供掃碼支付。 - 密鑰安全：API Key 只在 Host 進程內使用，瀏覽器側經同源路由取數，Key 不落瀏覽器。
- 視覺一致：複用側邊欄「設置」同源設計令牌，寬度像素級對齊。
- 寬/窄自適應：側邊欄展開顯示完整卡片；收起退化爲 32px 圓形按鈕，點擊可展開側邊欄。
安裝與啓用¶
先確認運行環境：需要 Node 18+；支持 Windows（Git Bash / WSL）、macOS、Linux。
下面命令用於安裝插件：
git clone https://github.com/cn-scuo-oo/dsh-deepseek-quota.git
cd dsh-deepseek-quota
bash install.sh
安裝後，側邊欄底部會出現「DeepSeek 額度」卡片。
配置 API Key 時，在 DSH 應用內填寫：
設置 → 模型 → 填入 DEEPSEEK_API_KEY
這個 Key 用於調用 DeepSeek 官方餘額接口。
如果沒有真實 Key，也可以用本地聯調地址：
DEEPSEEK_BASE_URL=http://127.0.0.1:8899
這個環境變量用於覆蓋官方接口地址，適合本地 Mock 或公司代理場景；無真實 Key 時插件會走本地 mock 上游。
典型用法¶
1、查看額度：側邊欄底部「DeepSeek 額度」卡片顯示 ¥餘額 大字，以及「充值 X · 贈送 Y」「更新於 HH:MM:SS」。
2、刷新：點擊卡片右上角刷新圖標立即取數。
3、充值：點擊卡片頭部「充值」按鈕，選擇金額/支付方式，點擊「去支付」展示官方充值頁二維碼，手機掃碼打開 DeepSeek 官方充值頁完成支付。
4、充值到賬後：回到側邊欄點擊刷新圖標，或等待 60 秒自動刷新。
充值面板的邊界¶
DeepSeek 沒有公開的「按訂單生成支付二維碼」API，官方充值頁也禁止內嵌。因此這個插件不代收資金，也不繞過官方計費；面板展示的是官方充值入口二維碼：
https://platform.deepseek.com/top_up
用戶在面板中選擇金額和支付方式後掃碼，打開官方充值頁完成支付。支付完成後，回到 DSH 側邊欄刷新卡片即可查看最新余額。
安全與注意¶
- 數據源：DeepSeek 官方
GET /user/balance，需要有效DEEPSEEK_API_KEY。 - Key 邊界：API Key 全程不出 Host 進程，瀏覽器側經同源路由取數，API Key 不進入瀏覽器、前端代碼或命令字符串。
- 合規邊界：只對接 DeepSeek 官方公開 API 與官方充值頁，不涉及爬蟲、繞過官方計費或代收資金邏輯。
- 安裝邊界：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。該插件基於 MIT License 開源，可自由使用、修改、商用。
鏈接¶
- 倉庫：
https://github.com/cn-scuo-oo/dsh-deepseek-quota - 目錄頁線索（未覈驗）：
https://www.skillhub.cn/plugins/cn-scuo-oo/dsh-deepseek-quota
