脚本是什么

脚本是一组按顺序执行的自动化步骤。它可以模拟点击、滑动、等待、输入、识别、判断和循环等操作，帮助用户重复完成明确、可控的流程。

脚本适合处理规则稳定的操作，不适合替代用户做无法确认后果的高风险决策。涉及支付、账号安全、隐私内容或不可逆操作时，应谨慎运行。

编辑器组成

脚本编辑器由动作列表、结构节点、属性面板、运行控制和日志区域组成。用户可以通过点击、滑动、延迟、识别、条件、循环等节点编排自动化流程。

动作列表体现脚本执行顺序；属性面板配置每个节点的参数；运行日志用于观察实际执行过程。

• 动作节点：执行具体操作，例如点击、滑动、延迟、输入、截图识别。
• 结构节点：组织流程，例如条件、循环、分组、失败分支。
• 属性面板：配置动作参数，例如坐标、延迟、变量名、识别区域。
• 运行日志：记录耗时、失败原因、变量值和执行轨迹。

属性面板与变量

动作参数在属性面板中配置。部分字段支持固定值或从变量读取，例如延迟时间、坐标、识别结果、重试次数等。使用变量时应保证变量名存在且含义清晰，避免脚本运行时读取不到预期值。

变量适合抽出可调整参数，例如 delay_ms、max_retry、target_text。不要把所有字段都变量化，否则脚本会难以维护。

• 固定值适合稳定参数，配置简单、可读性强。
• 变量值适合需要用户或流程动态调整的参数。
• 变量名应使用英文、数字和下划线，并表达具体用途。

Activity 编辑器与悬浮编辑器

Activity 编辑器适合完整编辑、查看属性和整理脚本结构；悬浮编辑器适合在目标应用上方边观察边调整。两者面向的场景不同，运行表现也可能受系统后台策略影响。

• 结构调整、批量编辑和查看文档时，优先使用 Activity 编辑器。
• 校准坐标、观察页面、快速运行时，悬浮编辑器更直观。
• 如果悬浮编辑器卡顿或被系统隐藏，优先检查悬浮窗和后台权限。