dsh-plugin-subscriptions 是什么？免 API 密钥使用订阅制 LLM

dsh-plugin-subscriptions 是 DeepSeek Harness（DSH）的订阅制 LLM 提供方插件：把 ChatGPT（Codex）、Claude、Grok（X Premium）和 GitHub Copilot 的订阅直接当作模型来源，免去申请和管理 API 密钥的麻烦。 本文基于官方 README，介绍它是做什么的、核心功能、安装启用、典型用法与常见排错。

dsh-plugin-subscriptions 是什么？

dsh-plugin-subscriptions 解决「每个模型服务都要单独申请 API 密钥」的痛点：把你已经付费的订阅账号变成 DSH 的模型来源，用 OAuth 登录或导入现有凭据即可。 以下定位与事实来自官方 README（来源）：

dsh-plugin-subscriptions（GitHub 仓库 V1ki/dsh-plugin-subscriptions）由 v1ki 维护，用 TypeScript 开发，MIT 协议开源，是 DSH Plugin 生态中的工具类插件（kind 为 tool，npm 包名 dsh-plugin-subscriptions）。它支持四类订阅：ChatGPT（Codex）、Claude、Grok（X Premium）和 GitHub Copilot。登录后，这些订阅模型的实时目录会出现在 DSH Web UI 的会话模型选择器中，同时提供订阅用量监控，以及额外的搜索和图像生成工具（来源）。

dsh-plugin-subscriptions 的核心功能有哪些？

dsh-plugin-subscriptions 的核心能力围绕「订阅账号接入 + 实时模型目录 + 用量与附加工具」展开：登录一次，订阅即成为可用的模型来源。 功能事实来自官方 README 与详情页（来源）：

• 订阅登录：在 Web UI 的 Settings → Subscriptions 中，通过 OAuth 登录 Codex、Grok 和 Copilot；Claude 则自动导入现有 Claude Code 凭据（macOS Keychain 或 ~/.claude/.credentials.json），无需安装 Claude Code CLI。
• 实时模型目录：登录后，会话模型选择器显示各提供方的实时模型列表（如 Codex 来自 chatgpt.com/backend-api/codex/models，Grok 来自 api.x.ai/v1/models），并随登录/登出自动刷新。
• 推理强度与速度控制：支持推理级别的模型（如 Codex、Grok 4.6/4.5）提供 Effort 选择器；Codex 模型支持 Standard/Fast 速度切换（service_tier: priority），也可用 /fast 命令设置。
• 订阅用量监控：登录卡片显示各提供方的用量百分比、进度条与重置时间（Codex 来自 wham/usage，Claude 来自 api.anthropic.com/api/oauth/usage，Grok 来自 cli-chat-proxy.grok.com/v1/billing）；Copilot 无用量端点则不显示。
• 附加工具：启用对应提供方后，自动注册 x_search（Grok 的 X 搜索，返回答案与引用）、image_generate（经 Codex 后端生成 gpt-image-2 图像）和 video_generate（内联播放视频）等工具。

怎么安装与启用 dsh-plugin-subscriptions？

dsh-plugin-subscriptions 通过 DSH Plugin 标准命令安装，装完重启 Web 客户端，进入 Settings → Subscriptions 登录订阅账号即可使用。 安装过程与 DSH 其他插件一致，官方 README 提供了标准命令（来源）：

1. 确认环境与目标 profile。 dsh-plugin-subscriptions 是 DSH 工具类插件，安装到运行 Web UI 的 profile。下面的示例以 web 为 profile 名，换成你自己的 profile 名即可。

2. 执行官方安装命令。 在 DSH 环境里运行以下命令安装：

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

也可以从 GitHub 源码安装：

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

3. 重启 Web 客户端。 安装完成后重启 Web，让插件加载生效。之后在 Web UI 左侧或设置中找到 Subscriptions 入口。

4. 校验并管理插件。 查看已安装插件确认 dsh-plugin-subscriptions 在列：

dsh plugin list

更新插件时使用 update：

