dsh-cursor-dev
把 Cursor CLI 当作子编码智能体来写业务代码：每次运行都在 DSH 里开一个真实的子会话（点开就是完整对话），可按任务选模型、会话在 DSH 重启后仍能续聊、返回逐步工具时间线与真实文件 diff，并自带额度/模型/会话面板。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Dclef/dsh-cursor-dev#37e342ee16653233650d78b46dfb2af6a8b7b816
Cursor Dev 以 dsh-cursor-dev 发布，当前版本为 0.10.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
让 DSH 中支持工具调用的父模型，把任务交给本机 Cursor CLI 执行，再接收结果、审查修改并继续工作。
父模型与 Cursor 使用的模型分别选择：例如父模型用 DeepSeek，Cursor 用 Auto；也可以让其他已接入 DSH 的模型派发同样的任务。
flowchart LR
U[用户] --> P[DSH 父模型]
P -->|任务、参考文件、验收标准| T[cursor_code]
T -->|ACP| C[本机 Cursor CLI]
C --> W[工作区文件与命令]
C -->|执行报告| T
T -->|答复、步骤、文件变更| P
P -->|审查后的结果| U
父模型不必是 Cursor 提供的模型。前提是它已接入 DSH、支持工具调用，并且当前会话允许使用插件的工具。这里的模型兼容性指 DSH 内的父模型；其他聊天应用需要另行接入，这个包没有提供通用 MCP 服务。
完整步骤、升级说明和排错见 安装与首次使用。
安装当前版 Cursor CLI，运行 agent login，再用 agent status --format json 检查登录。
在 DSH 插件管理中安装本插件。公开仓库的安装来源为：
git+https://github.com/Dclef/dsh-cursor-dev.git
已配置 DSH 命令行的用户也可以在所用 profile 下执行：
dsh plugin add "git+https://github.com/Dclef/dsh-cursor-dev.git"
按 DSH 提示完成加载；涉及后台代码更新时重启 DSH，然后刷新页面。在 Cursor 面板中选择模型并保存。
明确告诉父模型使用 cursor_code，或者用下面的斜杠命令派发第一个任务。
版本说明（2026-10-16 核对）： 0.10.0 已推送到公开仓库的 main，其中包含本文描述的原生子智能体接入、面板模型锁定、父级专属的 maxChildDepth 递归限制、子进程代理探测与面板模型浏览器，以及安装指南。npm 公共源尚未发布 dsh-cursor-dev，所以按包名安装会返回 404；插件市场（dshmarket）的收录仍在审核，合并前市场里搜不到本插件。要跟进后续改动请用 Git 来源；.tgz 是某一刻的固定快照。详见安装来源与版本。
运行要求：DSH 包声明最低版本 >=0.2.0-rc.1；Node.js ^22.19.0 || >=24.0.0；已登录且可访问服务的 Cursor CLI。原生子智能体功能需要 DSH 的 subagents、agents 服务，后台任务还需要对应任务服务，建议使用当前 DSH 桌面版。CLI 安装方法见 Cursor 官方文档。
| 入口 | 用途 | 结果如何回来 |
|---|---|---|
cursor_code | 父模型派发完整任务，控制目录、模式、模型、会话与报告 | 工具结果回到调用它的父模型，包含答复、步骤和检测到的文件变更 |
/cursor-subagent 任务内容 | 用户直接派发一次任务；可选前缀 -m 模型 | 完成或失败后，插件把摘要交给原父代理继续处理 |
cursor_subagent | 当前源码新增的 DSH 原生一次性子智能体工具，可后台运行 | 使用 DSH 标准结果及后台任务机制；完整过程可在镜像子会话中查看 |
例如，在一个空测试工作区发送：
/cursor-subagent 创建 cursor-cli-check.txt，内容为 cursor-cli-ok，然后读取它确认内容。只修改这个文件，最后汇报结果。
或者直接对父模型说：
请使用 cursor_code 修复这个问题。先让 Cursor 读取相关文件，完成后检查返回的修改和测试结果，再向我汇报。
安装工具后，是否自动调用仍由父模型和会话指令决定。希望默认委派开发任务时，可以把下面的内容加入父代理的自定义指令：
涉及代码实现、重构、修复或批量修改时，优先使用 cursor_code。
在 task 中说明完整目标，在 contextFiles 中列出需要先读的文件，
在 acceptance 中写清约束与验收要求。使用面板默认模型，除非用户要求切换。
收到结果后检查文件变更和验证记录；必要时继续派发修正。
同一任务使用相同 sessionLabel，并以 continueSession:true 续聊。
不同任务或项目使用不同 sessionLabel。没有修改需求的问题可直接回答。
第一次调用 cursor_code：
{
"task": "修复登录表单的空密码校验，沿用项目现有交互风格。",
"contextFiles": ["src/login.ts", "test/login.test.ts"],
"acceptance": "不改变公开接口；补充有意义的回归用例并运行相关测试。",
"sessionLabel": "login-validation",
"mode": "agent"
}
收到结果后，仍由同一个父代理调用：
{
"task": "继续处理刚才的任务：检查纯空格密码的边界情况，必要时修正并验证。",
"sessionLabel": "login-validation",
"continueSession": true
}
示例中的文件路径需要换成实际项目路径。Cursor 接收任务文本、参考文件提示和其已有的 Cursor 会话历史，不会自动读取整段父对话，所以父模型应把必要背景写进任务。
| 参数 | 说明 |
|---|---|
task | 必填；完整任务目标 |
contextFiles / acceptance | 参考文件列表、约束与验收标准 |
workspaceRoot | 可选绝对路径；默认使用当前 DSH 会话工作区 |
model | 可选 Cursor 模型；省略时使用面板选择及配置回退；面板锁定可覆盖此参数 |
mode | agent 执行修改，plan 只读规划，ask 只读问答 |
sessionLabel | 同一父会话中的任务标签，默认 default；不同任务建议分开命名 |
continueSession | 复用当前会话执行后续任务；进程已退出时尝试从 Cursor 存储恢复 |
resetSession | 清除该标签的插件映射并重新开始；不删除 Cursor 自己的历史文件 |
report | summary（默认）或 detailed |
timeoutSeconds | 默认 1800 秒，最大 7200 秒 |
结果包括成功状态、答复、会话标识、实际模型、执行步骤、预览和检测到的文件变更。当前源码还返回 modelSource 与 requestedModel，帮助判断模型选择来自面板锁定、调用参数还是默认配置。文件扫描有范围和数量限制，报告不代替父代理对实际工作区的最终检查。
model → 面板保存的模型 → 插件 model 配置 → CLI 默认值。auto 和 default[] 表示同一个 Auto 选择。sessionLabel 记录。换一个父会话或标签，不会自动接上另一份会话。continueSession:false 不应被当作清空历史的开关；需要全新上下文时使用新标签或 resetSession:true。reloaded。当前源码注册 DSH 后端 cursor。有对应服务时，cursor_code 接入 DSH 的运行开始、结束与取消机制；bundle 同时配置标准工具 cursor_subagent，不修改已有通用 subagent 工具的默认后端。
执行仍由外部 Cursor CLI 完成，DSH 中的子会话负责展示过程。标准入口支持一次性前台或后台任务，后台任务可通过 DSH 的 job_output / job_kill 查看或取消。
目前支持 cursor_code 的显式续聊；尚不支持通过 send_message 向 Cursor 投递持久消息，也没有把 Cursor 接成 Agent Teams 常驻队友。精简 profile 缺少原生子智能体服务时，cursor_code 可以使用原有执行路径；镜像、面板和命令分别依赖对应的宿主服务。
从 DSH 的 Cursor 插件入口打开面板，也可以访问当前 DSH 地址下的 /plugins/dsh-cursor-dev/。例如，DSH 运行在 http://127.0.0.1:19387 时，面板地址为 http://127.0.0.1:19387/plugins/dsh-cursor-dev/；其他用户应使用自己的地址和端口。
面板包含安装/登录状态、账号额度、模型和模式设置、活动与历史会话。点击会话可查看镜像记录。新版本页面可能与上面的截图不同。
| 插件配置 | 默认值 | 用途 |
|---|---|---|
model | 空字符串 | 面板未设置时的 Cursor 模型 |
maxLiveSessions | 3 | 最多保留的 CLI 进程数，任务仍然串行 |
sessionIdleMinutes | 15 | 空闲进程回收时间 |
maxScanFiles | 20000 | 工作区变更扫描的文件数量上限 |
toolName | cursor_code | 编码工具的注册名 |
usageUi | true | 是否挂载状态、额度和面板 HTTP 路由 |
usageBaseUrl | https://api2.cursor.sh | Cursor 额度 API 地址 |
maxChildDepth | 1 | Cursor 子会话允许达到的深度上限，调用方深度必须小于该值 |
插件自动探测 CLI 的 PATH 和已知安装目录。探测失败时，可在插件配置里设置 command 指向可启动的二进制、安装根目录、agent.cmd，或 "node.exe" "index.js"；非空时只使用该路径，不再回退到自动探测。安装排错以指南为准。
面板的「子智能体模型」卡片里有代理输入框，未设置时默认为空。
| 取值 | 含义 |
|---|---|
| 留空（默认） | 自动探测：先看 HTTPS_PROXY 等环境变量，再看 Windows「Internet 选项」里的代理 |
none | 直连，不用代理 |
http://127.0.0.1:7890 | 显式指定代理，优先于环境变量和注册表 |
为什么需要它： Cursor CLI 只读 HTTPS_PROXY / HTTP_PROXY / https_proxy / http_proxy——不读注册表，也不读 ALL_PROXY。所以一台只把代理写在「Internet 选项」里的机器，插件启动的 CLI 子进程会直连 Cursor，而直连只会拿到模型目录里的一小部分：本机实测 agent --list-models 为 31 个（走代理 265 个），ACP 会话清单为 10 个（走代理 46 个）。这就是「有些模型看不到」的全部原因。
留空即自动探测，所以正常情况下不需要配置任何东西；插件会把探测到的地址写进子进程环境（HTTPS_PROXY、HTTP_PROXY 及小写形式），并在模型卡片的「可选模型」那一行末尾显示子进程出口。面板保存后立刻生效，不必重启应用；如果填的值解析不了，那一行会直接说明。
模型卡片下方还有可搜索的模型浏览器：点一行设为面板模型，右边的开关决定它是否出现在上方下拉框里。关掉的模型只是藏起来（写入 disabledModels），点「保存」后生效，随时可以再打开——这样在完整目录有上百个模型时也能只留下写业务常用的几条。
maxChildDepth 限制的是谁能启动 Cursor 子会话：深度为 0 的顶层智能体是正常调用方，深度 1 的子智能体再调用就会被拒绝（默认上限 1，即只允许父智能体创建子智能体）。拒绝发生在创建任何进程或子会话之前，cursor_code 立即返回 sessionKey: "depth-refused"，cursor_subagent 抛出同类错误，错误信息里带有当前深度和上限。宿主本身对 subagent / subagent_fork 的深度限制（面板「子智能体 → 运行限制 → 最大递归深度」）仍然生效；cursor provider 声明 depthLimit: false，无法接收数值型 maxDepth，所以这道限制由本插件自己执行。把 maxChildDepth 设为 0 可以完全禁止子会话，设为 2 或更大则允许更深一层。镜像历史（面板里的记录）不受此限制，仍可正常打开查看。
插件设置与会话映射优先写入环境变量 DSH_CURSOR_DEV_DATA 指定的目录；否则使用 %LOCALAPPDATA%/dsh-cursor-dev；没有该环境变量时使用 DSH 提供的 baseDir 下的 .data（再无 baseDir 时回退到进程当前目录）。Cursor 登录和原始会话由 Cursor 自己保存。面板写操作包含同源检查，HTTP 可访问范围由 DSH 的监听配置决定。
npm install
node --test --test-force-exit --test-skip-pattern="the child agent really edits a file|a bad model is rejected|the real Cursor account returns live quota data" "test/**/*.test.mjs"
完整测试命令为 npm test，其中三个真实 CLI/账号测试需要 Cursor 登录和网络，执行任务会使用该账号额度。当前实现已通过 185 项离线测试，并完成两轮真实 Auto 调用、文件修改和上下文续接验证。打包使用 npm pack 或 pnpm pack，发布前按分发检查核对安装包和版本。
Use Cursor CLI as an execution agent for a tool-capable parent model in DSH. Results return to the same parent for review and follow-up. The parent model and Cursor's model are configured independently. A DeepSeek parent can delegate to Cursor Auto, for example; the parent does not need to be a model offered by Cursor.
See the installation guide for detailed setup and troubleshooting.
Install the current Cursor CLI, run agent login, and check agent status --format json.
Install the plugin through DSH's plugin manager using git+https://github.com/Dclef/dsh-cursor-dev.git. With the DSH CLI configured for your intended profile, use:
dsh plugin add "git+https://github.com/Dclef/dsh-cursor-dev.git"
Restart DSH when backend changes require it, then refresh the page. Open the Cursor panel under /plugins/dsh-cursor-dev/, select a model and save it.
Ask the parent to use cursor_code, or send /cursor-subagent followed by a complete task. The command dispatches directly and hands a completion or failure summary back to the original parent.
As checked on 2026-10-16, version 0.10.0 is pushed to main on the public repository and carries the native-provider and model-lock work documented here plus the parent-only maxChildDepth recursion cap, child proxy detection and the model browser, together with the install guide. The package is not published to the public npm registry, so a bare package-name installation returns 404, and the dsh-market listing is still under review. Use the Git source to follow later changes; a .tgz is a fixed snapshot.
Requirements: DSH metadata declares >=0.2.0-rc.1; Node.js ^22.19.0 || >=24.0.0; an authenticated Cursor CLI account with service access. Native dispatch additionally needs DSH's subagents and agents services, and background runs need the host's job services. A current DSH desktop installation is recommended.
cursor_code takes a complete task, optional contextFiles and acceptance, an absolute workspaceRoot, and optional model, mode, session and report settings. It returns the final reply, steps and detected file changes to its caller.sessionLabel and continueSession: true for follow-ups from the same parent. Use a new label or resetSession: true to start without the previous mapping. continueSession: false alone does not guarantee an empty persistent history.The default model order is call argument → saved panel choice → plugin configuration → CLI default. In the current source, locking the panel choice overrides a per-call model argument. Auto and default[] are the same choice. The returned modelSource and requestedModel explain the selection.
The current source registers a native DSH provider named cursor and a standard one-shot tool named cursor_subagent. Rich cursor_code calls also use the native lifecycle when those host services exist. The existing generic subagent backend remains configured as before.
Cursor executes externally; a real DSH child session mirrors the transcript for inspection. Standard background runs use DSH's job result and cancellation tools. Persistent mailbox continuation through send_message, and Cursor as a resident Agent Teams teammate, are not implemented. Use cursor_code with continueSession for explicit follow-ups.
The parent remains responsible for reviewing the actual changes and verification evidence. File reports have scan limits and are not a substitute for final workspace checks. Cursor model availability and usage depend on the Cursor account; the parent model uses its separate DSH provider configuration.
maxChildDepth (default 1) caps who may start a Cursor child session. A top-level agent at depth 0 is the intended caller; a subagent at depth 1 that calls cursor_code or cursor_subagent is refused before any process, child session, or reset is created — cursor_code returns sessionKey: "depth-refused" and the error names both the current depth and the cap. This exists because the cursor provider declares depthLimit: false and cannot accept a numeric maxDepth from the host's tool-subagent, so the plugin enforces the limit itself. Set it to 0 to forbid Cursor children entirely, or higher to allow deeper nesting. The host's own delegation limit for subagent / subagent_fork (panel → Subagents → Run limits → maximum recursion depth) still applies independently. Opening a mirrored child conversation in the panel is a read-only record and is not affected.
The 子智能体模型 card carries a proxy box, empty by default.
| Value | Meaning |
|---|---|
| empty (default) | detect it: HTTPS_PROXY and friends first, then the Windows Internet Settings proxy |
none | never proxy |
http://127.0.0.1:7890 | that proxy, ahead of both of the above |
Why it exists: the Cursor CLI reads HTTPS_PROXY / HTTP_PROXY / https_proxy / http_proxy and nothing else — not the Windows registry, and not ALL_PROXY. On a machine whose only proxy lives in Internet Settings, the CLI child therefore reaches Cursor directly, and the direct route publishes only a fraction of the catalogue: measured on this machine, agent --list-models answers 31 models directly and 265 through the proxy, while the ACP roster the picker actually uses goes from 10 to 46. That is the whole of the "some models are missing" symptom.
Leaving the box empty already fixes it, so no configuration is normally needed: the plugin resolves the route, writes HTTPS_PROXY/HTTP_PROXY (and the lowercase spellings) into every child process it starts, and shows the result as 子进程出口 at the end of the available models line. Saving takes effect on the next spawn rather than the next restart, and a value that cannot be parsed is reported on that same line instead of being silently ignored.