【免费下载链接】OrbitalContext is yours. Agents are replaceable.项目地址https://gitcode.com/gh_mirrors/orbital10/Orbital点击查看免费下载Orbital 是一个开源的 AI agent 操作系统其内置的浏览器自动化模块基于 PatchrightPlaywright 的反检测增强分支为 AI agent 提供 26 种浏览器操作配合多层反检测指纹伪装、失败自愈与搜索引擎回退机制让 agent 能稳定地浏览网页、填写表单、抓取内容而不被反爬系统拦截。本文带你完整看懂这套浏览器自动化是怎么设计的。三层架构谁负责什么Orbital 的浏览器能力拆成三层职责清晰层级模块职责工具层browser.py定义 26 种 action参数校验、错误翻译、批量执行管理层browser_manager.pyPatchright 浏览器生命周期、页面/标签管理、崩溃恢复安全层browser_safety.pyURL 白名单、SSRF 防护、敏感信息脱敏工具层最关键的设计是snapshot ref工作流agent 先调用snapshot获取页面可访问性树accessibility tree得到一份带编号如e5的元素清单后续所有点击、输入都通过 ref 定位元素而不是脆弱的 CSS 选择器。这套机制实现在 browser_refs.py 中。26 种浏览器操作全拆解完整 action 枚举见 browser.py L308-L316按用途可以分为七组 导航类4 种操作作用细节navigate打开 URL导航前后各做一次 URL 安全校验并检测登录框/验证码等阻断信号go_back/go_forward前进后退自动清理旧 ref 并重新截图reload刷新页面等待 networkidle 稳定后再返回️ 交互类9 种click、type、fill、press、hover、select、scroll、drag、upload_file。fill支持一次填充多个表单字段且能识别secret:gmail.email这类占位符自动从凭据库替换真实值密码不会以明文进入对话记录browser.py L727-L781upload_file只允许上传工作区内的文件路径越权会被直接拒绝这 9 种属于写操作BROWSER_WRITE_ACTIONS见 browser.py L149-L152在低自主模式下会触发人工审批️ 观察类5 种snapshot可访问性树、screenshot截图支持红框标注 ref 的 annotate 模式、extract纯文本抽取1 万字符截断、search_page页内元素/文本搜索、evaluate执行任意 JS。⏳ 等待类1 种 6 模式wait支持按秒数、文字出现、文字消失、CSS 选择器、URL 模式、加载状态六种条件等待browser.py L1208-L1240避免页面没渲染完就操作的经典 bug。 联网搜索与抓取2 种search一次调用即完成开新标签 → 搜索 → 抽取前 10 条结果 → 关标签fetch则是把某个网页的正文抽成纯文本5 万字符截断相当于一个带渲染能力的网页阅读器。️ 标签页管理3 种tab_new、tab_switch、tab_close 输出与收尾2 种pdf页面存为 PDF、done标记任务完成基于 Patchright 的反检测机制为什么能绕过反爬这是本文的重点。Orbital 用的是patchright而非原生 Playwright——它是 Playwright 的 drop-in 替代品内置了反自动化检测补丁见 browser_manager.py L27-L31。在这之上还有三层主动伪装1. Stealth 注入脚本每个页面加载时都会执行一段 stealth JS_STEALTH_JS覆盖 Patchright 没处理的指纹点navigator.webdriver→undefined最经典的自动化特征navigator.plugins→ 模拟 5 个插件无插件是 headless 的典型特征补齐window.chrome.runtime/chrome.app对象真实 Chrome 才有navigator.languages按启动 locale 动态填充比如zh-CN环境就是[zh-CN, zh, en-US, en]——因为中文界面却报英文语言列表本身就是自动化指纹2. 指纹自洽locale 与时区必须互相吻合一个常见坑是浏览器上下文是zh-CN时区却报美国东部——这种矛盾比单个错误更招摇。Orbital 的 时区检测链 会依次尝试 tzlocal → Windows 注册表 → UTC 偏移兜底兜底值也跟随 localezh-CN必得Asia/Shanghai。对应测试见 test_browser_anti_detection.py。3. 干净的启动参数Chrome flags 中显式带上--disable-blink-featuresAutomationControlled、--disable-infobars等参数CHROME_FLAGS并在启动时丢弃默认的--enable-automation标志从源头去掉自动化标识。稳定干活的关键失败不是终点是信号绕过检测只是第一步真正稳定干活靠的是这套容错设计失败追踪 硬性熔断_track_result 会记录每种操作的连续失败次数——连续失败 3 次就在结果里附加提醒失败 5 次直接返回BLOCKED强制 agent 换策略直接访问 URL、改用search或fetch而不是无限重试烧 token。过期 ref 自动失效元素定位超时时_invalidate_stale_ref 会把失效的 ref 从映射表里删掉让下次操作快速失败逼 agent 重新 snapshot避免拿着陈旧引用反复撞墙。浏览器三级回退启动时依次尝试系统 Chrome → 系统 Edge → 内置 Chromiumbrowser_manager.py L554-L570任何一台机器都能跑起来。搜索引擎双引擎回退根据 locale 自动选主引擎——中国大陆环境用必应中国版无需代理可达其余环境用 Google主引擎不可达时自动切到另一引擎抽取选择器失效时还会降级为整页 snapshot 兜底browser.py L261-L277。崩溃自愈浏览器进程意外挂掉时daemon 检测到 CDP 连接断开会自动重启并重建上下文项目页面状态尽量保留。安全护栏自动化不等于失控反爬能力越强越需要缰绳。Orbital 内置了几道护栏SSRF 防护validate_url_pre_navigation 在导航前解析域名并拦截指向127.0.0.0/8、10.0.0.0/8、192.168.0.0/16等内网地址的 URL导航后还会二次校验防止开放重定向跳回内网不信任内容包裹网页正文属于不可信内容wrap_untrusted_content会给它加上明确的边界标记降低提示注入风险审批分级交互类写操作会按 autonomy preset 决定是否暂停等待用户批准批量执行到写操作时自动PAUSED并挂起剩余动作browser.py L1367-L1387配合定时任务7×24 无人值守的浏览器工作流浏览器自动化真正的价值在于长期跑。Orbital 的 Triggers 支持定时、文件监听等触发方式把每天早 9 点用浏览器抓一轮数据并汇总这类任务写成自然语言 prompt 即可配合 sub-agent 派发浏览器任务可以委派给独立 worker 并行执行主会话不被阻塞。小结26 种操作覆盖导航、交互、观察、等待、搜索、标签页全场景snapshot ref 机制替代脆弱选择器三层反检测Patchright 补丁 stealth 注入 locale/时区指纹自洽从指纹层面降低被识别概率稳定性靠设计失败熔断、过期 ref 失效、浏览器三级回退、双搜索引擎兜底、崩溃自愈安全兜底SSRF 防护、内容隔离、写操作审批自动化能力再强也踩不到红线想进一步了解的读者可以从 browser.py、browser_manager.py 两个入口读起整体浏览器能力介绍也可参考 README.zh-CN.md。赞分享【免费下载链接】OrbitalContext is yours. Agents are replaceable.项目地址https://gitcode.com/gh_mirrors/orbital10/Orbital点击查看免费下载相关推荐如何轻松绕过反爬虫系统Camoufox反侦测浏览器完全指南如何轻松绕过反爬虫系统Camoufox反侦测浏览器完全指南 在当今数据驱动的互联网时代网络爬虫技术面临着前所未有的挑战。随着反爬虫系统的不断升级传统的数据网页爬虫AI Agent人工智能ng-lightning主题定制与样式覆盖个性化Lightning Design System的终极指南ng lightning主题定制与样式覆盖个性化Lightning Design System的终极指南 想要为你的Angular应用打造独特的视觉体验吗nSeleniumBase UC Mode 实战指南基于 Undetected-Chromedriver 的反爬绕过与 CAPTCHA 自动化SeleniumBase UC Mode 实战指南基于 Undetected Chromedriver 的反爬绕过与 CAPTCHA 自动化 导读 UC Mo测试质量保障网页爬虫上一篇告别繁琐集成Any4any7大AI能力一站式API服务平台深度测评下一篇【热门开源项目下载】cq-bot QQ机器人开发框架指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考