前言¶
在 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 适合希望利用个人订阅额度进行本地智能体开发的用户。它通过多账户池和自动化轮换降低了维护成本，同时通过加密存储和内存服务保证了安全性。
