Worker 桌面控制与分享
显式启用 macOS/Linux 电脑控制,检查 helper 权限,并选择 Linux 桌面分享模式。
Computer use 让 Agent 点击、输入和截图;desktop sharing 让人查看或接管桌面。二者都需显式 opt-in,服务端不会自行开启。
启动
agent worker --computer-use startPool 同样支持该参数,worker flags 放在 start 前。Computer use 支持 macOS/Linux,desktop sharing 当前只支持 Linux。
macOS
首次启动由 CLI 安装 ~/.cursor/cursor-computer-use/Cursor Computer Use.app,无需完整 Cursor 桌面应用。worker 必须以已登录 GUI session 的用户运行。
在系统 Privacy & Security 中给 Cursor Computer Use 授予 Accessibility 和 Screen Recording,授权给 Terminal、Cursor 或其他 helper 不会替代它。debug 报告只确认 helper 安装,不能证明权限已授予,应通过真实截图与点击任务验证。
MDM 不能静默批准 Screen Recording;官方建议在模板机完成用户授权和验证,再制作镜像,并在应用路径、签名或运行用户变化后重新检查。可用 CUA_SERVICE_APP 指向部署好的 app bundle,不能随意重签名后假定旧授权继续有效。
Linux
需要 xdotool、ffmpeg 和 X11 工具;自动建立桌面还需 TigerVNC 与 Xfce。具体发行版安装命令以官方页面为准,浏览器交互另需 Chrome/Chromium。
显示选择依次为显式 --display、可达的 DISPLAY、自动 managed desktop。显式 --display 不可达时启动失败,不自动回退;未显式指定而环境 DISPLAY 不可达时可回退。
分享桌面
agent worker --computer-use --share-desktop view startview 只允许观看;不指定 mode 时默认 view_and_control,可接管鼠标键盘。分享使用 worker 创建的隔离桌面,非宿主既有 session,剪贴板传输被阻止。
画面通过已有出站连接传输,无需开放入站端口。只有授权查看者能接入;要确认机器可用,仍需实际截图/点击测试,不能仅以进程在线判断成功。