脚本节点的基本组成

WeMod 脚本由 ActionBlock 承载节点列表，节点分为动作节点和结构节点。动作节点封装一个 ScriptAction，并可附加 ActionConfig 通用配置；结构节点负责条件、循环、变量、跳转、子流程、失败兜底和事件响应。

AI 生成脚本时，应先判断用户需求属于“要做什么动作”，还是“如何组织流程”。具体操作放动作节点；分支、循环、重试和兜底放结构节点或 ActionConfig。

• ActionNode.Action：执行一个原子动作，例如点击、滑动、输入、识别或提示。
• ActionNode.If / VarSwitch：根据条件或变量走不同分支。
• ActionNode.Repeat / WhileVar / WhileVision：用于重复执行，必须设置次数、超时或最大迭代。
• ActionNode.TryCatch / Race：用于失败兜底和并行竞速。
• SetVar / IncVar / Label / Goto / SubFlow：用于变量、跳转和流程复用。

所有节点的通用元信息

结构节点和动作节点都带有基础可维护字段，文档和 AI 输出时建议保留这些概念，方便用户在编辑器里查找、调试和理解。

• enabled：是否启用节点；禁用后不参与运行。
• id：节点唯一标识，适合跳转、事件、动作状态判断和调试定位。
• displayName：用户可读名称，建议给关键节点写清楚，例如“等待首页加载”。
• comment：备注说明，适合写风险、前置条件、调试提示。
• jumpLabel：跳转标签辅助字段；复杂脚本优先使用明确的 Label 节点。

AI 生成脚本的总原则

AI 不应该只给一句“点击按钮”，而应输出可以在编辑器中录入的节点方案：节点类型、关键字段、通用配置、失败处理和调试建议。

• 优先选择稳定定位：控件选择器 > 视觉识别 > 百分比坐标 > 固定像素坐标。
• 页面加载不确定时，不要只堆固定延迟；应使用等待节点、视觉判断或控件等待。
• 循环必须有退出条件，例如 maxScrolls、maxIterations、timeoutMs。
• 需要给用户调整的数值使用变量，例如 delay_ms、retry_count、search_text。
• 禁止生成 Hook、注入、破解、绕过检测、读取隐私或控制未授权设备的方案。