dsh-plugin-subs：DeepSeek Harness 订阅接入插件

前言¶

DeepSeek Harness (DSH) 采取“一切皆插件”的架构。开发者在使用消费级订阅（如 Claude Pro、ChatGPT Plus 或 Grok）时，通常需要手动处理 API 密钥或复杂的认证流程。dsh-plugin-subs 插件通过 OAuth 流程，直接将现有的消费者订阅接入为本地 LLM 提供商，省去了手动生成 API Key 的步骤。

插件介绍¶

dsh-plugin-subs 是一个由 randomix777 维护的插件，属于模型推理类别，许可证为 MIT。它主要解决的问题是：如何在不直接申请开发者 API Key 的情况下，利用现有的消费级订阅服务在 DSH 中进行模型推理。

核心功能¶

OAuth 登录：支持通过 OAuth 授权直接登录订阅提供商，无需手动配置 API Key。
模型解析：直接从订阅中解析 Composer 可用的模型列表。
功能支持：支持流式输出、工具调用（Tool Calling）和图像输入（视提供商支持情况而定）。
状态监控：在 Subscriptions 设置板块中展示使用状态。
目录管理：内置各提供商的模型目录，且支持在配置中覆盖。

安装与启用¶

安装该插件无需编译步骤，直接使用官方命令：

dsh plugin --profile web add dsh-plugin-subs

安装后，插件将自动注册到 DSH 的插件系统中。

典型用法¶

启动 DSH：运行 dsh web，并在终端中打开打印出的 URL。
进入设置：在 Web 界面导航至 Settings → Subscriptions。
连接提供商：点击目标服务（如 Claude、Codex、Grok 等）旁的 Connect 按钮。
完成认证：
- 在浏览器标签页中完成 OAuth 授权流程。
- 在无头（Headless）环境下，需手动粘贴回调 URL 或授权码。
- 注意：Agnes AI 需要手动粘贴回调 URL（DSH 不支持 agnes:// 协议）。
选择模型：在任何聊天界面，打开模型选择器（/model），从已登录的提供商列表中选择模型。

适用场景与注意事项¶

适用场景¶

该插件适合希望直接利用现有消费级订阅（如 ChatGPT Plus、Claude Pro、Grok 等）进行模型调用的 DSH 用户，特别是希望减少 API Key 管理复杂度的场景。

注意事项¶

可见性：未登录的提供商在模型选择器中不会显示卡片。
订阅依赖：提供商的可用性取决于你的订阅状态。
图像生成：需要 Codex 或 Grok 的活跃会话支持。
工具限制：x_search（搜索）工具需要 Grok 登录及 API 可用的订阅层级。
OpenRouter：其 API Key 是永久有效的（无刷新机制），更换 Key 需要登出后重新登录。
中文提供商配置：
- iFlytek Spark 和 Baidu ERNIE 需要在各自平台注册 OAuth 应用，并配置环境变量（SPARK_CLIENT_ID、SPARK_CLIENT_SECRET 等）。
Qwen Code 流程：使用设备流（Device Flow）认证，需在验证 URL 输入用户码，该流程可取消且会过期。

短结尾¶

dsh-plugin-subs 实现了消费级订阅到 LLM 提供商的无缝对接，简化了配置流程。更多技术细节和源码可参考 GitHub 仓库。