前言¶
用 DeepSeek Harness（下称 DSH）做智能体开发时，聊天中的 agent 默认自己完成所有工作。但很多人的机器上已经装好并登录了 Cursor CLI，有时希望把「实现一个功能」「review 一个文件」这类边界清晰的独立任务直接交给它跑，而不是手动切窗口、复制上下文。
dsh-cursor-acp 解决的就是这个问题：它注册一个 cursor_agent 工具，让当前聊天的 agent 在普通对话里把独立任务交给本机已登录的 Cursor CLI（经 ACP）执行。下面按准备、安装、使用、排查的顺序介绍。
这是什么¶
这是 loeanxi 维护的 DSH 社区插件，采用 MIT 许可，当前版本 0.2.0。DSH 的理念是「一切皆插件」，这个插件就是这一思路下的社区产物。
它的一句话定位：在普通聊天中把独立任务交给本机已登录的 Cursor CLI（经 ACP）执行。
需要说明两点：它不是模型选择器里的一个 Cursor 条目，也不是 Cursor 官方产品。
开始前的准备¶
前置条件：在同一台电脑上安装 Cursor CLI 并登录，或改用 CURSOR_API_KEY。
Windows（PowerShell）：
irm 'https://cursor.com/install?win32=true' | iex
agent login
macOS / Linux：
curl https://cursor.com/install -fsS | bash
agent login
agent login 和 cursor_agent 必须能访问 Cursor 服务器。浏览器代理或 Clash 式系统代理对终端不自动生效，Node 不会读取，需要在将要使用的同一个窗口里设置代理环境变量：
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:ALL_PROXY = "http://127.0.0.1:7890"
$env:NO_PROXY = "localhost,127.0.0.1"
$env:NODE_USE_ENV_PROXY = "1"
端口以你的代理软件显示为准。设置后在同一窗口运行 agent login 并启动 DSH。这个插件会向 Cursor 子进程转发 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY / NODE_USE_ENV_PROXY，所以在同一窗口设置是有效的。另外注意：如果 Clash 配置把 node.exe 设为 DIRECT，子进程可能绕过代理，Settings 和 doctor 会提示这一点。
安装与启用¶
从 npm 安装（首选）：
dsh plugin --profile desktop add dsh-cursor-acp
Web 端：
dsh plugin --profile web add dsh-cursor-acp
也可以从 GitHub 安装：
dsh plugin --profile desktop add github:loeanxi/dsh-cursor-acp
dsh plugin --profile web add github:loeanxi/dsh-cursor-acp
安装后需要重启 DeepSeek Harness。Node 引擎要求为 ^22.19.0 || >=24.0.0。
安装后的检查¶
打开 Settings → Cursor subagent，依次确认三件事：
1、页面会检测是否找到 CLI。注意找到 CLI 不等于已登录，页面还会检查 agent status 的登录状态，以及当前进程是否有 HTTPS_PROXY 与 NODE_USE_ENV_PROXY=1；未登录或代理缺失时页面会说明。页面不显示邮箱。
2、可以选择子任务模型参数（effort、Fast、model）后点 Apply。该选择只影响 cursor_agent，不影响当前聊天的模型；选择由插件自身存储，在原版 DSH 上也生效，不依赖 Host 设置 allowlist。
3、点 Test 按钮做连通性验证，它会发送一次官方只读任务（agent --print --mode ask，回复 pong）。Test 会消耗少量 Cursor 额度，且不会启动完整 ACP 会话。
怎么用¶
在聊天里直接提请求，例如 “Have Cursor implement this feature” 或 “Have Cursor review this file”。消息中给出足够的细节，agent 会自行调用 cursor_agent。
任务在当前工作区文件夹运行，使用你的 Cursor 订阅额度；父聊天只看到最终结果。
找不到 CLI 时¶
运行 doctor 子命令诊断：
dsh plugin --profile desktop exec dsh-cursor-acp doctor
Web 端用 --profile web：
dsh plugin --profile web exec dsh-cursor-acp doctor
doctor 会打印 CLI 路径、登录/代理提示，以及本 dsh 能否加载 @deepseek-ai/dsh-subagent-acp / dsh-tool-subagent。这两个官方包缺失时，Settings 会说明，且 cursor_agent 不会注册。
适用场景与注意¶
适合已经在本机装好 Cursor CLI、有 Cursor 订阅，想让 DSH 聊天中的 agent 把独立子任务委托出去的人。父聊天只拿最终结果，适合把边界清晰的工作交出去。
使用前注意：
1、任务消耗的是你的 Cursor 订阅额度，Test 也会消耗少量额度。
2、代理环境变量要在将要使用的同一个窗口设置，浏览器代理对终端无效。
3、插件依赖官方包 @deepseek-ai/dsh-subagent-acp 与 dsh-tool-subagent，缺失时 cursor_agent 不注册。
4、插件以当前 dsh 进程的权限运行。安装任何社区插件前，建议先检查源码与许可证；本插件采用 MIT，源码在 GitHub 上。
结尾¶
回顾一下：dsh-cursor-acp 把本机已有的 Cursor CLI 接进 DSH 的聊天流程——一行安装命令、一个设置页、一个 doctor 子命令，覆盖了从启用到排障的路径，让聊天中的 agent 多一个可以委托独立任务的执行器。
- 目录页：https://www.skillhub.cn/plugins/loeanxi/dsh-cursor-acp
- GitHub：https://github.com/loeanxi/dsh-cursor-acp
目录页为社区维护的独立站点，与 DeepSeek / 幻方无官方从属关系。
