前言¶
在 DeepSeek Harness (DSH) 的開發場景中，直接調用第三方大模型的付費 API 往往會產生較高的成本。dsh-subscriptions 插件提供了一種替代方案，它允許通過 OAuth 協議將個人訂閱服務（如 ChatGPT Plus、Claude Pro 等）接入 DSH，作爲本地 LLM 提供商使用。該插件解決了多賬戶管理、限流處理以及憑證安全存儲的問題。
這是什麼¶
該插件由 GooDAnDReaREADY 維護，是一個模型推理類插件。它通過標準 OAuth PKCE 協議，將 16 個主流 AI 訂閱服務封裝爲 DSH 的第一級 LLM 提供商。插件內置了多賬戶池、自動輪換機制和零泄漏憑證安全方案，支持無頭環境下的登錄。
核心功能¶
1. 支持的內置供應商¶
插件內置了 16 個供應商的適配層，支持通過訂閱而非 API Key 進行認證：
- ChatGPT Codex
- Claude
- Grok
- Antigravity
- Kimi
- GLM
- Cursor
- Kiro
- Copilot
- Qwen
- ERNIE
- Spark
- JetBrains
- Perplexity
- Replit
- Cody
2. 多賬戶池與限流處理¶
插件支持爲同一供應商配置多個賬戶。當遇到 429 限流或配額耗盡時，系統會自動在賬戶池中切換到健康的賬戶繼續請求。此外，它還支持基於剩餘配額的主動切換，以及根據上游返回的 Retry-After 等信息進行的動態冷卻計算。
3. 零泄漏憑證安全¶
OAuth 令牌不會在 HTTP 響應或 Web UI 中泄露。所有憑證均加密存儲於 $DSH_HOME/.credentials.yaml 中，由 DSH 的憑證服務統一管理。UI 僅顯示賬戶標籤、連接狀態和配額條。
4. 無頭與遠程登錄支持¶
針對無瀏覽器環境，插件提供了兩種登錄方式：
- Loopback 回調：自動啓動本地 HTTP 服務器接收回調（默認開啓），無需手動粘貼 URL。
- 設備碼登錄：支持 Codex 等服務的設備碼流程，可在無界面服務器上完成授權。
5. Cordis 服務集成¶
插件作爲 Cordis 服務運行，提供 ctx.subscriptions 接口。其他 DSH 插件（如圖像生成插件）可以直接在內存中調用此服務，避免額外的 HTTP 循環和 token 泄漏風險。
依賴與注意事項¶
- 運行環境：需要 Node.js 20 及以上版本。
- 依賴項：插件依賴於
@deepseek-ai/cordis、@deepseek-ai/dsh-credentials等核心庫。 - 權限：插件以當前 DSH 進程權限運行，憑證存儲在用戶目錄下。
典型用法¶
在 DSH 的其他插件中，可以通過 ctx.subscriptions 調用訂閱接口：
const res = await ctx.subscriptions.request('codex', '/backend-api/codex/images/generations', {
method: 'POST',
body: JSON.stringify({ prompt: 'Cyberpunk landscape', size: '1024x1024' }),
})
總結¶
dsh-subscriptions 適合希望利用個人訂閱額度進行本地智能體開發的用戶。它通過多賬戶池和自動化輪換降低了維護成本，同時通過加密存儲和內存服務保證了安全性。
