前言¶

如果你已经有 Cursor 订阅，同时又想在 DeepSeek Harness（DSH）里跑智能体任务，通常有两条路：去 Cursor 侧申请 API Key，或者切回 Cursor IDE / Cursor CLI 操作。前者多一套密钥要管理，后者打断了 DSH 里已有的工作流。

dsh-cursor-subscription 解决的就是这个问题：在 DSH 中通过浏览器 PKCE 登录 Cursor 账户，直接使用 Cursor 订阅，不需要 API Key，也不依赖 Cursor IDE 或 Cursor CLI。下面介绍它的功能、安装方法和使用方式。

这是什么¶

dsh-cursor-subscription 是一个 DSH 插件，由 orrinzeng 维护，许可证为 MIT。在 DSH「一切皆插件」的体系下，它把 Cursor 订阅模型接入模型选择器，登录后即可选用；对话中的工具调用通过 DSH 本地工具执行。

需要先说明它的性质：插件对接的是 Cursor 未公开的 Agent 协议（agent.v1.AgentService/Run），属于社区逆向工程项目，Cursor 更改服务端实现后可能失效。项目与 Anysphere 或 Cursor 无关联且未获其认可，使用需遵守 Cursor 的服务条款。

核心功能¶

• 登录与凭据：通过浏览器 PKCE 登录在 DSH 中直接使用 Cursor 订阅，无需 API Key；凭据存储在 DSH 本地凭据库，并自动刷新访问令牌。
• 模型发现：通过 Cursor 的 GetUsableModels 动态发现当前账户可用模型，发现失败时使用内置回退模型列表。
• 对话与工具：流式对话输出推理内容，支持 DSH 工具调用；工具请求转换为本地 DSH 工具执行，不使用 Cursor 的文件系统工具。
• 用量查看：设置页可查看并手动刷新订阅用量，包括请求数、Auto + Composer 用量、其他模型（API）用量、按模型花费、按需花费和计费周期；也可查看并手动刷新当前账户可用模型，以及登录状态和令牌过期时间。
• 运行时配置：可配置单次运行的工具轮次上限，以及 HTTP 重试次数、间隔和状态码。

安装与启用¶

用 dsh 命令安装：

dsh plugin --profile web add dsh-cursor-subscription

安装后做校验：

dsh plugin --profile web list dsh-cursor-subscription --depth 0
dsh --profile web --dump-config

已安装的包列表中应恰好包含一个 dsh-cursor-subscription，组合配置中应恰好包含一个 cursor-subscription 条目。

如果 DSH 正在运行，安装完成后需手动重启。

本地开发可以直接从本地路径安装。在 profile 目录（如 %USERPROFILE%\.dsh\profiles\web）执行：

pnpm add file:D:/mcp/dsh-cursor-subscription

然后把 dsh-cursor-subscription 加入 package.json 的 dsh.profile.bundles 数组，再重启 DSH。

如果习惯用智能体管理插件，也可以把仓库中的 AGENTS.md 链接发给 Agent，按其中说明完成安装、更新、卸载与验证。

登录与使用¶

1、打开 DSH 的 Settings -> Cursor Subscription。
2、选择 Browser Sign-in，浏览器会打开 Cursor 登录页。
3、在浏览器中完成登录授权，设置页会自动显示已登录。
4、在模型选择器中选择 Cursor 模型，如 composer-2 或 claude-4-sonnet。

对话过程中需要工具时，插件会把 Cursor 的工具请求转换为本地 DSH 工具执行，结果通过对话历史返回给模型，全程不使用 Cursor 的文件系统工具。

两个常见问题：

• 登录后 DSH 仍显示未登录：确认浏览器完整走完授权流程并跳转回完成页。登录轮询最多等待约 2.5 分钟。
• 请求返回 401：表示访问令牌过期且刷新令牌已失效，需要在设置页重新登录。

另外，如果模型列表为空，GetUsableModels 的结果依赖账户类型；发现失败时插件会使用内置模型列表，你也可以手动输入模型名。

运行时配置与重试策略¶

设置页的 Runtime settings 卡片控制两件事：单次 Cursor 运行的工具轮次上限，以及 HTTP 重试策略（重试次数、间隔、状态码列表）。

重试次数指额外尝试的次数，默认为 0（禁用）。由于 Cursor 的流式 POST 协议无法证明一次失败的尝试没有在服务端被处理，启用重试可能重复消耗模型工作量或用量。重试只会在尚无任何响应输出、且初始 HTTP 状态码匹配配置列表时发生。

适用场景与注意¶

适合已经有 Cursor 订阅、希望在 DSH 中直接复用这套额度的用户，尤其是不想额外申请和管理 API Key、或在 Cursor IDE / CLI 与 DSH 之间来回切换的场景。

使用前注意以下几点：

1、插件以当前 dsh 进程的权限运行。安装前建议先查看仓库源码与许可证（MIT），确认无误再安装。
2、插件依赖 Cursor 未公开的协议，Cursor 服务端变更后可能失效；请求失败时可检查是否有插件更新。
3、Cursor 原生的图像生成、网页搜索等功能不在插件范围内。
4、更新与卸载使用以下命令，操作后如 DSH 正在运行，需手动重启：

dsh plugin --profile web update dsh-cursor-subscription   # 更新
dsh plugin --profile web remove dsh-cursor-subscription   # 卸载

小结¶

dsh-cursor-subscription 把 Cursor 订阅接入了 DSH：浏览器登录、令牌自动刷新、模型动态发现、本地工具执行，省去了 API Key 的管理负担。也因为它依赖未公开协议，使用时要对可能的失效有预期。

社区目录页面：https://www.skillhub.cn/plugins/orrinzeng/dsh-cursor-subscription
源码仓库：https://github.com/orrinzeng/dsh-cursor-subscription