前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在本地开发或使用场景中，让智能体直接操作桌面环境是一个常见需求。dsh-mac-control 是一个原生 macOS 插件，它将 DeepSeek Harness 的能力延伸到了浏览器标签页和本地桌面应用的操作上，无需搭建额外的服务。
核心功能¶
该插件提供两类工具，分别针对浏览器和桌面环境：
mac_browser：控制 Safari 和 Google Chrome 的标签页。mac_desktop：读取和操作本地应用、窗口及辅助功能控件，支持截取屏幕。- 通用交互：支持输入文字、点击、按键以及屏幕截图。
安装¶
使用官方提供的命令安装插件：
dsh plugin --profile web add dsh-mac-control
使用方法¶
安装完成后，需要重启 web profile 并指定使用的工具：
- 重启 web profile。
- 告诉 Harness 使用
mac_browser或mac_desktop。 - 首次使用时，在 macOS 系统中批准 Harness 进程所需的权限（包括自动化、辅助功能、屏幕录制）。
实现与安全机制¶
该插件采用原生 macOS 能力实现，而非通过 HTTP 服务或代理：
- 实现方式：不启动 HTTP 服务器，不代理浏览器流量，也不存储任何凭据。经过校验的请求会被传递给 macOS 的
osascript（JXA/System Events）、open和screencapture执行。 - 权限管理：权限由 macOS 的自动化、辅助功能和屏幕录制设置统一管理。
- 安全默认值：
- 仅允许
http/https地址。 - 浏览器和桌面目标支持白名单配置。
- 文本长度和坐标会进行校验。
- 明确禁止发送密码、API Key、Cookie 或恢复码。
- 仅允许
结语¶
dsh-mac-control 为 DeepSeek Harness 提供了直接操作 macOS 本地环境的能力。通过利用原生的 osascript 和系统权限，它在不增加额外基础设施负担的同时，实现了安全的桌面控制。该插件遵循 MIT 许可证，代码托管在 GitHub 上。
