跨源 iframe

DevBridge 支持读取和操作跨源 iframe 内的内容，包括 Out-of-Process iframe（OOPIF）。

支持的工具

以下工具可跨所有 frame 操作，包括跨源 frame：

• read_page — 无障碍树包含所有 frame 内容
• find — 跨所有 frame 搜索
• form_input — 可填写 iframe 内的输入框
• computer（click、hover）— 可与 iframe 内元素交互
• file_upload — 支持 iframe 内的文件输入框
• javascript_exec — 可在指定 frame 中执行

元素引用格式

iframe 内的元素使用三段式引用格式：

f{frameId}::s{hostBackendId}::ref_N

例如：f2::ref_5 指的是 frame 2 中的 ref_5 元素。

通过 read_page 获取无障碍树时，frame 元素会自动添加前缀，AI 工具可以精确引用。

OOPIF 回退机制

对于真正的跨源 Out-of-Process iframe，DevBridge 使用 chrome.scripting 注入作为回退方案，确保在 CDP 无法直接访问 frame 时也能正常工作。