dsh plugin update dsh-plugin-subscriptions

移除时使用 remove：

dsh plugin remove dsh-plugin-subscriptions

关于该插件的增删与更新，都通过 DSH Plugin 标准的 add/update/remove 命令完成，不需要手动改配置文件。

dsh-plugin-subscriptions 典型用法

装上并登录订阅账号后，日常使用就是「选模型、调强度、看用量」：订阅即模型，登录一次持续可用。 以下用法基于官方 README 与详情页（来源）：

1. 逐个登录订阅提供方。 进入 Web UI 的 Settings → Subscriptions，为每个提供方点击登录：Codex 和 Grok 走 OAuth 流程，Claude 优先导入现有 Claude Code 凭据（否则回退浏览器 OAuth），Copilot 使用设备码流程——在 github.com/login/device 输入显示的代码完成授权。

2. 在模型选择器中选择订阅模型。 登录后，会话模型选择器会列出已登录提供方的实时模型，选择即可开始对话；登录或登出时列表自动刷新，无需手动配置模型名。

3. 调整推理强度与速度。 对支持推理级别的模型（如 Codex、Grok 4.6/4.5），在模型选择器旁的 Effort 控件中选择推理强度；对 Codex 模型用 Speed 控件切换 Standard/Fast（service_tier: priority），或在对话中输入 /fast 直接切换：

/fast

4. 使用用量监控与附加工具。 在 Subscriptions 登录卡片上查看各提供方的用量百分比、进度条与重置时间；启用对应提供方后，可调用 x_search、image_generate、video_generate 等工具完成搜索与图像生成任务，例如在对话中直接描述图片需求：

生成一张关于 DSH 工作流的封面图

dsh-plugin-subscriptions 常见问题与排错

dsh-plugin-subscriptions 的常见问题集中在「登录后不显示」「凭据导入」和「/fast 档位」三类，多数情况按下面的步骤即可解决。 排错要点来自官方 FAQ（来源）：

1. 症状：登录后模型选择器看不到某些提供方。 解决：只有已登录的提供方才会出现在选择器中，列表在登录或登出时刷新。请确认该提供方已在 Settings → Subscriptions 中成功登录；若仍不显示，重新登录或刷新页面。

2. 症状：Claude 登录时提示找不到凭据。 解决：Claude 会从 macOS Keychain 或 ~/.claude/.credentials.json 导入现有 Claude Code 凭据，无需安装 Claude Code CLI；若找不到会自动回退到浏览器 OAuth。确认凭据文件存在且格式正确，或直接用 OAuth 登录。

3. 症状：/fast 命令报错说当前模型没有 fast 档位。 解决：/fast 仅对目录中声明支持 fast 档位的 Codex 模型有效，否则会报错并说明原因。请切换到支持 fast 的 Codex 模型，或在模型选择器旁的 Speed 控件中切换 Standard/Fast。

适用场景与注意

dsh-plugin-subscriptions 适合已有 ChatGPT、Claude、Grok 或 Copilot 订阅、想在 DSH 里免 API 密钥使用这些模型的重度用户，但它依赖第三方订阅账号的可用性与登录态。 以下几点来自官方 README（来源）：

• 适合：已付费 ChatGPT Plus/Pro、Claude Pro/Max、X Premium、GitHub Copilot 的用户；不想为每个服务单独申请 API 密钥的团队；需要用量可视化的日常重度使用者。
• 不适合：没有上述订阅、仍希望按量计费的场景；无法访问各订阅服务登录页的网络环境；对凭据存放路径有严格管控要求的组织。
• 注意：令牌保存在 ~/.dsh/plugins/subscriptions/auth.json（权限 0600）并自动刷新；Copilot 无公开用量端点，卡片不显示用量属正常；使用第三方订阅账号需遵守相应服务条款。

项目链接

dsh-plugin-subscriptions 是 v1ki 维护的 MIT 开源项目。 插件详情页：dsh-plugin-subscriptions 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：V1ki/dsh-plugin-subscriptions。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。