前言¶

在 DeepSeek Harness（DSH）里跑智能体，模型提供方往往是绕不过去的一环。很多人手里已经有 ChatGPT Plus/Pro、Claude Pro/Max 或 X Premium 订阅，却还要单独申请各家 API Key，按量计费、额度管理、密钥轮换，一套流程走下来并不轻松。更麻烦的是，不同平台模型命名、计费方式和调用协议各不相同，想在同一个 Harness 会话里灵活切换，配置成本偏高。

社区插件 dsh-plugin-subscriptions（维护者 V1ki）走另一条路：把现有订阅账号通过 OAuth 登录接入 DSH，在 Web 界面完成授权后，即可在模型选择器里直接选用对应订阅下的模型，无需再填 API Key。该插件在 SkillHub 插件库 分类为「模型推理」，GitHub 约 251 stars（目录页数据，2026-08-25 核实），MIT 许可证。

需要说明的是：SkillHub 等社区目录由爱好者维护，与 DeepSeek / 幻方并无官方从属关系；DSH 本身秉持「一切皆插件」的理念，这类插件属于社区生态能力扩展。

这是什么¶

dsh-plugin-subscriptions 是一个 DSH 的 LLM Provider 插件。它把 ChatGPT（Codex）、Claude、Grok（X Premium），以及 GitHub Copilot 订阅，桥接为 DSH 可调用的模型后端。

核心思路很直接：

• OAuth 网页登录：Codex、Grok 在 DSH Web 界面「设置 → 订阅」里点连接，浏览器完成授权；Claude 若本机已有 Claude Code 会话凭据（macOS Keychain 或 ~/.claude/.credentials.json），可自动导入，否则同样走浏览器 OAuth。
• Token 本地存储：凭据保存在 ~/.dsh/plugins/subscriptions/auth.json（文件权限 0600），过期自动刷新。
• 实时模型目录：已登录的 Provider 会出现在会话模型选择器（/model）中，模型列表从各平台接口实时拉取（Claude 为插件内置静态目录并随版本更新）。

一句话概括：有订阅就能用，登录一次，在 DSH 里像选普通模型一样切换各家能力。

核心功能与亮点¶

支持的 Provider¶

只有已登录的 Provider 才会出现在模型选择器；支持视觉的模型会声明 text + image 输入模态，图片内容自动转换为各平台协议格式。

界面与推理能力¶

• 订阅用量展示：Codex、Claude、Grok 卡片可查看各限额窗口的已用比例、进度条与重置时间（Copilot 暂无用量接口）。
• 推理等级（Effort）：对声明了 reasoning levels 的模型（如 Codex、Grok 4.6/4.5、Copilot 推理模型），模型菜单内可直接选择推理档位。
• Codex 速度切换：支持 fast tier 的 Codex 模型可在输入框旁切换 Standard / Fast（service_tier: priority），也可用 /fast 斜杠命令。
• HTTP(S) 代理：在「设置 → 订阅 → 代理」中配置，订阅相关请求（含 OAuth 换票、模型流式调用、工具调用）可走代理；OAuth 授权页本身仍走浏览器系统代理。

附赠工具（随 Provider 启用）¶

• x_search（Grok）：调用 xAI 托管的 X 搜索，返回答案与引用。
• image_generate（ChatGPT 或 Grok）：分别经 Codex 后端或 xAI 图像接口生图，结果内联显示在对话中，文件保存在 ~/.dsh/plugins/subscriptions/images/。
• video_generate（Grok）：异步生成短视频，内联播放，保存在 ~/.dsh/plugins/subscriptions/videos/。

安装与启用¶

本机需已安装 dsh CLI。推荐从 npm 安装预构建产物（无需构建授权）：

dsh plugin --profile web add dsh-plugin-subscriptions

也可从 GitHub 安装源码：

dsh plugin --profile web add github:V1ki/dsh-plugin-subscriptions

