dsh-llm-cursor：DeepSeek Harness 的非官方 Cursor 订阅登录和聊天

前言¶

DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。当需要对接 Cursor 的订阅服务时，官方仅提供了 IDE 和 CLI 两种官方客户端入口，且没有公开的 OpenAI 兼容 API。dsh-llm-cursor 插件通过实现 Cordis 插件契约，为 DSH 提供了一条非官方的接入路径，允许用户通过 DSH 的界面直接使用 Cursor 的订阅模型。

该插件由 NOirBRight 维护，采用 MIT 许可证。它通过 HTTP/2 协议与 Cursor 的私有端点通信，不依赖官方的 Cloud Agents 或 @cursor/sdk。

安装¶

安装过程需要通过 DeepSeek Harness 的 Web 端进行。请使用以下命令安装 dsh-llm-providers-ui 和 dsh-llm-cursor 两个组件：

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.9/dsh-llm-providers-ui-0.2.9.tgz
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-cursor/releases/download/v0.2.23/dsh-llm-cursor-0.2.23.tgz
dsh web

安装完成后，请重启 DSH Web 端。

核心功能¶

登录与配置¶

在 DSH 的设置中，进入 LLM Providers -> Cursor，即可看到该插件提供的配置卡片。
1. 点击 Sign in with Cursor，系统会启动 Deep Control PKCE 流程，打开系统浏览器完成登录。
2. 登录成功后，会话信息存储在 Host 端的 $DSH_HOME/cursor-oauth.json（权限 0600），插件不会在浏览器中接收 Token。
3. 点击 Fetch available models，插件会读取账户的可用模型列表，将 Cursor 按思考级别拆分的 SKU 合并为模型族，并区分 Fast SKU 和 Max Context SKU。

聊天与请求¶

配置好模型族后，即可进行聊天。
1. 聊天请求通过 HTTP/2 Connect + protobuf 协议发送至 POST https://api2.cursor.sh/agent.v1.AgentService/Run。
2. 插件会自动添加兼容性请求头，包括 x-cursor-client-type: cli、x-cursor-client-version 和 x-ghost-mode: true。
3. 在卡片上可以看到订阅使用情况（来自非官方仪表板数据），以及登录后的账户邮箱。

技术细节¶

协议要求：插件强制要求与 api2.cursor.sh 建立 HTTP/2 连接（包含 ALPN）。插件不提供 HTTP/1 代理桥接，如果底层传输层不支持 HTTP/2，请求会直接失败。
兼容性机制：插件在 package.json 的 dsh.compatibility.dshReleases 字段中维护了已验证的 Host 版本列表，用于确认环境兼容性。
导出结构：插件根目录导出 Cordis 插件契约，同时导出 ./client，为 DSH 提供具体的实现。

风险与限制¶

ToS 违规风险¶

这是使用该插件必须首先考虑的问题。Cursor 员工明确表示，将私有客户端端点用于登录和聊天属于 违反服务条款 的行为。使用该插件进行登录、发送聊天或仅在本机运行，都无法规避这一风险。执法措施可能包括账户限制或永久封禁。

功能与实现限制¶

缓存字段缺失：从 Run 接口返回的 Token 使用块不包含缓存字段，因此 DSH 的缓存命中率统计为空。
SKU 逻辑：Fast SKU 是独立的模型族（如 gpt-5.2 vs gpt-5.2-fast），而非一个简单的开关。1M 上下文 SKU 仅在 Cursor 实际提供 Max Context 的族中显示，手动添加的通用上下文行不受此限制。
版本依赖：CLI 版本号被锁定，当 Cursor 发布新的 CLI 导致版本号不匹配时，插件可能会失效。
数据来源：卡片上显示的使用百分比来自非官方的 Dashboard Rails，而非官方 API。

总结¶

dsh-llm-cursor 提供了在 DSH 中直接使用 Cursor 订阅的可行方案。它通过 HTTP/2 Connect 和 Protobuf 协议实现了与 Cursor 私有端点的通信。但在使用前，请务必确认其违反 ToS 的风险是否在可接受范围内，并确认当前 DSH 环境支持所需的 HTTP/2 特性。

项目主页: https://github.com/NOirBRight/dsh-llm-cursor
社区目录: https://www.skillhub.cn/plugins/NOirBRight/dsh-llm-cursor