dsh-cuadrive-mac
其他 活跃维护

dsh-cuadrive-mac

aa2246740/dsh-cuadrive-mac

提供仅适配macOS系统的私有化CUA计算机操控能力,无需云端中转数据,操作响应延迟低,插件体积小巧运行稳定,可覆盖文档编辑、网页浏览等常见操作需求,安装配置流程简单易上手

0
Stars 标星
0
Forks 分支
0
Watchers 关注
0
Open Issues
TypeScript
主要语言
MIT
开源协议
953 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:aa2246740/dsh-cuadrive-mac
git clone https://github.com/aa2246740/dsh-cuadrive-mac.git
git clone git@github.com:aa2246740/dsh-cuadrive-mac.git
README.md main

中文 · English

给 DeepSeek Harness 自己的电脑操作运行时

只做 macOS。装上之后,DSH 里的 agent 用一份私有、钉死的 cua-driver 0.20.0(写死在 runtime-lock.json)点窗口、读屏幕、操作 App。跑在插件自己的 socket 上,不会停、改、或劫持机器上已有的 Cua。

第一次启动会向拉起 dsh 的那个进程要辅助功能和屏幕录制。DSH.app 勾 DSH。命令行 dsh web 勾 Terminal / iTerm / Cursor / VS Code。Windows / Linux 只加载 cua_status,说明这是 macOS-only,不会下载驱动,也不会启动 computer-use。

非官方。包名是 dsh-cua-drive。仓库还叫 dsh-cuadrive-mac,已经下过的包、权限、socket、会话不用搬家。

安装

钉死一个 commit,重启 DSH,开一个新对话。DSH.app 和命令行 dsh web 都能用。仓库里已经带着编好的 lib/,GitHub 安装不会跑 prepare。

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

第一次在 Mac 上启动需要联网一次(GitHub Releases),把钉死的 darwin-universal 包拉到 $DSH_HOME/dsh-cuadrive-mac/vendor/。下不动就设 HTTPS_PROXY / ALL_PROXY / 插件配置 proxy,或者把一模一样的 tarball 放到 runtime.manualCachePath。不要跑 cua-driver update。

从旧的 my-plugins 说明升级的:先把 profile 里 cordis.patch.yml 中的 dsh-cuadrive-mac 那一行删掉。现在由 Bundle 自己占 Loader,留两份会在启动时报重复 id。

第一次在 Mac 上

运行时起来之后,插件会用真正拉起 dsh 的那个进程去要辅助功能、屏幕录制:

你怎么跑 dsh 系统设置里要勾谁
DSH.app DSH
CLI(dsh web,没有 app 包) Terminal / iTerm / Cursor / VS Code —— 父进程那个 App

不要跑 cua-driver permissions grant,那会去拉 /Applications/CuaDriver.app。看 cua_status.hostPermissions.hostLabel,勾那个名字。

DSH 启动不等 GitHub。host tools 马上就能调。tarball 在后台用 curl -C - 续传。进度看 cua_status 的卡片标题(Cua runtime 42%),或者打开 $DSH_HOME/dsh-cuadrive-mac/status.json 和 download.log。

Windows / Linux

Windows / Linux 只加载状态工具,不会启动 computer-use。下面这张图是 Linux 上的 cua_status,只说明非 Mac 不会动手。

Linux 上调用 cua_status:supports macOS only (got linux/x64)

它怎么跟机器上的 Cua 分开

$DSH_HOME/dsh-cuadrive-mac/
  vendor/<driver>/   # 这份插件私有的 cua-driver
  cache/             # 可续传的 tarball
  status.json
  download.log
  permissions.json
  run/driver.sock    # 只给 DSH 用,不是 ~/.local/bin 那份

关掉 DSH,停的只是这个 socket。别的 agent 各自的 cua-driver 还在。skill/ 是跟锁版本对齐的官方 skill 包;目录名仍是 dsh-cuadrive-mac,给模型的工具名仍是 cua_*。

为什么不只塞 @deepseek-ai/dsh-mcp-client:那个客户端会丢掉截图 image block。这份插件走私有的 cua-driver --socket … call,再把 PNG 挂回 ctx.attachments。

配置

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 第一次用拉起 dsh 的那个 host 去要权限
timeoutMs 90000 单次调用时限
sessionId dsh 私有 daemon 上的 hosted session

本地开发

克隆到 Harness 仓库外面,在插件自己的目录里:

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

MIT。非官方,跟 DeepSeek、Cua 都没有合作关系。