Appearance
调试自动化流程
调试用于验证当前编辑器中的节点配置、变量、连线和页面操作。流程调试通过后，再保存流程并创建正式任务，可以减少批量执行时的影响范围。
实际浏览器自动化依赖中屹浏览器桌面客户端、本地执行器和本地通信服务，不能在普通网页环境中独立完成。
调试前检查
开始调试前，确认：
- 中屹浏览器桌面客户端和本地服务正在运行。
- 流程中的必填字段已经配置。
- 节点从开始流程出发形成正确的可执行路径。
- 页面地址、测试账号和测试数据可以使用。
- 已准备至少一个内核和当前平台兼容的浏览器环境。
对会提交表单、修改业务数据、上传文件或清除 Cookie 的流程，优先使用独立测试环境。
选择调试环境
首次点击调试时，需要选择一个浏览器环境。环境列表支持按环境名称和备注搜索，并可分页查看。
可用于调试的环境必须同时满足：
- 浏览器内核版本不低于
118。 - 内核版本位于当前操作系统平台的支持列表中。
不满足条件的环境无法用于调试。如果没有可用环境，且当前账号拥有对应权限，可以从提示入口前往创建环境。
选中的环境会在当前编辑会话中保留。需要改用其他账号、Cookie 或代理环境时，通过调试按钮的环境提示重新选择。
环境已经运行时，RPA Plus 会优先尝试复用现有连接；无法复用时，再准备新的 RPA Plus 运行环境。因此不需要把“调试前关闭环境”作为固定步骤。
| 图示状态 | 含义 | 处理方式 |
|---|---|---|
| 绿色框 | 内核不低于 118 且受当前平台支持。 | 可以直接选择并调试。 |
| 红色框 | 内核版本或平台支持条件不满足。 | 根据禁用原因改用或创建兼容环境。 |
调试完整流程
- 在流程编辑器中完成节点配置和连线。
- 点击工具栏中的调试图标。
- 首次调试时选择兼容环境。
- 等待校验完成并观察浏览器执行过程。
- 打开 调试日志 查看节点结果。
开始执行前，编辑器会校验节点字段和流程图结构，并把系统变量注入开始节点。存在错误时，相关节点会标红并自动聚焦，流程不会直接进入执行。
系统变量包括任务信息、浏览器环境信息、关联账号和 Cookie。账号与 Cookie 属于敏感数据，不要在测试脚本或日志文本中主动输出。
从指定节点开始调试
普通节点的浮动工具条提供从当前节点开始调试的入口。这种方式适合反复验证流程后半段，或快速检查单个页面操作。
从指定节点调试时：
- 只校验该节点及其后续可达路径。
- 该节点之前的普通节点不会执行。
- 上游普通节点原本会产生的变量不会生效。
- 开始流程节点中的全局变量仍会注入。
如果目标节点依赖登录、页面跳转或上游输出变量，应从能够建立这些前置状态的更早节点开始调试，或先在测试环境中准备好所需状态。
| 图示标记 | 含义 |
|---|---|
| 点击元素节点 | 当前节点及其后续可达路径会被校验和执行。 |
| "x"号 | 当前节点之前的普通节点不会执行，其输出变量不会产生。 |
| 开始节点箭头 | 开始流程节点中的全局变量仍会注入。 |
停止调试
调试运行期间，工具栏的调试按钮会变为停止按钮。点击后会向本地执行器发送停止请求。
停止请求发出后，界面需要等待本地执行器回推最终停止状态。按钮仍显示处理中时不要连续点击，也不要立即依据页面状态判断已经完全停止。
查看调试日志
日志抽屉显示当前或最近一次调试运行，提供：
- 按执行顺序查看节点日志。
- 全屏查看。
- 自动滚动到最新日志。
- 打开本地日志文件目录。
普通节点会显示对应执行消息。循环、IF、分组和异常分支使用结构化容器展示，可以展开相应层级查看内部节点，不会只显示为一组平铺文本。
查看日志时，从第一个异常或超时节点开始排查。后续错误有时只是前一个节点没有产生预期页面状态或变量导致的连锁结果。
| 编号 | 查看位置 | 说明 |
|---|---|---|
| 1 | 执行时间及节点名称/摘要 | 先按时间确认节点的实际执行顺序及执行内容。 |
| 2 | 当前执行节点 | 调试时会高亮当前执行节点，方便定位。 |
| 3 | 分组、循环、IF、FOR循环执行块 | 这些节点会按块展示执行内容。 |
| 4 | 异常错误 | 节点执行过程中发生异常后的报错信息。 |
| 5 | 全屏查看 | 可以全屏查看调试日志，展示完整日志内容。 |
| 6 | 关闭日志抽屉 | 可以关闭抽屉。 |
排查校验错误
调试前校验会检查：
- 节点必填字段。
- 变量名称和配置格式。
- 开始节点和可达路径。
- IF 的
True、False分支。 - 循环的
Loop Start、Loop End和回扣边。 - 普通节点的非法多个入口。
- 关闭环境等终止节点的出口。
先根据自动聚焦位置修复第一个错误，再重新调试。详细结构规则见使用流程编辑器。
排查执行异常
找不到页面元素
确认流程位于正确标签页、页面已经加载、选择器仍然有效。可以在操作前添加 等待元素出现，或改用更稳定的 Selector、XPath 和属性。
变量没有值
检查产生变量的节点是否已经执行，以及当前节点是否位于其下游。从中间节点调试时，上游普通节点输出不会产生。
调试环境不可选
检查内核版本是否低于 118，以及该版本是否受当前平台支持。如果没有符合条件的环境，创建或改用兼容环境。
点击停止后仍显示运行中
等待本地执行器返回停止事件。长时间没有变化时，检查桌面客户端和本地通信服务是否仍正常，再查看本地日志定位停止请求状态。
本地文件节点失败
确认运行电脑上的文件或目录存在，并且客户端具有读写权限。流程从其他电脑迁移后，本地绝对路径通常需要重新选择。
调试完成后
- 修正调试中发现的问题。
- 使用
Ctrl/Cmd + S保存并停留在编辑器，或点击保存返回列表。 - 再次调试关键路径，确认修改有效。
- 在任务管理中创建或更新正式任务。
正式任务使用已保存流程。未保存的编辑器修改不会成为可靠的任务执行版本。