用途：借助 playwright-cli 的 Chrome DevTools Protocol（CDP）附加模式，自动化任意基于 Electron 的桌面应用，复用与网页相同的快照—交互工作流，用于验证 UI 变更和测试。
主要能力：启动带远程调试端口的 Electron 应用并附加；snapshot 发现可交互元素；用元素 ref 点击、填写、按键；截图；eval 读取或修改状态；tab-list/tab-select 管理多窗口；run-code 执行自定义 Playwright 代码；用命名会话同时控制多个应用。
必要用法：启动时须带 --remote-debugging-port，例如 open -a "Slack" --args --remote-debugging-port=9222，然后 command playwright-cli attach --cdp="http://localhost:9222"，再 snapshot、click e5、screenshot。命令统一加 command 前缀以绕过 shell 别名。Orca 开发构建用 ORCA_BACKGROUND_LAUNCH=1 node config/scripts/run-electron-vite-dev.mjs --remote-debugging-port=$PORT，端口建议 9333 起并先用 lsof 检查占用。
限制与安全：切勿运行 killall Electron、pkill Electron 等宽泛杀进程命令，只能结束本会话中自己启动并记录 PID 的进程；退出命名应用用 osascript -e 'quit app "AppName"'，不要用于 Orca 或自身所在应用。应用须在启动时带调试端口，已运行需先退出再重启。元素 ref 会随状态变化，交互后需重新 snapshot。部分自定义输入组件可能无法直接输入，可改用 press 或 run-code。清理用 command playwright-cli close 或 close-all，不会结束 Electron 应用。具体支持范围与效果以实际环境为准。