自我智能改进体（Self-Modifying Code）

代理浏览器技能 快速使用可访问性树快照和引用实现确定性元素选择的浏览器自动化。 为什么选择这个而不是内置的浏览器工具 使用代理浏览器时： 自动执行多步骤工作流 需要确定性元素选择 性能至关重要 处理复杂的单页应用程序 需要会话隔离 使用内置浏览器工具时： 需要截图/PDF用于分析 需要视觉检查 需要浏览器扩展集成 核心工作流

• 导航和快照

代理浏览器打开 https://example.com 代理浏览器快照 -i --json

• 解析引用并交互

代理浏览器点击 @e2 代理浏览器填充 @e3 "文本"

• 页面更改后重新快照

代理浏览器快照 -i --json 关键命令 导航 代理浏览器打开 代理浏览器后退 | 前进 | 重载 | 关闭 快照（始终使用 -i --json） 代理浏览器快照 -i --json 交互元素，JSON 输出 代理浏览器快照 -i -c -d 5 --json + 紧凑，深度限制 代理浏览器快照 -s "#main" -i 范围选择器 交互（基于引用） 代理浏览器点击 @e2 代理浏览器填充 @e3 "文本" 代理浏览器输入 @e3 "文本" 代理浏览器悬停 @e4 代理浏览器选中 @e5 | 取消选中 @e5 代理浏览器选择 @e6 "值" 代理浏览器按 "Enter" 代理浏览器滚动下 500 代理浏览器拖拽 @e7 @e8 获取信息 代理浏览器获取文本 @e1 --json 代理浏览器获取 HTML @e2 --json 代理浏览器获取值 @e3 --json 代理浏览器获取属性 @e4 "href" --json 代理浏览器获取标题 --json 代理浏览器获取 URL --json 代理浏览器获取数量 ".item" --json 检查状态 代理浏览器是否可见 @e2 --json 代理浏览器是否启用 @e3 --json 代理浏览器是否选中 @e4 --json 等待 代理浏览器等待 @e2 代理浏览器等待 1000 代理浏览器等待 -- 文本 "欢迎" 代理浏览器等待 -- URL "/dashboard" 代理浏览器等待 -- 加载 networkidle 代理浏览器等待 -- 函数 "window.ready === true" 会话（隔离浏览器） 代理浏览器 -- 会话 admin 打开 site.com 代理浏览器 -- 会话 user 打开 site.com 代理浏览器会话列表 或通过环境变量：AGENT_BROWSER_SESSION=admin 代理浏览器... 状态持久性 代理浏览器状态保存 auth.json 代理浏览器状态加载 auth.json 截图和PDF 代理浏览器截图 page.png 代理浏览器截图 -- 全部 page.png 代理浏览器 PDF page.pdf 网络控制 代理浏览器网络路由 "/ads/" -- 中止 代理浏览器网络路由 "/api/" -- 正文 '{"x":1}' 代理浏览器网络请求 -- 过滤器 API Cookie 和存储 代理浏览器 Cookie 代理浏览器 Cookie 设置名称值 代理浏览器存储本地键 代理浏览器存储本地设置键值 选项卡和框架 代理浏览器选项卡新建 https://example.com 代理浏览器选项卡 2 代理浏览器框架 @e5 代理浏览器框架主 快照输出格式 { "success": true, "data": { "snapshot": "...", "refs": { "e1": {"role": "heading", "name": "示例域"}, "e2": {"role": "button", "name": "提交"}, "e3": {"role": "textbox", "name": "电子邮件"} } } 最佳实践 始终使用 -i 标志 - 专注于交互元素 始终使用 --json - 更容易解析 等待稳定 - 代理浏览器等待 -- 加载 networkidle 保存身份验证状态 - 跳过登录流程 使用会话 - 隔离不同的浏览器上下文 使用 --headed 调试 - 查看发生了什么 示例：搜索和提取 代理浏览器打开 https://www.google.com 代理浏览器快照 -i --json AI 识别搜索框 @e1 代理浏览器填充 @e1 "AI 代理" 代理浏览器按 Enter 代理浏览器等待 -- 加载 networkidle 代理浏览器快照 -i --json AI 识别结果引用 代理浏览器获取文本 @e3 --json 代理浏览器获取属性 @e4 "href" --json 示例：多会话测试 管理员会话 代理浏览器 -- 会话 admin 打开 app.com 代理浏览器 -- 会话 admin 状态加载 admin-auth.json 代理浏览器 -- 会话 admin 快照 -i --json 用户会话（同时） 代理浏览器 -- 会话 user 打开 app.com 代理浏览器 -- 会话 user 状态加载 user-auth.json 代理浏览器 -- 会话 user 快照 -i --json 安装 npm 安装 -g 代理浏览器 代理浏览器安装 代理浏览器安装 --with-deps Linux：+ 系统依赖 鸣谢 技能由 Yossi Elkrief (@MaTriXy) 创建 代理浏览器 CLI 由 Vercel Labs 创建