场景自动化 — 用户手册 | YoBench

「场景自动化」模块的用途

该模块是一个面向自动化的可视化节点图构造器:您将块连接成图,引擎按顺序或并行执行;对浏览器块,通过 Puppeteer 控制 Chromium,并在 YoBench 中提供实时预览。适用于 RPA 场景:带交互的抓取、自动注册、压力流、数据迁移、含条件逻辑的动作链。

您将获得:

• 44 种块类型,分布在 11 个类别。
• 并行执行 —— parallelSplit / parallelJoin 分叉与汇合。
• 条件逻辑 —— ifElse、loop、switch。
• 浏览器自动化 —— Puppeteer 控制,带反检测画像(User-Agent、viewport、locale、timezone、geolocation、WebGL/Canvas/WebRTC noise)。
• 实时预览 —— 活动标签页的 JPEG 帧流式传输到 YoBench 窗口。
• 调试 —— 从任意节点单步执行(scenarios:debug-start)。
• 运行历史 —— scenario_runs(线程/错误计数)、scenario_executions(按块的批量日志)、scenario_template_snapshots(图版本)。

块类别(共 44 个)

• Flow(7) —— start、end、badEnd、delay、note、parallelSplit、parallelJoin。
• Logic(3) —— ifElse、loop、switch。
• Data(7) —— setVariable、logMessage、fileRead、fileWrite、random、textProcess、globalVariable。
• Network(3) —— httpRequest、cookieSync、captchaSolve。
• Browser(13) —— navigate、click、setValue、getValue、waitFor、screenshot、evaluate、pageData、tabSettings、fileUpload、requestIntercept、dialogHandler、dialogWait。
• Emulation(4) —— mouseMove、keyboard、scroll、touchEvent。
• Email(2) —— sendMail、receiveMail。
• Code(1) —— javascript(沙箱中的任意 JS)。
• Database(1) —— sqlQuery。
• FTP(2) —— ftpUpload、ftpDownload。
• Proxy(2) —— proxyRotate、proxyCheck。
• Project(2) —— runSubScenario、setProfile。

场景参数

• 图 —— 节点与边,序列化为 JSON。
• 浏览器画像 —— User-Agent、viewport、locale、timezone、geolocation、fingerprint 噪声。
• 并发(thread_count)—— 并行副本数。
• 重复(execution_count)—— 执行次数。
• 超时(run_timeout)。

中心设置中没有 scenarios* 键 —— 参数保存在每个场景中(scenarioSettings)。

触发

• 手动 —— 运行 按钮或 IPC scenarios:start 带 templateId。
• 调试 —— scenarios:debug-start,可从任意节点(startNodeId)开始。

实时预览与调试

• 预览 —— scenarios:start-preview 连接到所选 Chromium 标签页;帧通过 IPC scenarios:preview-frame 以 base64 JPEG 发送。
• 单步调试 —— 按块执行,可检查变量与浏览器状态。

存储与日志

• scenario_runs —— 状态、起止时间、线程与错误计数。
• scenario_executions —— 每个块调用的批量日志,含 JSON 参数与结果。
• scenario_template_snapshots —— 图版本。

使用流程

1. 在左侧菜单打开 场景自动化 模块。
2. 创建场景,将块拖到画布上并连接。
3. 配置浏览器画像(User-Agent、viewport、...)。
4. 运行 —— 在实时预览中观察流程。
5. 使用 调试 —— 从任意节点单步执行。
6. 在 scenario_runs 历史中 对比执行。

下一步

• 场景可通过 runSubScenario 互相嵌套 —— 可复用子图。
• 静态站点请使用 Web Parser,SEO/Lighthouse 请使用 Site Audit —— Scenarios 用于需要交互的场景。
• 压力测试请使用 Load Testing。

帮助与反馈

希望支持 cron 触发、webhook 或模板市场?通过反馈表单联系我们。