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 倉庫查看。