首次通过 Git 安装时，pnpm 可能要求允许构建脚本。按提示在 profile 的 pnpm-workspace.yaml 中加入：

allowBuilds:
  dsh-plugin-subscriptions: true

然后重新执行 add。仅对信任的包授予该权限——安装阶段会执行包内代码。

本地检出开发安装：

git clone https://github.com/V1ki/dsh-plugin-subscriptions.git
cd dsh-plugin-subscriptions && pnpm install && pnpm build
dsh plugin --profile web add ./dsh-plugin-subscriptions

安装完成后重启 dsh web 以加载插件。

更新 npm 版：

dsh plugin --profile web update --latest dsh-plugin-subscriptions

GitHub 版重新执行 add github:V1ki/dsh-plugin-subscriptions 即可。

典型用法¶

1. 登录订阅账号¶

dsh web

在浏览器打开打印的地址，进入 设置 → 订阅，对目标 Provider 点击「连接」并完成 OAuth。无图形界面的 headless 环境可展开手动兜底，粘贴回调 URL 或授权码。

2. 在会话中切换模型¶

在任意会话输入 /model，在 ChatGPT (Codex)、Claude (Subscription)、Grok (Subscription) 或 Copilot 分组下选择模型即可开始对话。

未登录时，该 Provider 不会出现在选择器中；若强行请求会返回 MISSING_CREDENTIAL 并提示前往设置页，不影响其他功能。

3. 按需裁剪 Provider（可选）¶

在插件配置中可指定启用的 Provider 子集，例如只开 Codex 与 Claude：

- id: llm-subscriptions
  name: dsh-plugin-subscriptions
  config:
    providers: [codex, claude]
    streamIdleTimeoutMs: 300000

也可通过 models 字段覆盖或补充模型目录（详见仓库 README）。

4. Headless 场景（进阶）¶

若不在 profile 中安装插件，可先在 Web 界面完成登录（token 文件共享），再使用 overlay 方式挂载本地构建产物运行 headless 任务——具体见仓库 overlay.example.yml 说明。

适用场景与注意事项¶

适合谁用：

• 已有 ChatGPT / Claude / Grok / Copilot 订阅，希望在 DSH 智能体工作流中直接复用，而不想维护多套 API Key。
• 需要在同一 Harness 会话里按任务切换不同厂商模型（例如 Codex 写代码、Claude 做长文推理、Grok 搜 X）。
• 希望利用插件附带的生图、生视频、X 搜索等工具能力。

使用前请注意：

1. 服务条款与合规：插件通过 OAuth 使用订阅账号访问各平台接口，请遵守 ChatGPT、Anthropic、xAI、GitHub 等平台的服务条款；勿用于违反订阅协议的场景。
2. 插件权限：DSH 插件以当前 dsh 进程权限运行，可读写本机文件、发起网络请求。安装前建议阅读 GitHub 源码 与 MIT 许可证，确认来源可信。
3. 凭据安全：Token 存于 ~/.dsh/plugins/subscriptions/，代理密码存于同目录 proxy.json，注意本机账户与文件权限安全。
4. 平台差异：各 Provider 的模型列表、限额、推理档位随订阅计划与上游接口变化；Copilot 登录为设备码流程，与浏览器 OAuth 略有不同。
5. 社区目录非官方商店：插件信息以 SkillHub 目录页 与 GitHub 仓库为准，版本与星标会随社区同步更新。

小结¶

dsh-plugin-subscriptions 把「已有订阅」和「DSH 智能体」之间的缝隙填上了：OAuth 登录、免 API Key、多 Provider 统一接入，还附带搜索与生图/生视频工具。若你正在 SkillHub 或 GitHub 上挑选模型推理类插件，值得一试。

• 目录页：https://www.skillhub.cn/plugins/V1ki/dsh-plugin-subscriptions
• GitHub：https://github.com/V1ki/dsh-plugin-subscriptions