dsh-computer-use-cua:在 DSH Profile 中启用官方 Cua Driver 电脑操作

前言

在 DeepSeek Harness(DSH)里给智能体接上「看屏幕、点窗口、敲键盘」这类能力,常见做法包括官方 macOS Computer Use bundle、通过 MCP 挂 Cua Driver,或自己挂载 native 提供方。这些路径往往各自占一套配置与注册逻辑;官方注册服务在同一时刻只允许一个电脑操作提供方,多开时可能直接拒绝加载。

dsh-computer-use-cua 是由维护者 vb2250158 发布的配置型 bundle 插件:它不实现 Host 或客户端,而是通过可同步的配置补丁,把 DSH 官方的 Cua Driver 原生提供方挂进已有 profile。下文介绍它的定位、能力与启用时要注意的冲突与权限边界。

这是什么

插件仓库名为 dsh-computer-use-cua(npm 包名同名,当前版本 0.1.1)。一句话定位:在提供 tools 与 systemPrompt 服务的 DSH profile 里,声明依赖并挂载配置,从而启用官方 Cua Driver native 提供方。

工具定义、权限处理、输入执行、截图回传以及停用后的撤销,由官方 @deepseek-ai/dsh-computer-use 与 @deepseek-ai/dsh-experimental-computer-use-cua-driver-native 组件承担;本仓库只负责 bundle 补丁与同步用的 Git 钉版本,没有独立构建步骤。

核心功能

配置 bundle,而非自研驱动

插件通过 cordis.patch.yml 在 Host 顶层注册工具与系统指导,各 Agent 按 DSH 作用域规则继承。它不改动默认模型、preset、操作系统级权限,也不为某个会话预留桌面。

固定官方依赖版本

package.json 中声明:

  • @deepseek-ai/dsh-computer-use: 0.2.2-rc.1
  • @deepseek-ai/dsh-experimental-computer-use-cua-driver-native: 0.2.2-rc.1

原生提供方当前对应 Cua Driver 0.28.0。包内保留 npm optional dependencies,以便安装各平台原生运行库。

与同步器、共享清单协作

适合在源码 Web 环境用现有插件同步器:把本仓库 完整的 40 位 Git 提交 记下来,再由官方安装器安装。共享清单里登记插件名 dsh-computer-use-cua;不要把其 @deepseek-ai/* 依赖写进第三方插件清单。

已验证的运行配置 Git 钉为 b293c1c446c1437cfd304ea7b9924f2fb3f0754c。同步器在接收机上会按本机 DSH 源码对齐官方依赖——Git 钉固定的是配置内容,不能替代你在每台机器上核对最终解析版本与桌面效果。

安装与启用

环境要求

  • Node:>=24.9.0(README 验证环境使用 24.15.0)
  • 需要处于可用的图形桌面会话;运行 DSH 的进程须具备目标应用所需权限

启用前:停用其它电脑操作提供方

启用本 bundle 之前,应先停用其它电脑操作提供方,包括但不限于:

  • 官方 macOS Computer Use bundle
  • Cua Driver MCP
  • 手工挂载的 native 提供方

本插件使用自己的稳定配置行 ID,不覆盖其它 bundle 的行;但若与已加载提供方冲突,官方注册服务会拒绝加载,不会自动替你停用其它插件。

安装路径(以 README 为准)

在已具备 tools 和 systemPrompt 服务的 profile 上操作;标准 Web profile 已提供这些服务。典型流程为:

  1. 用现有插件同步器记录本插件仓库的完整 40 位 Git 提交(验证记录中为上述 b293c1c4… 提交)。
  2. 通过官方安装器安装该 bundle。
  3. 在接收机上执行同步器的「检查更新 → 拉取并应用」,再核对本机加载状态、桌面权限与实际操作效果。

不要在共享来源里写入本机源码链接;每台接收机需自行核对依赖解析来源与 Cua Driver 加载情况。

典型用法与能力边界

启用后,驱动在验证环境中曾发现 56 个工具,只读窗口查询成功;正式服务中相关官方组件可同时运行,且原有会话可保留。但 README 明确:该次验证未包含截图、鼠标键盘输入或模型调用;其它电脑尚未验收,你本机的效果需自行验证。

权限与截图

  • Windows 上权限级别、应用类型与后台输入能力可能限制操作;驱动拒绝后台操作时,不会自动切到前台或提权。
  • 模型若要接收截图,还需要附件存储,以及模型路由上明确声明图像输入。工具加载成功或权限检查通过,并不等于模型一定能看到截图,也不等于点击、键盘与窗口读取已在你的目标应用上验收通过。

多会话与停用

多个会话共用同一桌面时,操作需要自行协调。停用 bundle 后,官方生命周期会撤销工具并关闭驱动;已经送到应用的输入不会回滚。

更完整的官方能力与限制见 DSH 文档 Computer use 与 Cua Driver 0.28.0。

适用场景与注意

适合谁: 已在 DSH 标准 Web profile(或同类具备 tools / systemPrompt 的 profile)上开发智能体,并希望用官方 Cua Driver 原生栈做桌面自动化,且愿意用同步器 + Git 钉管理可复现配置的团队或个人。

务必注意:

  • 插件能力以 当前 DSH 进程权限 为界;安装与启用前应阅读本仓库与 @deepseek-ai/*、Cua Driver 的源码与许可证(本仓库原创部分为 MIT;官方与外部依赖保留各自版权)。
  • 验证范围目前以 Windows x64、pnpm 11.28.5、DSH 0.2.2-rc.1、Cua Driver 0.28.0 为主;Linux / macOS 或其它版本组合需自行验收。
  • 社区目录站点 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系,DSH 生态奉行「一切皆插件」,此处仅为第三方 bundle 分发与说明入口。

结尾

dsh-computer-use-cua 的价值在于用最小自有代码,把官方 Cua Driver 电脑操作接到可同步的 DSH profile 上,并把「单提供方注册」「桌面权限」「多机版本对齐」等约束写清楚。若你正在选型电脑操作方案,可先对照 README 中的冲突说明与 tested-environment.json,再决定是否在接收机上钉住同一 Git 提交做试点。

  • 目录页:https://www.skillhub.cn/plugins/vb2250158/dsh-computer-use-cua
  • GitHub:https://github.com/vb2250158/dsh-computer-use-cua
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