前言¶

DeepSeek Harness（DSH）支持把重任务委派给子智能体，父会话只收一条结论，避免 token 随上下文线性膨胀。官方子智能体后端有 Codex（@deepseek-ai/dsh-subagent-codex）和 Claude Code（@deepseek-ai/dsh-subagent-claude-code），没有 Cursor。

若你已有 Cursor 订阅，Cursor CLI（cursor-agent）走的是真实 agent 循环：读写文件、跑命令、调 MCP，鉴权也独立于 DSH。社区插件 dsh-subagent-cursor（维护者 xuanyuanli）把 cursor-agent 挂进 Profile，模型可通过工具 subagent_cursor 在会话工作区 spawn 一次性子进程，跑完只返回单条权威答案。

这是什么¶

dsh-subagent-cursor 是面向 DSH 的 Cursor CLI 一次性 subagent 提供方（package 版本 0.1.1，MIT 许可证）。每次委派在父会话工作区启动全新的 cursor-agent 进程，任务结束后把 Cursor 的最终答案（或失败诊断）通知回父 agent；中间 assistant 消息、thinking、工具事件、stderr、token 用量不会进入父会话。

插件自行注册 provider 与 Host 级工具，不依赖官方 @deepseek-ai/dsh-tool-subagent，以避免 provider 与工具同层加载时的时序问题导致工具静默缺席。

核心功能¶

子智能体提供方与工具¶

• Provider 注册名默认 cursor（可用 providerName 修改）。
• 工具名默认 subagent_cursor（可用 toolName 修改）；接受任务后返回 child id，完成后以通知送回答案。
• 一次性委派：后端不接受追问；要继续对话需在新委派里把上下文写进 prompt。

能力与限制¶

提供方能力标志均为 false：不支持 agentOptions、agentPreset、outputSchema、depthLimit。深度嵌套只能靠 prompt 或 CLI 侧约束。

权限档¶

permissionMode 五选一，与独立开关 approveMcps（默认 true，对应 --approve-mcps）正交：

默认 trust 而非 safe，是因为 README 实测：Windows 上 safe 会导致 CLI exit 1、无 result 事件。

主要配置项¶

字段以仓库 src/index.js 的 Config 为准，常用项包括：model、cliPath、env、extraArgs、disposeGraceMs（默认 3000）等。extraArgs 不经校验，勿改 --output-format，否则解析失败。

安装与启用¶

前提：Node.js ≥ 22（宿主用于加载插件；实际执行用 CLI 自带 node.exe），DSH ^0.2.1-rc.3，且 Cursor CLI 已登录（插件不复用 DSH 凭据，也不读 CURSOR_API_KEY）。

1、安装 Cursor CLI 并登录：

cursor-agent login
cursor-agent status

2、编辑 Profile 的 package.json（Web/Desktop 默认路径 ~/.dsh/profiles/desktop/package.json），在 dependencies 中加入本包。本地开发可用 link:；发布依赖示例：

{
  "dependencies": {
    "dsh-subagent-cursor": "0.1.1"
  }
}

3、在 dsh.profile.bundles 数组末尾追加 bundle 名（加载顺序：base / web 在前，本包在后）：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-subagent-cursor"
      ]
    }
  }
}

4、安装依赖并重启 DSH：

cd ~/.dsh/profiles/desktop
pnpm install

安装器提示需重启时必须重启。

典型用法与验证¶

让模型调用最小任务，期望得到文本答案且 stopReason 为 completed：

用一个 subagent_cursor 任务，只回答 OK，不要调用任何工具。

可先绕开 DSH，用 CLI 自检（参数等价于默认 trust + approveMcps: true；Windows 下 <版本> 取 %LOCALAPPDATA%\cursor-agent\versions\ 下最新目录，README 写作时参考版本为 2026.10.22-27dcf5f）：

node "$LOCALAPPDATA/cursor-agent/versions/<版本>/node.exe" \
     "$LOCALAPPDATA/cursor-agent/versions/<版本>/index.js" \
     -p --output-format stream-json --trust --approve-mcps "Reply with exactly: PONG"

写 subagent_cursor 的 task 时，第一句应为祈使指令（如「读取 X 并总结」）；工作目录、日期等上下文放在指令之后，否则 agent 可能只确认环境而不调用工具。

适用场景与注意¶

适合：已有 Cursor 订阅、希望在 DSH 里多一个能真正改文件、跑命令的委派后端，且接受「单条结论、无追问」模型的人。

注意：

• 子进程在父会话工作区运行，权限与当前 DSH 进程及所配 permissionMode 相关；安装前请阅读源码与 MIT 许可证，自行评估安全边界。
• 同机挂两套 Cursor 实例时，须区分 providerName 与 toolName。
• CLI 的 stream-json 输出无版本化契约承诺；换 CLI 版本后建议重跑验证步骤。
• 社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；插件星标以目录页为准（当前线索为 0）。

结尾¶

dsh-subagent-cursor 补上了 DSH 官方未提供的 Cursor 子智能体后端：用订阅额度驱动 cursor-agent，父会话只收一条权威答案，控制上下文膨胀。详情与排障见仓库 README。

• 目录页：https://www.skillhub.cn/plugins/xuanyuanli/dsh-subagent-cursor
• GitHub：https://github.com/xuanyuanli/dsh-subagent-cursor