【免费下载链接】heymBuild agentic systems. Run them with confidence. Orchestrate agents, automate business processes, inspect every execution, and keep humans in control. Deploy Heym on your own infrastructure.项目地址https://gitcode.com/gh_mirrors/he/heym点击查看免费下载Heym 是一个可以部署在自己基础设施上的开源 Agent 工作流编排平台其中的 Playwright 节点提供了开箱即用的浏览器自动化能力可视化步骤、AI 自然语言步骤以及 Auto Heal 自愈选择器。当你用爬虫采集数据时页面一次改版就能让写死的 CSS 选择器集体失效Heym 的 Auto Heal 会在选择器连续失败后自动调用 LLM 分析当前页面 HTML 与截图替换为更稳健的 role/text 定位器让爬虫在页面结构变化时自己修复自己。为什么爬虫最怕选择器腐烂传统爬虫脚本的脆弱点几乎都集中在选择器上网站改版换了 class 名.btn-primary一夜之间全部失效动态渲染导致元素出现时间不确定点击落空页面结构微调后采集脚本大面积报错却无人知晓Heym 的 Playwright 节点把这些高频故障场景做成了平台能力而不是让你自己写一堆 try/except。核心源码位于 playwright_node.pyAI 步骤与自愈逻辑由 playwright_code_generator.py 生成。快速开始部署 Heym 并打开画布本地启动非常简单只需准备 Bun、Python 3.11、UV 和 Dockergit clone https://gitcode.com/gh_mirrors/he/heym cd heym ./run.sh启动后访问 http://localhost:4017 创建账号进入可视化画布。左侧节点面板中选中 Playwright 节点拖入画布即可开始搭建浏览器自动化流程生产环境可以使用 Docker Compose 一键部署cp .env.example .env ./deploy.sh详见 ENVIRONMENT-VARIABLES.md。用可视化步骤组装浏览器操作点击 Playwright 节点在右侧属性面板中用 Add Step 逐步添加动作每一步都可以单独开启/关闭关闭的步骤保留在列表中但运行时跳过方便定位问题而不删除工作成果。常用步骤类型步骤作用navigate打开 URL支持表达式如$userInput.body.urlclick / type / fill点击、逐字输入、填充表单getText / getHTML / getAttribute采集元素文本、HTML、属性getVisibleTextOnPage采集整页可见文本整页正文提取神器scrollDown / scrollUp / wait / refresh滚动、等待、刷新screenshot截图base64 存入 resultsaiStepAI 自然语言步骤下节重点完整参数说明见官方文档 playwright-node.md。运行工作流后每个步骤的输出通过outputKey存入$节点名.results后续节点可直接引用Auto Heal 自愈选择器AI 三步挽救失败的选择器这是本文的主角。在 aiStep 属性中勾选Auto heal mode后Heym 的自愈流程是某个选择器动作click/type/fill/hover/selectOption连续失败 2 次后触发自愈Heym 抓取当前页面的 HTML 与截图连同失败步骤一起发送给 LLMLLM 返回一个更稳健的替代定位器通常是rolebutton[nameSubmit]或textExact text这类文本/角色定位器而不是脆弱的 CSS 路径用新选择器立即重试流程继续执行对应的自愈提示词与接口在 playwright.py 中定义LLM 被约束只能返回 click、type、fill、hover、selectOption 这五类交互动作保证替换结果可执行。自愈的代价极低——只在失败时才会多一次 LLM 调用成功路径零额外开销。步骤缓存 截图理解把 AI 步骤成本压到最低配合两个开关AI 步骤可以做到偶尔调用 LLM平时白嫖缓存Save steps for future usagessaveStepsForFuture第一次由 LLM 生成的步骤会被写回节点保存后续运行直接复用缓存步骤不再调用 LLM见 playwright.py。页面没变就不花钱页面变了再由 Auto Heal 兜底Send screenshot to LLMsendScreenshot把页面截图一并发给 LLM对视觉型元素图片按钮、Canvas 区域的定位明显更准抗检测与登录态让爬虫更像真实用户Heym 还在两个爬虫老难题上做了内建支持Reduce automation flagsplaywrightStealth移除--enable-automation等自动化特征、去掉 User Agent 里的HeadlessChrome、补齐window.chrome与插件指纹减少被反爬识别为脚本的概率Cookie Bootstrap 登录态恢复启用 Auth Bootstrap 后Heym 先从存储的storageState或 cookies 恢复登录检查指定选择器确认登录成功如果恢复失败自动执行你配置的 Fallback 登录步骤。官方推荐的用法是先跑一次带网络捕获的节点把$节点名.cookies存进全局变量后续节点通过$global.authState复用登录态运行后如何验证输出字段与 Traces 面板一次运行结束后Playwright 节点的输出字段非常直白$playwrightNode.status——ok表示成功$playwrightNode.results—— 各步骤的采集结果getText、screenshot 等$playwrightNode.screenshot—— 截图base64$playwrightNode.cookies/$playwrightNode.networkRequests—— 开启登录态或网络捕获时的附加数据AI 步骤的每次 LLM 调用请求、响应、耗时、token 成本都可以在 Traces 页面完整追踪排查自愈是否触发一目了然常见问题 FAQQ1纯步骤模式不用 AI也有 Auto Heal 吗Auto Heal 依赖 LLM只在 aiStep 上生效。纯手动步骤中某个选择器失效时可以用每步的开关先隔离该步骤再修正选择器。Q2AI 步骤会一直调 LLM 吗不会。勾选 Save steps for future usages 后后续运行直接复用缓存步骤跳过 LLM 调用只有缓存步骤失效且开启 Auto Heal 时才会额外调用一次。Q3能不能直接写 Playwright Python 代码可以把 Mode 切到 Run Code 即可。但自定义代码属于任意 Python 执行默认关闭需管理员设置HEYM_PLAYWRIGHT_CUSTOM_CODE_ENABLEDtrue启用启用后运行在 Heym 的加固沙箱容器中。日常使用推荐步骤模式。延伸阅读Playwright 节点完整文档playwright-node.mdCrawler 节点基于 FlareSolverr 的轻量抓取crawler-node.md为什么选择 Heymwhy-heym.md节点类型总览node-types.md赞分享【免费下载链接】heymBuild agentic systems. Run them with confidence. Orchestrate agents, automate business processes, inspect every execution, and keep humans in control. Deploy Heym on your own infrastructure.项目地址https://gitcode.com/gh_mirrors/he/heym点击查看免费下载相关推荐Stagehand终极指南精通AI浏览器自动化Stagehand终极指南精通AI浏览器自动化 痛点传统自动化 vs AI代理的困境 还在为浏览器自动化而头疼吗传统框架如Playwright需要编写脆弱人工智能AI Agent浏览器控制AI 评测LLMOpsPlaywright MCP Server 浏览器自动化实战指南Playwright MCP Server 浏览器自动化实战指南 Playwright MCP Server 是一个基于 Playwright 的浏览器自动化工MCP 服务浏览器控制AI 应用Stats macOS 菜单栏系统监视器实战指南如何装好 10 个监视模块并用上远程监控Stats macOS 菜单栏系统监视器实战指南如何装好 10 个监视模块并用上远程监控 Stats 是一款运行在 macOS 菜单栏的免费开源系统监视器装桌面应用指标监控可观测性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/15 22:16:02 · 阅读 1.2k Heym Playwright 浏览器自动化实战：Auto Heal 自愈选择器让爬虫不脆弱
【免费下载链接】heymBuild agentic systems. Run them with confidence. Orchestrate agents, automate business processes, inspect every execution, and keep humans in control. Deploy Heym on your own infrastructure.项目地址https://gitcode.com/gh_mirrors/he/heym点击查看免费下载Heym 是一个可以部署在自己基础设施上的开源 Agent 工作流编排平台其中的 Playwright 节点提供了开箱即用的浏览器自动化能力可视化步骤、AI 自然语言步骤以及 Auto Heal 自愈选择器。当你用爬虫采集数据时页面一次改版就能让写死的 CSS 选择器集体失效Heym 的 Auto Heal 会在选择器连续失败后自动调用 LLM 分析当前页面 HTML 与截图替换为更稳健的 role/text 定位器让爬虫在页面结构变化时自己修复自己。为什么爬虫最怕选择器腐烂传统爬虫脚本的脆弱点几乎都集中在选择器上网站改版换了 class 名.btn-primary一夜之间全部失效动态渲染导致元素出现时间不确定点击落空页面结构微调后采集脚本大面积报错却无人知晓Heym 的 Playwright 节点把这些高频故障场景做成了平台能力而不是让你自己写一堆 try/except。核心源码位于 playwright_node.pyAI 步骤与自愈逻辑由 playwright_code_generator.py 生成。快速开始部署 Heym 并打开画布本地启动非常简单只需准备 Bun、Python 3.11、UV 和 Dockergit clone https://gitcode.com/gh_mirrors/he/heym cd heym ./run.sh启动后访问 http://localhost:4017 创建账号进入可视化画布。左侧节点面板中选中 Playwright 节点拖入画布即可开始搭建浏览器自动化流程生产环境可以使用 Docker Compose 一键部署cp .env.example .env ./deploy.sh详见 ENVIRONMENT-VARIABLES.md。用可视化步骤组装浏览器操作点击 Playwright 节点在右侧属性面板中用 Add Step 逐步添加动作每一步都可以单独开启/关闭关闭的步骤保留在列表中但运行时跳过方便定位问题而不删除工作成果。常用步骤类型步骤作用navigate打开 URL支持表达式如$userInput.body.urlclick / type / fill点击、逐字输入、填充表单getText / getHTML / getAttribute采集元素文本、HTML、属性getVisibleTextOnPage采集整页可见文本整页正文提取神器scrollDown / scrollUp / wait / refresh滚动、等待、刷新screenshot截图base64 存入 resultsaiStepAI 自然语言步骤下节重点完整参数说明见官方文档 playwright-node.md。运行工作流后每个步骤的输出通过outputKey存入$节点名.results后续节点可直接引用Auto Heal 自愈选择器AI 三步挽救失败的选择器这是本文的主角。在 aiStep 属性中勾选Auto heal mode后Heym 的自愈流程是某个选择器动作click/type/fill/hover/selectOption连续失败 2 次后触发自愈Heym 抓取当前页面的 HTML 与截图连同失败步骤一起发送给 LLMLLM 返回一个更稳健的替代定位器通常是rolebutton[nameSubmit]或textExact text这类文本/角色定位器而不是脆弱的 CSS 路径用新选择器立即重试流程继续执行对应的自愈提示词与接口在 playwright.py 中定义LLM 被约束只能返回 click、type、fill、hover、selectOption 这五类交互动作保证替换结果可执行。自愈的代价极低——只在失败时才会多一次 LLM 调用成功路径零额外开销。步骤缓存 截图理解把 AI 步骤成本压到最低配合两个开关AI 步骤可以做到偶尔调用 LLM平时白嫖缓存Save steps for future usagessaveStepsForFuture第一次由 LLM 生成的步骤会被写回节点保存后续运行直接复用缓存步骤不再调用 LLM见 playwright.py。页面没变就不花钱页面变了再由 Auto Heal 兜底Send screenshot to LLMsendScreenshot把页面截图一并发给 LLM对视觉型元素图片按钮、Canvas 区域的定位明显更准抗检测与登录态让爬虫更像真实用户Heym 还在两个爬虫老难题上做了内建支持Reduce automation flagsplaywrightStealth移除--enable-automation等自动化特征、去掉 User Agent 里的HeadlessChrome、补齐window.chrome与插件指纹减少被反爬识别为脚本的概率Cookie Bootstrap 登录态恢复启用 Auth Bootstrap 后Heym 先从存储的storageState或 cookies 恢复登录检查指定选择器确认登录成功如果恢复失败自动执行你配置的 Fallback 登录步骤。官方推荐的用法是先跑一次带网络捕获的节点把$节点名.cookies存进全局变量后续节点通过$global.authState复用登录态运行后如何验证输出字段与 Traces 面板一次运行结束后Playwright 节点的输出字段非常直白$playwrightNode.status——ok表示成功$playwrightNode.results—— 各步骤的采集结果getText、screenshot 等$playwrightNode.screenshot—— 截图base64$playwrightNode.cookies/$playwrightNode.networkRequests—— 开启登录态或网络捕获时的附加数据AI 步骤的每次 LLM 调用请求、响应、耗时、token 成本都可以在 Traces 页面完整追踪排查自愈是否触发一目了然常见问题 FAQQ1纯步骤模式不用 AI也有 Auto Heal 吗Auto Heal 依赖 LLM只在 aiStep 上生效。纯手动步骤中某个选择器失效时可以用每步的开关先隔离该步骤再修正选择器。Q2AI 步骤会一直调 LLM 吗不会。勾选 Save steps for future usages 后后续运行直接复用缓存步骤跳过 LLM 调用只有缓存步骤失效且开启 Auto Heal 时才会额外调用一次。Q3能不能直接写 Playwright Python 代码可以把 Mode 切到 Run Code 即可。但自定义代码属于任意 Python 执行默认关闭需管理员设置HEYM_PLAYWRIGHT_CUSTOM_CODE_ENABLEDtrue启用启用后运行在 Heym 的加固沙箱容器中。日常使用推荐步骤模式。延伸阅读Playwright 节点完整文档playwright-node.mdCrawler 节点基于 FlareSolverr 的轻量抓取crawler-node.md为什么选择 Heymwhy-heym.md节点类型总览node-types.md赞分享【免费下载链接】heymBuild agentic systems. Run them with confidence. Orchestrate agents, automate business processes, inspect every execution, and keep humans in control. Deploy Heym on your own infrastructure.项目地址https://gitcode.com/gh_mirrors/he/heym点击查看免费下载相关推荐Stagehand终极指南精通AI浏览器自动化Stagehand终极指南精通AI浏览器自动化 痛点传统自动化 vs AI代理的困境 还在为浏览器自动化而头疼吗传统框架如Playwright需要编写脆弱人工智能AI Agent浏览器控制AI 评测LLMOpsPlaywright MCP Server 浏览器自动化实战指南Playwright MCP Server 浏览器自动化实战指南 Playwright MCP Server 是一个基于 Playwright 的浏览器自动化工MCP 服务浏览器控制AI 应用Stats macOS 菜单栏系统监视器实战指南如何装好 10 个监视模块并用上远程监控Stats macOS 菜单栏系统监视器实战指南如何装好 10 个监视模块并用上远程监控 Stats 是一款运行在 macOS 菜单栏的免费开源系统监视器装桌面应用指标监控可观测性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考