本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-computer-use

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @anionex/dsh-computer-use

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 不移动系统光标： helper 中没有 cursor warp 路径。
• 不做全局指针注入： click、scroll 与 drag fallback 使用 pid/window 定向的 SkyLight 路由，不进入全局 HID 事件流。
• 指针动作不激活应用： 语义化 Accessibility、目标进程指针输入与 keyboardPolicy: preserve 都不激活；keyboardPolicy: activate（Bundle 默认）在键盘 fallback 前把目标应用带到前台，与 Codex Computer Use 对齐。
• 独立 Agent 光标： click、scroll 与 drag 动作会移动一个点击穿透、不会激活应用的软件光标，同时保持系统真实光标不变。默认显示，并停留在动作落点，直到绑定窗口变化或收到 hide 命令；cursorAutoHideMs 可开启定时自动隐藏。
• 不盲目重放： 每个动作都绑定准确、未过期的 observation，并返回新鲜状态。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件支持 Windows 或 Linux 吗？

当前版本只提供 macOS 提供者；README 明确表示 Windows UI Automation 和 Linux 提供者尚未实现。Windows 和 Linux 用户需要等后续版本。

使用时需要授予 macOS 哪些系统权限？

调用 computer_observe 等只读操作需要 macOS「辅助功能」(Accessibility)；仅当请求截图时才需要「屏幕录制」(Screen Recording) 权限。两者都必须在 macOS 系统偏好设置里手动授予，插件本身没有越权能力。

装好以后 Agent 一上来就能操控我的电脑吗？

不能。安装后插件默认只注册 computer_use_activate 一个引导工具，真正可执行读写操作的 11 个 computer_* 工具只有在当前 Agent 会话里加载 /computer-use Skill 之后才会出现。

这个插件会抢走我正在用的那个 App 的前台位置吗？

默认不会。焦点策略 focusPolicy 默认为 preserve，只在点击、滚动、拖拽时用一个独立的小光标指示位置，不会切换前台。只有当你把 keyboardPolicy 或 focusPolicy 改成 activate 时，才会在键盘输入前把目标 App 拉到前台。

怎么彻底卸载这个插件？

执行 dsh plugin --profile web remove @anionex/dsh-computer-use（Headless Profile 同理）。卸载会注销 Skill 和工具、释放进程级观察和确认令牌、关闭存储域句柄；之前生成的截图文件和 computer_use_state 侧车文件需要你手动清理。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: ^22.19.0 || >=24.0.0
• Native modules: native/macos/bin/dsh-computer-use-helper (ad-hoc-signed universal Swift binary)

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则