「界面(surface)」是 agent-desktop 里能被寻址、被快照、被操作的一块区域。
--app、--window-id、--root 这些参数做的事情都只有一个:把目标收窄到一个界面。
列出来
agent-desktop list-surfaces # 这个平台上当前可寻址的界面
agent-desktop list-apps # 在运行的应用
agent-desktop list-windows # 某个应用的窗口
agent-desktop list-displays # 显示器外壳界面
除了应用窗口,桌面外壳自己画的那一层也是界面:macOS 的 Dock 和菜单栏附加项、 Windows 的任务栏与通知区域、Linux 的 GNOME 托盘和操作中心。它们不属于任何应用窗口, 所以单独用一条命令打开:
agent-desktop open-system-surface --help--help 会列出你这个平台支持的界面名称。平台之间的差别见平台支持。
通知
通知是另一类独立界面:它由系统投递,读完之后要么关掉某一条,要么一次性清空。
agent-desktop list-notifications
agent-desktop dismiss-notification # 关掉一条
agent-desktop dismiss-all-notifications # 清空
agent-desktop notification-action # 触发通知上的动作界面与 Chromium / Electron
agent-desktop 只负责桌面应用这一层:它读操作系统的可访问性树。网页内容请用
agent-browser,它走 Chrome DevTools 协议,
把页面读成带 @e1 这类 ref 的文本。两者可以接力:对于你自己启动的 Chromium 或 Electron
应用里的网页内容,agent-desktop 会开一个 DevTools 端口,让 agent-browser 用 --cdp 连上去。