脚本编辑
脚本示例与最佳实践
通过典型场景说明动作组合、变量命名、失败兜底和发布前自检方法。
让 AI 先学习脚本规则
在让 AI 生成示例脚本前，建议先把“AI 编写脚本规则”复制给 AI。这样 AI 会知道当前编辑器支持哪些动作、字段、结构节点和通用配置，减少生成不存在能力的情况。
- 先提供脚本目标、目标应用、页面流程和失败兜底要求。
- 要求 AI 输出动作节点、结构节点、字段值和通用配置。
- 要求 AI 标注需要用户手动取点、取图、选控件的位置。
示例一：等待按钮出现后点击
适合登录后加载、弹窗延迟出现、列表刷新后按钮才可点击的场景。不要直接固定等待几秒后点击，建议使用识别或条件判断确认按钮已经出现。
- 先执行截图识别，查找目标按钮。
- 识别成功后点击识别结果中心点。
- 识别失败时等待一小段时间并重试。
- 超过最大重试次数后写入日志并停止，避免误点。
示例二：滑动列表查找目标
适合商品列表、联系人列表、设置列表等内容长度不固定的页面。脚本可以使用循环结构，每次识别目标，找不到则滑动一屏后继续。
- 设置最大滑动次数，避免无限循环。
- 每次滑动后加入短延迟，等待页面稳定。
- 找到目标后立即跳出循环。
- 找不到时给出运行日志，方便用户知道失败原因。
示例三：变量驱动的延迟和重试
当不同设备或网络环境加载速度不同，可以把延迟时间、最大重试次数、目标关键字等配置为变量。这样脚本作者可以提供默认值，用户也可以按设备情况调整。
- 变量名应清晰，例如 delay_ms、max_retry、target_text。
- 变量默认值应保守，避免过短导致动作抢跑。
- 从变量读取失败时，应有固定值兜底或明确错误提示。
发布前自检清单
脚本发布到脚本库前，应尽量完成基础自检。自检不是为了让脚本适配所有设备，而是让用户知道适用范围、权限要求和可能风险。
- 标题和简介能清楚说明脚本用途。
- 注明目标应用版本、屏幕方向、分辨率基准和所需权限。
- 关键步骤有等待、识别或失败兜底。
- 不包含诱导违法、侵犯隐私、绕过安全限制或恶意操作内容。
- 本机至少完整运行一遍，并查看运行日志无明显异常。