前言¶
在 DeepSeek Harness(DSH)里,智能体除了代码、文件和终端,还可以调用 computer-use(电脑操作) 工具:读窗口、截图、点击输入、管理窗口,以及在已授权的浏览器里操作页面。这些能力来自 DSH 官方组件和 Cua Driver Native 提供方,并不是每个安装里都默认装好、配好。
若没有统一入口,启用过程往往分散在配置与组件安装步骤里,也不易区分「配置已保存」和「驱动已就绪」。dsh-computer-use-manager(维护者 jwhs648,客户端类社区插件,MIT)做的是:为 DSH 已有的 computer-use 能力提供可视化开关、兼容组件检查与补装、运行状态展示和只读健康自检。它不自带独立的电脑操作引擎,也不会另实现一套 computer-use。
目录页:https://www.skillhub.cn/plugins/jwhs648/dsh-computer-use-manager。SkillHub 为社区插件目录,与 DeepSeek / 幻方无官方从属关系。当前预发布版本为 0.1.0-alpha.2(安全修复测试版);0.1.0-alpha.1 存在热重载、取消恢复与遗留安装进程等问题,不建议继续分发。
这是什么¶
本插件是 DSH 原有 computer-use 能力的激活与管理 UI。实际桌面行为由 DSH 官方 computer-use 组件及其 Cua Driver Native 完成;若当前安装缺少与宿主版本匹配的官方组件,插件会在用户确认后补装,而不是安装自研引擎。
开启前后变化的是 AI 可调用的工具,不是模型本身。 未开启时,DSH 仍可使用已配置的代码、文件、终端等;开启且原生提供方运行后,AI 才能通过这套 computer-use 工具观察和操作 DSH 所在电脑的界面(若已通过其他入口启用同类能力,本插件主要增加管理页,不叠加一套桌面工具)。
管理页提供的入口¶
下面按 README 中的能力表说明各入口在做什么。
| 入口 | 行为 |
|---|---|
| 启用开关 | 检查本地组件;需要安装时请求确认,随后继续启用并自检 |
| 运行状态 | 区分保存的配置、实际工具提供方、可用工具和需要重启的状态 |
| 检查兼容组件 | 查询与当前 DSH 精确匹配的官方组件,不是「最新版」检测 |
| 安装匹配版本 | 只安装固定的三个官方组件,不接受任意包名或版本 |
| 健康自检 | 读取原生驱动诊断,不发送桌面操作或截图 |
界面支持中文、英文和窄屏布局。停用电脑操作能力后,管理页仍可访问;插件自检只读驱动诊断,不会主动截图或发送键鼠操作。
在已核验的 Windows x64 + DSH Desktop 0.2.2-rc.1 环境中,启用后状态显示 56 个原生工具;数量随宿主版本、提供方和注册状态变化,不承诺所有环境相同。
开启后能做什么(与未开启的对比)¶
以下能力均来自 DSH 官方组件及其原生驱动,不是本插件自行实现:
| 场景 | 未开启这套 computer-use | 开启且提供方已就绪后 |
|---|---|---|
| 代码、文件、终端及其他既有工具 | 按原有配置可用 | 保持原有能力,不由本插件新增 |
| 看应用界面 | 无法通过这套工具读窗口或截图;可由你提供截图 | 枚举应用和窗口,读可访问性控件树,按需截窗口或桌面 |
| 操作应用 | 无法通过这套工具点击或输入 | 点击、双击、滚动、拖动,输入文字,发送按键及快捷键 |
| 管理应用与窗口 | 无此原生工具入口 | 启动指定应用,查看并调整窗口位置与大小 |
| 操作浏览器页面 | 仍可用已有网页搜索、抓取等(若已配置) | 在受支持且完成授权的浏览器连接中读页面、点击、填表,并按权限处理上传下载 |
| 使用剪贴板 | 无这套工具的剪贴板入口 | 按任务读写剪贴板文本及工具支持的图像或文件引用 |
README 中的典型请求示例包括:查找指定应用窗口并读界面/截图分析报错;打开应用进入设置并在修改前说明拟改项;在已授权浏览器页面填表并在提交前停下确认;操作后再读界面核对是否生效。目标应用、系统权限、控件与浏览器连接都可能限制操作;工具作用于 运行 DSH 的电脑,不默认控制远程打开 DSH 网页的另一台机器。
安装¶
本插件为 Windows 测试版,已通过验证的范围为 Windows x64、DSH Desktop 0.2.2-rc.1;macOS、Linux 及其他 DSH 版本尚未实测。插件以当前 dsh 进程权限运行,安装前应阅读源码与 MIT 许可证,并知悉其为第三方社区组件,非 DeepSeek 或 Cua 官方发行。
方式一:DSH Desktop 图形界面¶
- 在 DSH Desktop 打开 插件 → 添加插件。
- 将修复包在 DSH 所在机器上的绝对路径填入 包名或地址(不要加引号)。远程浏览器电脑上的路径不能直接用于 DSH 主机。
- 阅读第三方插件信任提示并安装,然后启用管理插件。
- 进入侧栏 电脑操作能力,按需打开开关;组件缺失时确认安装并等待自检。
修复包下载:dsh-computer-use-manager-0.1.0-alpha.2.tgz(同 release 页提供 SHA-256 校验,勿用旧版发行包替代)。
方式二:命令行(Desktop 的 dsh)¶
为确保变更完整应用,先退出 DSH,执行后再打开:
dsh plugin --profile desktop add "C:\path\to\dsh-computer-use-manager-0.1.0-alpha.2.tgz"
也可安装本地源码目录。首次选择本插件不会自动开启电脑操作驱动,两个可选底层组件默认关闭;替换已安装的 Host 代码可能需要重启 DSH,刷新页面不能替代宿主重启。
package.json 中声明 engines.dsh 与 peerDependencies 均为 0.2.2-rc.1,与上述核验范围一致。
开启流程¶
点击开关 → 检查本地组件 → 必要时确认并安装 → 启用 → 等待驱动就绪 → 自检
- 本地组件已兼容时,跳过联网查询与下载。
- 缺失或不兼容时,先验证与当前 DSH 的匹配版本,再请求安装确认(确认五分钟有效、仅可使用一次)。
- 安装、启动、需要重启和自检异常分别报告,不会一律显示为成功。
- 取消或失败恢复不得把能力从关闭重新开启;关闭管理页面不会取消已确认的 Host 操作。
安装、启用和停用影响当前 DSH 配置下的所有会话;不自动授予系统权限、不绕过 DSH 审批、不自动重启 DSH。
卸载与更新¶
本插件为本地或 tarball 来源,不通过内置 Versions 页面自动升级;「检查兼容组件」只管理三个官方组件,不更新本管理插件。卸载管理插件不会自动删除此前单独安装的电脑操作组件;建议先关闭电脑操作能力,再卸载管理插件,便于核对停用结果。
安全与恢复边界(简要)¶
匹配组件安装始终针对当前宿主精确版本。持有配置写锁后发现遗留安装运行记录会停止处理;对不能确认已完成并拥有恢复权的失败,不盲目写回旧配置。普通重启保留配置;完整 Desktop 恢复可能取消自定义 bundle 的选择,此时需在插件页重新启用管理插件。
开发与反馈¶
从源码仓库运行测试(勿在精简发行包中执行):
node --test core.test.js api.test.js package.test.js
问题与建议:https://github.com/jwhs648/dsh-computer-use-manager/issues。反馈时请提供 DSH 版本、操作系统、安装方式和已脱敏错误。
结尾¶
dsh-computer-use-manager 把 DSH 已有 computer-use 的启用、三件套官方组件补装、状态区分和只读自检集中到侧栏「电脑操作能力」一页,适合需要在 Windows x64 + DSH 0.2.2-rc.1 上可控地打开桌面自动化、又不愿自行拼配置的开发者。