前言¶
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 上。
