desktop-operator

---

name: desktop-operator description: Operate Electron desktop applications on macOS via Puppeteer CDP. Open an app, find a UI element by text, click it, and take a screenshot.

---

desktop-operator

通过 Puppeteer CDP 连接 Electron 桌面应用，自动完成打开应用、点击指定文本元素、截图的操作。

适用场景

用于自动化本地 Electron 应用（如各类管理后台、工具软件）。

示例触发语：

打开 DaveBella 应用，点击订单中心，然后截图

打开 xx 应用，点击顶部的订单中心

打开 xx 应用，进入数据分析页面截图

---

Parameters

| 参数 | 说明 | |------|------| | --app | 应用名称，即 /Applications/ 下 .app 文件名（不含 .app） | | --target | 要点击的元素文本内容 |

---

Execution

node dist/index.js --app "{appName}" --target "{targetText}"

示例：

node dist/index.js --app "DaveBella" --target "订单中心"

---

Output

成功后输出 JSON：

{ "screenshot": "/tmp/desktop_operator_skill_xxxxxxxxx.png" }

截图路径即为操作完成后的页面截图，可直接展示给用户。

---

注意事项

仅适用于 Electron 应用

应用需安装在 /Applications/ 目录下

首次使用需在「系统设置 → 隐私与安全性 → 辅助功能」中授权 Terminal