10标签
标签功能使用教程
概述
标签功能是脚本系统的核心组织工具，允许用户将相关的动作组织成逻辑分组，并为每个分组配置独立的执行策略。通过标签，可以实现分组随机执行、条件重试、智能流程控制等高级功能，让复杂的自动化脚本更加模块化和可控。
支持的功能
标签分组: 将动作按功能或逻辑分组管理
分组随机执行: 为分组设置执行概率，实现随机化控制
分组条件控制: 基于识别结果的智能重试和流程跳转
标签管理: 创建、重命名、删除、移动标签和动作
空标签: 支持预先创建标签用于后续规划
核心概念
标签 vs 动作组
| 特性 | 标签 | 动作组 |
|——|——|——–|
| 作用范围 | 脚本内的动作分组 | 独立的可复用模块 |
| 执行方式 | 随脚本顺序执行 | 通过调用动作执行 |
| 随机控制 | 支持分组级随机执行 | 支持调用级随机执行 |
| 条件控制 | 基于识别结果的重试机制 | 独立的条件配置 |
| 复用性 | 仅限当前脚本 | 可跨脚本复用 |
工作原理
分组执行: 脚本按动作顺序执行，遇到新标签时进行分组检查
随机判断: 根据标签的随机配置决定是否执行该分组
动作执行: 执行分组内的所有动作，收集识别结果
条件控制: 分组执行完成后，根据条件配置决定是否重试或跳转
流程继续: 完成当前分组后继续执行下一个分组
标签管理
创建标签
方法1: 从动作创建标签
在脚本编辑界面中：
选择一个或多个动作（长按选择）
点击底部工具栏的 “标签” 按钮
选择 “创建标签”
输入标签名称，如 “登录流程”、”主要操作”等
确认创建，选中的动作将被分配到新标签
方法2: 创建空标签
如果想要预先规划脚本结构：
点击右上角的 “⋮” 菜单
选择 “标签管理”
点击 “创建空标签”
输入标签名称
空标签将被创建，可在后续编辑中添加动作
标签操作
重命名标签
点击标签头部的 编辑图标
输入新的标签名称
确认修改
删除标签
点击标签头部的 删除图标
确认删除操作
标签内的动作将变为未分组状态
移动标签位置
使用标签头部的 上移/下移 按钮
调整标签在脚本中的执行顺序
标签位置由其第一个动作的位置决定
动作管理
添加动作到标签
选择要移动的动作
点击底部工具栏的 “标签” 按钮
选择目标标签
动作将被移动到指定标签
从标签移除动作
选择标签内的动作
点击底部工具栏的 “标签” 按钮
选择 “移除分组”
动作将变为未分组状态
在标签间移动动作
选择动作
点击 “标签” 按钮
选择新的目标标签
动作将从原标签移动到新标签
分组随机执行
功能说明
分组随机执行允许为每个标签设置执行概率，系统会在遇到新标签时进行随机判断，决定是否执行该标签内的所有动作。这个功能非常适合实现行为的随机化和多样性。
配置步骤
1. 进入标签配置界面
点击标签头部的 “设置” 图标（齿轮图标）
如果标签已配置，设置图标会显示为突出颜色
2. 启用随机执行
在弹出的配置对话框中：
找到 “分组随机执行” 区域
开启 “启用随机执行” 开关
设置 “执行概率”（0-100%）
3. 保存配置
点击 “确定” 保存配置
标签头部将显示执行概率信息
使用场景
场景1: 游戏行为随机化
标签: “日常任务”
执行概率: 70%
包含动作: 领取奖励、签到、查看邮件
标签: “社交互动”
执行概率: 30%
包含动作: 访问好友、发送消息、查看动态
执行效果: 70%概率执行日常任务，30%概率执行社交互动，让游戏行为更加自然随机。
场景2: 应用测试随机化
标签: “核心功能测试”
执行概率: 90%
包含动作: 主要功能操作
标签: “边缘功能测试”
执行概率: 20%
包含动作: 次要功能操作
执行效果: 重点测试核心功能，偶尔测试边缘功能，提高测试效率。
执行机制
随机判断时机
脚本执行到新标签的第一个动作时
系统自动检查该标签的随机配置
根据配率进行随机判断
执行或跳过
遇到新标签 → 检查随机配置 → 生成随机数 → 判断是否满足概率
↓ ↓
满足概率 不满足概率
↓ ↓
执行标签内所有动作 跳过整个标签
↓ ↓
继续下一个标签 继续下一个标签
跳过机制
如果随机判断为跳过，整个标签内的所有动作都不会执行
系统会直接跳转到下一个标签或动作
跳过过程中会记录日志信息
分组条件控制
功能说明
分组条件控制是一个强大的智能重试和流程控制系统。它会监控标签内识别动作（文字识别->、图像识别->）的执行结果，当检测到指定的失败条件时，自动执行重试或跳转操作。
支持的识别动作
文字识别->检测: 文字识别检测动作
文字识别->点击: 文字识别点击动作
图像识别->检测: 图像识别检测动作
图像识别->点击: 图像识别点击动作
配置步骤
1. 进入条件控制配置
点击标签头部的 “设置” 图标
在配置对话框中找到 “分组条件控制” 区域
2. 启用条件控制
开启 “启用条件控制” 开关
界面将显示该标签内的所有识别动作
3. 配置失败条件
为每个识别动作配置失败时的处理：
失败时操作类型:
重试当前分组: 重新执行整个标签
跳转到动作: 跳转到指定的动作编号
跳转到分组: 跳转到指定的标签名称
执行动作组: 调用指定的动作组
重试配置（仅重试类型）:
重试次数: 最大重试次数（1-10次）
重试用尽后操作: 达到重试上限后的处理方式
4. 保存配置
配置完成后点击 “确定”
标签头部的设置图标将变为突出颜色，表示已配置
配置示例
示例1: 登录流程重试
标签: “登录流程”
动作1: 文字识别->检测 - “登录按钮”
失败时操作: 重试当前分组
重试次数: 3次
重试用尽后: 跳转到分组 “错误处理”
动作2: 文字识别->点击 - “确定”
失败时操作: 重试当前分组
重试次数: 2次
重试用尽后: 跳转到动作 1
执行逻辑: 如果登录过程中某个识别步骤失败，自动重试整个登录流程。如果重试次数用尽，跳转到错误处理流程。
示例2: 游戏战斗检测
标签: “战斗操作”
动作1: 图像识别->检测 - “敌人血条”
- 失败时操作: 跳转到分组 “战斗结束处理”
动作2: 图像识别->点击 - “技能按钮”
失败时操作: 重试当前分组
重试次数: 2次
重试用尽后: 执行动作组 “备用技能”
执行逻辑: 检测不到敌人时跳转到战斗结束处理；技能按钮点击失败时重试，重试用尽则使用备用技能。
执行机制详解
结果收集阶段
标签内的每个识别动作执行时，系统会记录其成功/失败结果
结果与动作ID关联，用于后续的条件判断
只有配置了条件控制规则的动作结果才会被检查
条件检查阶段
标签内所有动作执行完成后，系统检查收集到的结果
查找是否有配置了条件控制规则且执行失败的动作
如果找到失败的动作，执行对应的失败处理操作
重试机制
标签执行完成 → 检查识别结果 → 发现失败动作 → 检查重试配置
↓
执行重试操作
↓
重试次数+1，跳转到标签开始
↓
重新执行整个标签
↓
重试成功 OR 达到重试上限
↓
成功：继续下一标签
失败：执行重试用尽操作
重试状态管理
系统维护每个标签的重试状态（当前重试次数、最大重试次数等）
重试过程中保持状态连续性
重试成功或用尽后自动清理状态
标签界面详解
标签头部信息
标签头部显示以下信息：
基本信息
标签名称: 显示标签的名称
动作数量: 显示标签内包含的动作数量
动作序号范围: 显示该标签在脚本中的动作编号范围
配置状态指示
执行概率: 如果启用了随机执行，显示执行概率百分比
条件控制: 设置图标的颜色指示是否配置了条件控制
展开/折叠: 点击标签头部可展开或折叠标签内容
操作按钮
条件设置: 齿轮图标，进入标签配置界面
重命名: 编辑图标，修改标签名称
删除: 删除图标，删除整个标签
上移/下移: 箭头图标，调整标签顺序
未分组动作
脚本中没有分配标签的动作会显示在 “未分组” 区域：
未分组区域不支持随机执行和条件控制配置
可以将未分组动作移动到具体标签中
未分组动作按原始顺序执行
标签管理对话框
通过右上角菜单可进入标签管理界面：
功能列表
创建空标签: 预先创建标签用于后续规划
批量操作: 对多个标签进行批量重命名或删除
标签统计: 查看各标签的动作数量和配置状态
导入导出: 标签配置的导入导出（如果支持）
最佳实践
1. 标签命名规范
使用有意义的名称:
✅ “登录流程”、”数据采集”、”错误处理”
❌ “标签1”、”组A”、”测试”
体现功能逻辑:
✅ “初始化设置”、”主循环操作”、”清理工作”
❌ “开始”、”中间”、”结束”
避免过长名称:
✅ “用户认证”、”数据同步”
❌ “用户登录和身份验证以及权限检查流程”
2. 标签分组策略
按功能模块分组:
标签: "环境准备" → 打开应用、初始化设置
标签: "数据采集" → 识别信息、提取内容
标签: "数据处理" → 分析数据、生成结果
标签: "结果输出" → 保存文件、发送通知
按执行阶段分组:
标签: "启动阶段" → 应用启动、权限检查
标签: "登录阶段" → 输入账号、验证登录
标签: "操作阶段" → 主要功能操作
标签: "退出阶段" → 保存设置、关闭应用
按条件分支分组:
标签: "正常流程" → 标准操作流程
标签: "异常处理" → 错误恢复流程
标签: "备用方案" → 备选执行路径
3. 随机执行设计
核心功能高概率:
主要功能: 80-100%
次要功能: 30-60%
测试功能: 10-30%
考虑依赖关系:
前置条件标签: 100%（必须执行）
可选增强标签: 较低概率
清理工作标签: 100%（必须执行）
避免过度随机化:
不要给所有标签都设置随机执行
保持核心流程的稳定性
只对真正需要随机化的部分使用
4. 条件控制配置
识别动作优先配置:
重点为文字识别->和图像识别->动作配置条件控制
普通动作（点击、等待）通常不需要配置
重试次数合理设置:
网络相关操作: 3-5次
界面识别操作: 2-3次
简单检测操作: 1-2次
重试用尽后的处理:
提供明确的错误处理路径
避免死循环和无限重试
考虑用户体验和执行效率
5. 性能优化
避免过小的标签:
不要为每个动作都创建单独标签
合并逻辑相关的动作到同一标签
合理使用条件控制:
不要为所有识别动作都配置条件控制
重点配置关键的、容易失败的识别动作
标签顺序优化:
将最常执行的标签放在前面
将错误处理标签放在合适位置
考虑执行效率和逻辑清晰度
故障排除
常见问题
1. 标签随机执行不生效
检查是否正确启用了随机执行开关
确认执行概率设置不为0%
查看日志确认随机判断过程
2. 条件控制重试不工作
确认标签内确实包含识别动作
检查识别动作是否配置了条件控制规则
验证识别动作确实返回了失败结果
3. 标签顺序混乱
使用标签的上移下移功能调整顺序
检查动作的实际位置是否符合预期
重新排列动作到正确的标签中
4. 重试次数过多导致性能问题
降低重试次数到合理范围
检查识别条件是否过于严格
优化识别动作的准确性
调试技巧
1. 使用日志分析
观察标签的随机判断日志
查看条件控制的执行过程
分析重试机制的触发条件
2. 分步测试
首先测试标签的基本执行
然后测试随机执行配置
最后测试条件控制功能
3. 简化调试
临时关闭随机执行进行测试
减少重试次数加快调试
使用简单的识别条件验证逻辑
4. 配置验证
检查标签配置是否正确保存
验证动作分组是否符合预期
确认条件控制规则的逻辑正确性
高级技巧
1. 嵌套标签逻辑
虽然标签本身不支持嵌套，但可以通过动作组调用实现类似效果：
标签: "主流程"
├── 动作1: 文字识别->检测
├── 动作2: 调用动作组 "子流程A"
└── 动作3: 调用动作组 "子流程B"
动作组: "子流程A" (内部也可以有标签)
├── 标签: "子步骤1"
└── 标签: "子步骤2"
2. 条件链式处理
通过多个标签的条件控制，实现复杂的错误处理链：
标签: "主操作" → 失败 → 重试 → 失败 → 跳转到 "备用方案"
标签: "备用方案" → 失败 → 重试 → 失败 → 跳转到 "错误处理"
标签: "错误处理" → 失败 → 执行动作组 "紧急处理"
3. 概率组合策略
利用多个标签的不同概率实现复杂的行为模式：
标签: "日常任务" (80%) → 标签: "额外奖励" (30%) → 标签: "社交活动" (20%)
这样的配置会产生多种执行组合，增加行为的多样性。
4. 动态标签管理
在脚本执行过程中，可以通过条件控制动态跳转到不同标签，实现状态机式的执行逻辑：
状态检测 → 根据结果跳转到不同标签
├── 状态A → 标签: "处理A"
├── 状态B → 标签: "处理B"
└── 状态C → 标签: "处理C"
常见问答 (FAQ)
Q1: 标签和动作组有什么区别？
A:
标签：脚本内的动作分组，随脚本顺序执行，支持分组随机和条件控制
动作组：独立的可复用模块，通过调用动作执行，可以跨脚本使用
Q2: 空标签有什么用途？
A: 空标签主要用于脚本规划和结构设计：
预先规划脚本结构
作为占位符便于后续添加动作
保持脚本的逻辑清晰度
Q3: 标签的随机执行是如何工作的？
A:
脚本执行到新标签时，系统检查该标签的随机配置
根据设置的概率生成随机数进行判断
如果满足概率则执行该标签内所有动作，否则跳过整个标签
Q4: 条件控制只监控识别动作吗？
A: 是的，条件控制只监控文字识别->和图像识别->类型的识别动作，因为只有这些动作有明确的成功/失败结果。
Q5: 重试机制会重试整个标签吗？
A: 是的，重试会从标签的第一个动作开始重新执行整个标签，这确保了标签内动作的逻辑完整性。
Q6: 可以为同一个识别动作配置多种失败处理吗？
A: 不可以，每个识别动作只能配置一种失败时的处理方式。但可以通过动作组调用来实现复杂的处理逻辑。
Q7: 标签的执行顺序如何确定？
A: 标签的执行顺序由其第一个动作在脚本中的位置决定，可以通过移动动作或使用标签的上移下移功能调整。
Q8: 删除标签会删除其中的动作吗？
A: 不会，删除标签只会移除分组关系，标签内的动作会变为未分组状态，仍然保留在脚本中。
Q9: 如何实现标签间的跳转？
A: 可以通过以下方式实现标签间跳转：
条件控制的”跳转到分组”功能
动作组内的跳转操作
条件流程控制的跳转功能
Q10: 标签配置会影响脚本导出吗？
A: 标签配置作为脚本的一部分会随脚本一起导出，包括随机执行和条件控制的所有设置。
总结
标签功能是脚本系统的强大组织工具，通过合理的标签分组、随机执行配置和条件控制设置，可以创建出高度智能和自适应的自动化脚本。
关键要点：
使用有意义的标签名称和合理的分组策略
根据需要配置分组随机执行，避免过度随机化
为关键识别动作配置条件控制，提高脚本的可靠性
通过标签管理功能维护清晰的脚本结构
结合多种功能实现复杂的自动化逻辑
正确使用标签功能可以让您的脚本更加模块化、智能化和易于维护！