用途：自动化任意基于 Electron 的桌面应用。Electron 应用基于 Chromium，会暴露 Chrome DevTools Protocol（CDP）端口，agent-browser 可连接后复用与网页相同的快照—交互流程。
主要能力：启动应用时开启远程调试、连接 CDP 端口、快照发现可交互元素、按元素引用点击或填表、截图、提取文本、切换窗口与 webview、多应用并行会话、保留深色模式，并支持常见故障排查。
必要用法（保留原样）：
启动 Electron 应用并开启远程调试
open -a "Slack" --args --remote-debugging-port=9222
连接 agent-browser
agent-browser connect 9222 agent-browser snapshot -i agent-browser click @e5 agent-browser screenshot slack-desktop.png
也可用 agent-browser --cdp 9222 snapshot -i、agent-browser --auto-connect snapshot -i；连接后无需重复 --cdp。窗口/webview 管理：agent-browser tab、agent-browser tab 2、agent-browser tab --url "settings"。填表：agent-browser fill @e3 "search query"；agent-browser press Enter。截图：agent-browser screenshot --full full-app.png；agent-browser screenshot --annotate annotated-app.png。取数：agent-browser get text @e5；agent-browser snapshot --json > app-state.json。多应用会话：agent-browser --session slack connect 9222；agent-browser --session vscode connect 9223。深色模式：agent-browser --color-scheme dark snapshot -i，或 AGENT_BROWSER_COLOR_SCHEME=dark agent-browser connect 9222。
注意：--remote-debugging-port 必须在启动时提供，若应用已在运行需先退出再重启；不同平台命令不同（macOS 用 open -a，Linux 直接执行命令，Windows 使用完整 exe 路径）。
限制：资料未提供性能、收费、价格等数据；部分应用使用多个 webview，元素可能不出现在快照中，需先用 tab 切换；自定义输入组件无法直接输入时，可用 agent-browser keyboard type 或 agent-browser keyboard inserttext 绕过按键事件；连接失败时需检查端口占用（lsof -i :9222）并等待应用初始化（sleep 3）。