Cursor 模型接入 lukeinx/cursor-to-dsh

cursor-to-dsh

把 Cursor 的模型接入 DeepSeek Harness（DSH）和 DeepSeek Desktop，作为 cursor 模型提供方使用。走官方 @cursor/sdk，用你自己的 Cursor API Key。DSH 保留智能体循环、工具和权限；Cursor 只负责模型。文档为中文。

把 Cursor 注册为 DeepSeek Harness（DSH，含 DeepSeek Desktop）的模型提供方 cursor。DSH 负责智能体循环、工具和权限，Cursor 只当模型。

一次带工具调用的对话：DSH 把工具交给 Cursor，Cursor 调工具时交回 DSH 执行，结果回填到同一个 Cursor run

特点

- 官方接口：只用 Cursor 官方 @cursor/sdk 和你自己的 API Key，不逆向私有协议、不读 Cursor IDE 登录态；通过 DSH 的 ctx.llm.registerAdapter 注册，不改宿主代码。
- 工具归 DSH：Cursor 内置工具全部关闭，读写文件、执行命令都由 DSH 执行，沿用 DSH 的沙箱和审批。
- 缓存复用：每个 DSH 会话对应一个 Cursor agent，只发新增内容；工具结果回填到同一个 run 继续。
- 模型与用量：模型和推理强度来自 Cursor 实时目录，始终 fast=false；按 DSH 互不重叠的用量桶上报，不误报超限。
- 图片：用户消息和工具结果里的图片转给 Cursor。

安装

前置：DSH 0.2.0-rc.2 及以上（DeepSeek Desktop 内置 0.2.1-rc.2）。

命令行或其他配置档：dsh plugin --profile <名称> add cursor-to-dsh。

DeepSeek Desktop：desktop 配置档由 Desktop 独占，dsh plugin add 会报 managed exclusively by the Electron application，需要手动改：

1. 完全退出 DeepSeek Harness Desktop。
2. 在 ~/.dsh/profiles/desktop/package.json 里追加两处，已有条目不动：

{
"dependencies": { "cursor-to-dsh": "^0.1.1" },
"dsh": { "profile": { "bundles": ["…已有条目…", "cursor-to-dsh"] } }
}

3. 用 Desktop 自带的 pnpm 安装，然后启动：

cd ~/.dsh/profiles/desktop
node "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/primary-runtime/dependencies/pnpm/bin/pnpm.mjs" install
open -a "DeepSeek Harness"

升级：改版本号后重复第 3 步。

填 API Key

在 cursor.com/dashboard → API Keys → New API Key 创建（个人 key 或 service account key，不支持 Team Admin key）。

Desktop 的「模型」设置页不能给第三方插件填 key，推荐写进 ~/.dsh/.credentials.yaml（权限 0600，热加载）；文件已存在时只在 refs: 下加一行：

version: 1
refs:
CURSOR_API_KEY: <你的 key>

查找顺序：凭据文件 → 环境变量 CURSOR_API_KEY → 插件配置 apiKey。

验证

「设置 → 模型」里出现 Cursor，模型选择里有 cursor 下的模型即成功。也可以把 agent-default-model 设为 provider: cursor。

让智能体代装

把下面这段发给 Claude Code、Cursor、pi 等：

按 https://github.com/lukeinx/cursor-to-dsh 的 README 给我的 DeepSeek Harness Desktop 安装 cursor-to-dsh，遵守 README 里给 Agent 的规则；装好后告诉我把 Cursor API Key 填到哪里，key 由我自己填。

给智能体的规则：

- 改配置档前先退出 Desktop；只追加条目，不改已有的 dependencies 和 bundles。
- key 由用户自己写入凭据文件，智能体不读取、不打印。
- 改本仓库代码前先读 AGENTS.md。

配置

默认不用配。需要时在配置档的 cordis.patch.yml 覆盖插件这一行（补丁会替换整个 config，要写全）：

- id: llm-cursor
name: cursor-to-dsh
config:
apiKeyEnv: CURSOR_API_KEY
context: min

| 配置项 | 默认值 | 环境变量覆盖 | 含义 |
| apiKeyEnv | CURSOR_API_KEY | | 存 key 的凭据名 / 环境变量名 |
| apiKey | 无 | | 明文 key，不推荐 |
| context | min | DSH_CURSOR_CONTEXT | 上下文档位：min、max 或如 300k；被拒时自动降档 |
| cwd | 会话工作目录 | DSH_CURSOR_CWD | Cursor agent 的工作目录 |

其他环境变量：DSH_CURSOR_DEBUG=1 输出调试日志到 stderr；DSH_CURSOR_PREWARM=0 关闭预热（插件加载后在后台预建一次 agent，省掉 Cursor SDK 首次约 8 秒的初始化）。

已知限制

- 文件附件、已卸载（offloaded）或读不出的图片不转给 Cursor，只留占位说明；重放历史时只带最后一条用户消息的图片。
- 工具交接期间不报用量，上下文用量在 run 结束时更新。
- 不支持 stop（报 UNSUPPORTED_OPTION）；temperature、maxTokens 被忽略。

开发

npm install && npm run build # DSH 加载的是 lib/，改源码后要重新 build 并重启 DSH
npm test # 假 Cursor agent 的单测
npm run check # 类型检查
npm run check:public # 推 GitHub / 发 npm 前：不含内网链接和本机路径
CURSOR_API_KEY=... node --experimental-strip-types scripts/live.ts [模型 id] # 真实 Cursor 实测

本地源码接入 Desktop：安装第 2 步的依赖写成 "cursor-to-dsh": "link:<仓库绝对路径>"。

不动 profile、在真实 DSH 里试跑一次（overlay 里的路径必须是绝对路径）：

/tmp/cursor-overlay.yml
- insert:
- id: llm-cursor
name: <仓库绝对路径>/lib/index.js
- id: agent-default-model
name: '@deepseek-ai/dsh-agent-default-model'
config:
provider: cursor
model: claude-haiku-5-5

DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
CURSOR_API_KEY=... DSH_CURSOR_DEBUG=1 "$DSH" --profile headless --patch /tmp/cursor-overlay.yml --json "Read README.md and summarize it in one line"

调试日志里工具结果回填那次应显示 plan=results，多轮对话的第二轮应显示 plan=send。--patch 挂载的插件用自己的 @deepseek-ai/dsh-llm 副本，错误码会变成 UNKNOWN，只用于试跑。

架构和约束见 AGENTS.md。

版权

MIT，见 LICENSE。Copyright (c) 2026 Luke。