dsh-cua-drive：macOS 下的私有 Cua Driver Computer-Use 插件

前言¶

DeepSeek Harness（DSH）采用“一切皆插件”的架构，通过插件扩展能力。dsh-cua-drive 是一个仅支持 macOS 的插件，它为 DSH 提供了基于私有 cua-driver 的 Computer-Use 能力，用于窗口点击、屏幕读取和应用程序操作。

平台限定：仅支持 macOS 系统，Windows 和 Linux 上只会加载 cua_status 状态工具，无法启动计算机使用功能。
私有运行时：内置私有 cua-driver 版本 0.20.0（锁定在 runtime-lock.json 中），在插件专用的 socket 上运行，不会干扰或劫持系统上已有的 Cua 实例。
系统交互：提供窗口点击、屏幕读取、应用程序操作等能力。
权限管理：首次启动时会向宿主进程请求辅助功能和屏幕录制权限。

    dsh plugin --profile web add github:aa2246740/dsh-cuadrive-mac

如果 `dsh` 不在 PATH 中，请使用：

    npx @deepseek-ai/dsh plugin --profile web add github:aa2246740/dsh-cuadrive-mac

插件支持以下配置项：

key	默认值	说明
`binary`	空	绝对路径覆盖；空则使用插件 vendor 目录
`ownDaemon`	`true`	启用私有 DSH socket
`socketPath`	`$DSH_HOME/dsh-cuadrive-mac/run/driver.sock`	仅给 DSH 的 serve
`autoStart`	`true`	socket 未起来时自动下载并 `serve --embedded`
`proxy`	空	拉 GitHub 时用的 HTTP(S) 代理
`promptPermissions`	`true`	首次用向宿主进程要权限
`timeoutMs`	`90000`	单次调用时限
`sessionId`	`dsh`	私有 daemon 上的 hosted session

安装差异：官方 CLI 安装需要 PATH 中有 pnpm。DSH.app 的插件管理器仅接受 npm 包名，不支持 github: 协议。从 GitHub 安装会跳过 prepare 脚本，直接使用编译好的 lib/。
权限设置：首次启动需要联网下载 darwin-universal 包到 $DSH_HOME/dsh-cuadrive-mac/vendor/。需根据运行方式在系统设置中勾选对应的权限（DSH.app 勾 DSH，CLI 勾 Terminal / iTerm 等）。
状态检查：进度可通过 cua_status 检查，私有运行时位于 $DSH_HOME/dsh-cuadrive-mac/。
本地开发：克隆仓库后，先运行构建测试：

    npm ci
    npm test
    npm run typecheck
    npm run build
    dsh plugin --profile web add .

该插件通过提供隔离的私有驱动程序，为 DSH 生态中的 macOS 环境提供了 Computer-Use 能力。更多细节可在 GitHub 仓库查看。