参考

动作参考

每个动作的完整属性,包括「高级」分类里的不常用设置。当详细速查表用——表格三列分别是属性、说明 / 可选值、默认值

通用约定

为避免重复,以下所有动作共有的字段在这里统一说明,各动作表格里不再列出。

每个动作都有

属性说明默认
备注 Description给动作写个说明,不影响执行
启用 IsEnabled取消勾选则跳过此动作启用

鼠标 / 键盘类动作还共享「输入模式」与「后台」字段

这组字段决定动作怎么「打出去」,含义见 《输入模式》。它们在各动作里成组出现,下面动作表中以一行「另含输入模式 / 后台字段」带过,不逐一展开。

字段说明 / 可选值默认
前台输入模式(互斥,最多选一)
硬件模式 HardwareMode软件层硬件级模拟
罗技模式 LogitechMode走罗技驱动(仅点击 / 移动 / 按下 / 弹起有此项)
内核模式 InterceptionMode内核驱动输入,需装驱动并重启
单片机模式 PicoMode外接 Pico 输出真实 USB 键鼠
后台
后台模式 BackgroundMode对指定窗口发指令,不占用真实鼠标
目标窗口 TargetWindow后台操作的目标窗口
后台输入方式 InputMode标准消息 / 增强消息 / 通用后台 / 插件(收费)通用后台
提示「罗技模式」只有鼠标点击 / 移动 / 按下 / 弹起四个动作有;鼠标拖拽、滚轮没有。其余动作(流程控制、变量、识别等)大多没有输入模式字段,下面会标注例外。

鼠标 6 个动作

鼠标点击 MouseClickAction

在指定位置单击或双击。

基本设置
鼠标按键 Button左键 / 右键 / 中键 / 侧键1 / 侧键2左键
点击类型 ClickType单击 / 双击单击
位置设置
位置模式 PositionMode当前位置 / 固定位置 / 使用变量当前位置
坐标类型 PositionType绝对坐标 / 相对偏移绝对坐标
固定位置 FixedPosition固定坐标 (X, Y)0,0
相对偏移 RelativeOffset相对当前鼠标位置的偏移0,0
位置变量 PositionVariable从变量读取坐标
X/Y 分开变量 UseSeparateXYVariables用两个变量分别存 X、Y
X 变量 / Y 变量 VariableX / VariableY分别存 X、Y 坐标的变量名
偏移 X/Y 变量 OffsetXVariable / Y相对偏移,支持变量与表达式(如 ${dx})
随机抖动
启用随机抖动 EnableRandomJitter每次点击在目标附近随机偏移
抖动范围 X/Y JitterRangeX / Y水平 / 垂直最大偏移像素5
抖动模式 JitterMode均匀分布 / 高斯分布 / 圆形分布均匀
高级设置
点击前延迟 PreClickDelay移动到位后、点击前的延迟(毫秒)50
按下时长 ClickHoldDuration按下到弹起的停留(毫秒),0=默认手感0
移动速度 MoveSpeed瞬间 / 快速 / 缓慢瞬间
人性化级别 Humanize关闭 / 轻度 / 中度 / 高度(仅快速或缓慢时生效)关闭

另含输入模式(硬件 / 罗技 / 内核 / 单片机)与后台字段,见上方通用约定。

鼠标移动 MouseMoveAction

把光标移到目标位置,可设速度与路径。

基本设置
移动模式 Mode绝对位置 / 相对偏移绝对位置
使用变量 UseVariable用变量坐标作目标(仅绝对模式)
位置变量 PositionVariable存目标坐标的变量名
X/Y 分开变量 UseSeparateXYVariables用两个变量分别存 X、Y
X 变量 / Y 变量 VariableX / VariableY分别存 X、Y 的变量名
偏移 X/Y 变量 OffsetXVariable / Y偏移量,支持变量与表达式
目标位置 TargetPosition绝对目标坐标0,0
相对偏移 RelativeOffset相对当前位置的偏移100,100
移动速度 MoveSpeed瞬间 / 快速 / 缓慢快速
高级设置
平滑移动 SmoothMove是否平滑移动
人性化级别 Humanize关闭 / 轻度 / 中度 / 高度关闭
移动后延迟 PostMoveDelay移动到位后的延迟(毫秒)0
循环中累加 AccumulateInLoop循环里相对移动时累加偏移

另含输入模式(硬件 / 罗技 / 内核 / 单片机)与后台字段(后台仅绝对位置移动有效)。

鼠标按下 MouseDownAction

只按下不松开,用于长按或自定义拖拽。必须配对「鼠标弹起」。

基本设置
鼠标按键 Button左键 / 右键 / 中键 / 侧键1 / 侧键2左键
位置模式 PositionMode当前位置 / 固定位置 / 使用变量当前位置
固定位置 FixedPosition按下的固定坐标0,0

另含输入模式(硬件 / 罗技 / 内核 / 单片机)与后台字段。

鼠标弹起 MouseUpAction

松开之前按下的鼠标键。与「鼠标按下」配对。

基本设置
鼠标按键 Button要释放的键,应与按下时一致左键
位置模式 PositionMode当前位置 / 固定位置 / 使用变量当前位置
固定位置 FixedPosition弹起的固定坐标0,0

另含输入模式(硬件 / 罗技 / 内核 / 单片机)与后台字段。

鼠标拖拽 MouseDragAction

从起点按住拖到终点。

基本设置
起始位置 StartPosition拖拽起点坐标0,0
结束位置 EndPosition拖拽终点坐标0,0
鼠标按键 Button左键 / 右键 / 中键 / 侧键1 / 侧键2左键
高级设置
拖拽速度 DragSpeed瞬间 / 快速 / 缓慢快速
平滑拖拽 SmoothDrag是否使用平滑动画
拖拽前延迟 PreDragDelay开始拖拽前延迟(毫秒)100
拖拽后延迟 PostDragDelay完成拖拽后延迟(毫秒)100

另含硬件 / 内核 / 单片机模式与后台字段(无罗技模式)。

鼠标滚轮 MouseWheelAction

上下滚动,可指定位置。

基本设置
滚动方向 Direction向上 / 向下向上
滚动量 ScrollAmount滚动格数(通常每格 120)1
位置设置
滚动位置 Position执行滚动的位置(可选)
X/Y 坐标变量 PositionXVariable / Y位置,支持变量与表达式
高级设置
自定义 Delta CustomDelta自定义滚轮 delta 值120
使用自定义值 UseCustomDelta用 Delta 代替滚动格数

另含硬件 / 内核 / 单片机模式与后台字段(无罗技模式)。

键盘 3 个动作

键盘按键 KeyPressAction

按键、组合键、连续按键、输入文本或生成随机文本。

基本设置
按键模式 Mode单键 / 组合键 / 按键序列 / 文本输入 / 正则随机文本单键
主键 PrimaryKey主要按键(组合键时为修饰键外的主键)A
修饰键
Ctrl / Alt / Shift / Win UseCtrl / UseAlt / UseShift / UseWin是否同时按下对应修饰键
序列设置
按键序列 KeySequence依次按下的按键列表(序列模式)
文本设置
输入文本 TextToType要输入的文字(文本模式)
字符间延迟 CharDelayMs每字之间延迟(毫秒),建议 10–5010
随机字符延迟 RandomCharDelay每字用随机延迟(模拟真人打字)
随机延迟最小 / 最大 CharDelayMin / Max随机延迟下限 / 上限(毫秒)30 / 120
输入前延迟 PreInputDelayMs开始输入前等待(毫秒)100
强制英文输入法 ForceEnglishIME输入前切英文、输入后恢复
正则随机设置
正则表达式 RegexPattern生成随机文本的模式,如 [a-z]{5,8}、\d{6}
结果保存变量 RegexResultVariable把生成的文本存到变量(可选)
高级设置
按键时长 KeyDuration按住时长(毫秒),仅硬件 / 后台模式生效50

另含输入模式(硬件 / 罗技 / 内核 / 单片机)与后台字段。没有「长按」模式——长按用「按键时长」实现。

键盘按下 KeyDownAction

只按下不松开,用于长按。必须配对「键盘弹起」。

基本设置
按键 Key要按下的键A

另含输入模式(硬件 / 罗技 / 内核 / 单片机)与后台字段。

键盘弹起 KeyUpAction

松开之前按下的键。与「键盘按下」配对。

基本设置
按键 Key要释放的键A

另含输入模式(硬件 / 罗技 / 内核 / 单片机)与后台字段。

流程控制 9 个动作

延迟 DelayAction

暂停一段时间。

基本设置
延迟时间 MinDelay固定延迟(毫秒)1000
延迟表达式 MinDelayExpression变量或算式(如 ${延迟}*2),非空时优先
随机设置
最大延迟 MaxDelay随机延迟上限(毫秒)1000
最大延迟表达式 MaxDelayExpression随机上限的表达式,非空时优先
启用随机 IsRandom在最小~最大间随机取值
高级设置
高精度模式 UseHighPrecision高精度计时器(适合短延迟)
补偿循环耗时 CompensateLoopTime减去本轮已耗时,保证每轮总周期精确

循环 LoopAction

把一组动作重复执行。是个容器,子动作放进它里面。

基本设置
循环类型 Type指定次数 / 条件循环 / 无限循环 / 限时循环指定次数
循环次数 Count执行次数(指定次数时)5
持续秒数 DurationSeconds限时循环的持续时间(秒)60
索引变量名 IndexVariable把序号 0,1,2… 存到此变量,自动递增,子动作用 {i} 引用
条件设置
循环条件 Condition为真时继续(条件循环时)

条件 ConditionAction

按表达式真假,走不同分支(真 / 假各放一组子动作)。

基本设置
条件表达式 Condition如 ${count}>10、${找到}==1;支持 == != > < && ||,不支持 contains

跳出循环 BreakAction

立即结束当前循环;也可设为跳出子程序。

基本设置
跳出子程序 BreakFromSubroutine改为从当前子程序返回,而非跳出循环
跳出层级 BreakLevel跳出几层循环,1=当前,2=外层(未勾跳出子程序时有效)1
条件设置
执行条件 Condition满足条件才跳出(留空=无条件)

继续循环 ContinueAction

跳过本轮剩余动作,直接进入下一轮。

条件设置
执行条件 Condition满足条件才跳过本轮(留空=无条件)

跳转 GotoAction

跳到指定标签处继续执行。

基本设置
目标标签 TargetLabel要跳到的标签名
条件设置
执行条件 Condition满足条件才跳转(留空=无条件跳转,小心死循环)

标签 LabelAction

定义一个跳转目标点,本身不执行操作。

基本设置
标签名称 LabelName唯一标识,供「跳转」引用

退出脚本 ExitAction

立即停止整个脚本。

基本设置
退出码 ExitCode脚本退出码(0=成功)0
退出消息 ExitMessage退出时显示的消息
条件设置
执行条件 Condition满足条件才退出

注释 CommentAction

写说明文字,不执行,仅用于标记和阅读。

基本设置
注释内容 Comment任意说明文字

屏幕识别 7 个动作

找图 ImageFindAction

在屏幕上找一张图,找到可自动点击。调参思路见 核心概念

基本设置
目标图片 ImagePath要查找的图片文件
查找区域 SearchArea查找范围,空=全屏全屏
使用变量坐标 UseVariablePosition查找区域 X/Y/宽/高 从变量读
X/Y/宽/高 变量 PositionXVariable 等区域各项的变量名,留空用固定值
相似度 Similarity0.0~1.0,越高越严格0.9
超时时间 Timeout毫秒,0=只查一次0
结果处理
结果变量 ResultVariable存结果的变量前缀,派生 _Found / _X / _YFindResult
找到后点击 AutoClick找到图片后自动点击
点击类型 ClickType单击 / 双击单击
点击按钮 ClickButton左键 / 右键 / 中键 / 侧键左键
点击偏移 X/Y ClickOffsetX / Y相对图片中心的偏移(±9999)0
查找所有位置 FindAllPositions找出全部匹配,而非只第一个
点击所有位置 ClickAllPositions依次点击所有找到的位置
多位置点击间隔 MultiClickInterval依次点击的间隔(毫秒)500
点击前延迟 ClickDelay找到后、点击前延迟(毫秒)0
高级设置
匹配模式 MatchMode标准 / SSIM 结构 / 灰度 / 边缘特征 / 遮罩 / OpenCV 多尺度 / 旋转 / 特征点 / 边缘 / 掩码 / 基础(共 11 种)标准
颜色容差 ColorTolerance允许的 RGB 偏差(0–50)10
查找方向 Direction从左到右从上到下 / 从右到左 / 从下到上 / 从中心向外(共 5 种)从左到右从上到下
遮罩图片 MaskImagePath遮罩图(黑=忽略,白=匹配)
多图设置
启用多图模式 MultiImageEnabled同时查找多张图片
多图策略 MultiImageStrategy找到任意一张 / 必须全部找到找到任意一张
多图列表 MultiImages额外图片列表(每项可单独设相似度、点击偏移)
后台截图(后台模式下)
截图方法 BackgroundCaptureMethod自动 / PrintWindow / BitBlt / 桌面 / DirectX / DWM 缩略图 / 放大镜 / GDI+ / 分层窗口 / 强制前台(共 10 种)自动
强制前台截图 ForceForegroundCapture临时置顶截图(可能闪烁)
多次尝试 RetryWithDifferentMethods截图失败时换方法重试
启用 DWM 兼容 EnableDwmCompatibility桌面窗口管理器兼容模式
使用 GDI+ UseGdiPlus用 GDI+ 截图(某些情况更兼容)
调试
保存截图 SaveDebugScreenshot调试时保存截图
显示截图方法 LogCaptureMethod日志显示用了哪种截图方法
详细日志 VerboseLogging输出详细调试日志
运行诊断 RunDiagnosticFirst找图前先做窗口诊断

另含硬件 / 单片机模式与后台字段(找图无罗技 / 内核)。

找色 ColorFindAction

查找指定颜色的像素点。

基本设置
查找模式 FindMode单点找色 / 多点找色单点找色
目标颜色 TargetColor要查找的颜色红色
颜色容差 ColorTolerance0~255,0=精确匹配10
使用 HSV 模式 UseHsvMode颜色与亮度分开判断,抗光照变化
HSV 色相 / 饱和度 / 明度容差 HueTolerance / Saturation / ValueHSV 各分量容差6 / 25 / 25
搜索方向 Direction从左到右从上到下等(共 5 种)从左到右从上到下
多点找色
附加颜色点 AdditionalColors多点找色的附加点(相对偏移 + 颜色)
相似度要求 SimilarityPercent要求匹配的点数百分比(0–100)100
搜索区域
区域模式 AreaMode全屏 / 自定义区域 / 屏幕中心区域 / 当前窗口全屏
自定义区域 CustomArea自定义搜索矩形0,0,1920,1080
中心区域半径 CenterRadius屏幕中心区域的半径200
使用变量坐标 + X/Y/宽/高表达式 UseVariablePosition 等区域支持变量与四则运算表达式
找到后动作
动作类型 FoundAction点击 / 双击 / 移动鼠标 / 仅保存坐标点击
点击按钮 ClickButton左键 / 右键 / 中键 / 侧键左键
点击偏移 ClickOffset相对找到位置的偏移0,0
保存变量名 SaveToVariable存坐标,派生 _X/_Y/_Found/_CountColorResult
点击所有 ClickAll找到多个点时全部点击
点击前延迟 ClickDelay找到后、点击前延迟(毫秒)0
高级设置
查找超时 Timeout毫秒,0=只查一次5000
查找间隔 SearchInterval每次查找之间的间隔(毫秒)100
找不到时继续 ContinueOnNotFound找不到颜色时继续执行
查找所有 FindAll查找所有匹配点
最小间隔 MinDistance查找所有时相邻点最小像素间隔10
最大数量 MaxCount查找所有时上限(0=不限)10

另含硬件 / 单片机模式与后台字段。

OCR 文字识别 OCRAction

识别屏幕文字,可点击、读取或验证。首次使用需下载识别组件(约 250MB)。

基本设置
动作类型 ActionType查找并点击 / 仅查找 / 读取文字 / 验证文字存在 / 识别并输入数字 / 仅识别数字 / 复制到剪切板查找并点击
搜索文字 SearchText要查找的文字(留空=识别全部)
匹配模式 TextMatchMode精确匹配 / 包含文字 / 正则表达式 / 忽略大小写包含文字
超时时间 Timeout识别最大等待(毫秒)5000
未找到时继续 ContinueOnNotFound未找到不中断脚本
识别 / 区域设置
置信度阈值 ConfidenceThreshold最小置信度(0–100)60
全屏搜索 UseFullScreen是否全屏搜索
搜索区域 SearchArea指定搜索矩形
使用变量坐标 + X/Y/宽/高表达式 UseVariablePosition 等区域支持变量与表达式,跨分辨率适配
多显示器支持 MultiMonitorSupport搜索所有显示器
点击设置
点击偏移 X/Y ClickOffsetX / Y相对文字中心的偏移0
点击延迟 ClickDelay找到后点击延迟(毫秒)100
鼠标按钮 ClickButton左键 / 右键 / 中键 / 侧键左键
点击所有匹配项 ClickAllMatches依次点击区域内所有匹配文字
图像预处理(提高特殊字体识别率)
启用预处理 EnableImagePreprocess总开关
灰度化 / 二值化 PreprocessGrayscale / Binarize转灰度 / 转黑白开 / 否
二值化阈值 BinarizeThreshold0–255128
反色 / 增强对比度 PreprocessInvert / Contrast深底浅字反色 / 增强对比
对比度级别 ContrastLevel0.5–3.0 倍1.5
锐化 / 放大图像 PreprocessSharpen / Scale锐化边缘 / 放大小字
放大倍数 ScaleRatio1.5–4.0 倍2.0
多目标查找
启用多目标查找 EnableMultiTarget同时查找多个不同文字
查找目标列表 SearchTargets多个目标文字(各带点击偏移)
查找策略 MultiTargetFindStrategy找到任意一个 / 必须全部找到找到任意一个
点击策略 MultiClickStrategy只点第一个 / 依次点全部 / 不点击只点第一个
点击间隔 ClickInterval依次点击的间隔(毫秒)500
存储到变量
启用存储 SaveToVariable识别结果存数组变量
变量名 VariableName数组变量名(存为 名[0]、名[1]…)
同时保存坐标 SaveCoordinates另存每个结果的中心坐标
调试
显示识别结果 / 详细日志 ShowDebugInfo / DetailedLogging日志显示识别到的文字 / 初始化等

另含后台字段;单片机模式(在「硬件模式」分类下)。

像素文字识别 PixelTextRecognitionAction

基于像素字库识别屏幕文字(支持渐变色),可点击。支持后台模式。

模板配置
模板集列表 TemplateSets像素文字模板,可多套按序尝试
使用全局模板库 UseGlobalTemplate从全局模板库加载
全局模板库名称 GlobalTemplateLibraryName要使用的全局库名
搜索区域
区域模式 AreaMode全屏 / 自定义区域 / 屏幕中心区域自定义区域
自定义区域 CustomArea搜索矩形0,0,200,50
结果 / 点击
保存变量名 SaveToVariable识别结果存此变量识别的文字
识别成功后点击 EnableClick识别成功后点击文字位置
点击位置 ClickPosition文字中心 / 四角 / 第一字符中心 / 最后字符中心文字中心
点击偏移 X/Y ClickOffsetX / Y点击位置偏移0
点击后等待 ClickWaitTime点击后等待(毫秒)300
高级设置
识别超时 Timeout毫秒,0=不限时5000
重试间隔 RetryInterval每次识别之间的间隔(毫秒)100
识别失败时继续 ContinueOnFail失败时继续执行

另含后台字段(后台模式 / 目标窗口 / 后台输入方式)。

像素数字识别 PixelDigitRecognitionAction

识别像素风格的数字(血量、坐标等),只识别不点击。支持后台模式。

模板与区域
数字模板 TemplateSet0–9 的像素特征模板
区域模式 AreaMode全屏 / 自定义区域 / 屏幕中心区域自定义区域
自定义区域 CustomArea搜索矩形0,0,100,20
结果保存
保存变量名 SaveToVariable识别结果(文本形式)识别的数字
保存为数值 SaveAsNumber同时存为数值变量(名_数值)
高级设置
识别超时 Timeout毫秒,0=不限时5000
重试间隔 RetryInterval每次识别间隔(毫秒)100
识别失败时继续 ContinueOnFail失败时继续执行
最小 / 最大数字数量 MinDigitCount / MaxDigitCount期望识别的数字数量(0=不限)0

另含后台模式 / 目标窗口(无后台输入方式、无单片机)。

YOLO 检测 YOLODetectionAction

深度学习目标检测,应对动态复杂画面。需先用 YOLO 训练工具训练模型。

基本设置
检测类型 DetectionType查找并点击 / 查找并移动 / 仅查找 / 查找所有 / 等待出现 / 等待消失 / 验证存在查找并点击
目标类别 TargetClassName检测的类别名,逗号分隔多个
置信度阈值 ConfidenceThreshold0.0–1.00.5
超时时间 Timeout毫秒5000
模型 / 区域
模型文件 / 标签文件 ModelPath / LabelsPath.onnx 模型 / 类别标签文件
全屏搜索 / 搜索区域 UseFullScreen / SearchArea全屏或指定矩形全屏
相对于窗口 RelativeToWindow区域相对绑定窗口
点击 / 多目标
点击偏移 X/Y ClickOffsetX / Y相对检测框中心偏移0
点击延迟 ClickDelay点击前延迟(毫秒)50
双击 / 鼠标按钮 DoubleClick / ClickButton是否双击 / 用哪个键否 / 左键
目标选择策略 TargetSelection最高置信度 / 最后 / 最左 / 最右 / 最上 / 最下 / 最中心 / 随机第一个
目标索引 TargetIndex第 N 个目标(-1=最后)0
点击所有目标 / 间隔 ClickAllTargets / ClickAllInterval依次点击全部 / 间隔(毫秒)否 / 100
失败处理
找不到时 NotFoundAction继续执行 / 停止脚本 / 跳过当前动作继续执行
重试次数 / 间隔 RetryCount / RetryInterval检测失败重试次数 / 间隔(毫秒)0 / 500
变量输出
结果 / 位置 / 置信度 / 数量 / 全部结果变量 ResultVariable 等分别保存是否找到、坐标、置信度、数量、全部结果(JSON)
高级 / 调试
使用 GPU UseGPUGPU 加速(需 CUDA)
输入宽 / 高 InputWidth / Height模型输入尺寸(通常 640)640
IOU 阈值 IouThreshold非极大值抑制阈值0.45
调试图片 / 叠加层 / 日志 SaveDebugImage 等保存检测框图 / 屏幕叠加 / 详细日志

YOLO 检测没有后台 / 输入模式字段,点击走前台模拟。

AI 智能判断 AIDecisionAction

借助 AI 看屏幕做判断或自主操作(进阶)。在简单视图 / 专用对话框里配置,不走普通属性面板。

基础
决策提示 DecisionPrompt描述判断条件或要找的内容
使用屏幕截图 UseScreenshot是否截图给 AI
截图区域 CaptureArea空=全屏全屏
超时时间 TimeoutMs毫秒(视觉分析需较长)60000
最小置信度 MinConfidence0–10050
输出模式
输出模式 OutputMode布尔 / 坐标 / 文本 / OCR 匹配 / Agent 自主操作布尔
结果变量名前缀 ResultVariable自动派生 _Found / _X / _Y / _Text 等AIResult
使用 OCR 辅助 / 目标文字 UseOCR / OCRTargetTextOCR 匹配模式用否 / 空
找到后点击 ClickOnFound找到目标后自动点击
结果缓存
启用结果缓存 EnableResultCache循环里相似截图复用上次结果,省 token
缓存 TTL / 哈希容差 CacheTTLSeconds / CacheHashTolerance缓存有效秒数 / 截图变化判定阈值5 / 5
Agent 模式
最大步数 / 每步延迟 MaxAgentSteps / AgentStepDelay防死循环步数 / 每步延迟(毫秒)20 / 500
本地 OCR 辅助 / 显示思考 / 硬件模式 AgentUseLocalOCR / ShowThinking / HardwareModeAgent 行为开关开 / 开 / 否
重试 / 重规划相关 AgentMaxRetries 等每步重试、连续失败重规划阈值与上限、验证超时2 / 3 / 3
动作分支
真 / 假 / 出错时动作 TrueActions / FalseActions / ErrorActions条件成立、不成立、AI 调用失败时各执行的子动作

AI 智能判断没有后台 / 输入模式字段;Agent 操作的输入方式由「硬件模式」开关决定。

窗口与进程 2 个动作

窗口管理 WindowManagementAction

激活、最小化、移动、关闭窗口等。

基本设置
操作类型 Operation激活 / 最小化 / 最大化 / 还原 / 关闭 / 移动 / 调整大小 / 置顶 / 取消置顶 / 修改标题激活窗口
查找方式 SearchMode按窗口标题 / 按类名 / 按进程名(部分匹配)按窗口标题
查找内容 SearchText标题 / 类名 / 进程名,支持 ${变量}
失败时跳过 IgnoreIfNotFound找不到或失败时跳过此动作继续
等待窗口出现(秒) WaitTimeoutSeconds找不到时持续重试的秒数,0=不等待0
按操作生效的设置
移动位置 MovePosition目标位置(仅「移动」)100,100
窗口大小 ResizeSize目标尺寸(仅「调整大小」)800×600
新标题 NewTitle新窗口标题(仅「修改标题」)

进程管理 ProcessManagementAction

运行程序、结束 / 检查 / 等待进程。

基本设置
操作类型 Operation运行程序 / 关闭进程 / 检查进程是否存在 / 等待进程启动 / 等待进程结束运行程序
运行程序设置
程序路径 ProgramPath程序完整路径或命令
启动参数 Arguments程序的启动参数(可选)
工作目录 WorkingDirectory留空=程序所在目录
以管理员运行 RunAsAdmin以管理员权限启动(默认降权,等同双击)
隐藏窗口 HideWindow启动时隐藏窗口
等待程序退出 WaitForExit等程序执行完再继续
进程查找设置
进程名称 ProcessName进程名(不含 .exe)
超时时间 Timeout等待操作超时(毫秒)5000
结果设置
结果变量 ResultVariable检查进程时存 true/false进程存在

子程序 2 个动作

子程序(定义) SubroutineDefineAction

把一组动作打包成可复用的「函数」,定义时不执行。

基本设置
子程序名称 SubroutineName唯一标识,供调用引用新子程序
说明 Description子程序的功能说明

子动作通过右键「移入子程序」加入;默认折叠显示。

调用子程序 SubroutineCallAction

执行已定义的子程序,执行完返回原处。

基本设置
子程序名称 SubroutineName要调用的子程序名

不支持传参,靠共享变量在子程序间传值。

变量与数据 5 个动作

变量 VariableAction

创建和修改变量。详见 核心概念

基本设置
操作类型 Operation设置 / 增加 / 追加 / 时间运算设置
变量名 VariableName变量的名称变量1
Value要设置的值,支持 ${变量}(数字类型时可写算式)
值类型 ValueType字符串 / 数字 / 布尔值 / 坐标 / 当前鼠标位置 / 当前时间 / 随机数字符串
数组设置
启用数组模式 EnableArrayMode定义多个值,按循环索引自动选
值列表 ArrayValues数组的值,每行一个
索引模式 IndexMode循环(从头)/ 钳制(边界值)/ 错误 / 默认(第一个)循环
索引变量 IndexVariable作索引的变量名,留空=用最近循环索引
索引偏移 IndexOffset索引偏移量(如从 1 开始)0
随机数设置(值类型=随机数时)
最小值 / 最大值 RandomMinValue / Max随机数范围(含两端)0 / 100
时间运算(操作=时间运算时)
基准时间变量 TimeBaseVariable留空=当前时间
加 / 减 TimeAdjustDirection在基准时间上加或减
数量 TimeAdjustAmount要加 / 减的数量,支持变量与表达式0
单位 TimeAdjustUnit秒 / 分钟 / 小时 / 天 / 周 / 月 / 年
输出形态 TimeOutputModeDateTime 对象 / 格式化字符串 / 时间戳秒(做到期判断选这个)DateTime 对象
格式串 TimeFormatString格式化字符串输出时的格式yyyy-MM-dd HH:mm:ss

文件读取 FileReadAction

从 TXT 文件(key=value 格式)读取变量值。

设置
文件路径 FilePathTXT 路径,支持变量如 {scriptDir}\data.txt
操作模式 Mode单个变量 / 全部变量单个变量
键名 KeyName要读取的键(等号左侧)
目标变量名 TargetVariable读到的值存入此变量
默认值 DefaultValue键不存在时用的默认值
文件不存在时继续 ContinueOnError文件不存在时继续执行

文件写入 FileWriteAction

把变量值写入 TXT 文件。

设置
文件路径 FilePathTXT 路径,支持变量
自动创建目录 CreateDirectoryIfNotExist目录不存在时自动创建
操作模式 Mode单个变量 / 全部变量单个变量
写入方式 WriteMode覆盖写入 / 追加或更新覆盖写入
键名 KeyName写入的键名
ValueExpression写入的值,支持 {变量}
指定变量 VariableFilter批量写入时的变量名(逗号分隔,空=全部)
失败时继续 ContinueOnError写入失败时继续执行

Excel 读取 ExcelReadAction

读取 xlsx,每列存为数组变量「列名[行号]」,配合循环遍历。

文件 / 范围
Excel 文件路径 FilePathxlsx 路径,支持变量
工作表名或序号 SheetName留空=第一个工作表
第 1 行是表头 HasHeader用第 1 行作列变量名,从第 2 行起取数据
自定义起始行 CustomStartRow强制从第几行起,0=自动0
结束行 / 起始列 / 结束列 EndRow / StartColumn / EndColumn0=读到末尾 / 列字母 / 空=自动0 / A / 空
输出
行数变量名 RowCountVariable读到的数据行数,供循环次数引用ExcelRowCount
无表头时列名前缀 FallbackColumnPrefix无表头时列名,空=用列字母 A/B/C
文件不存在时继续 ContinueOnError文件不存在时继续执行

Web 请求 WebRequestAction

向服务器发送 HTTP POST(JSON)请求,常用于把运行状态上报到自建服务器。

服务器设置
服务器地址 ServerUrl基础地址,如 http://yourserver.comhttp://localhost
请求路径 RequestPathAPI 路径/api.php?action=log
超时时间 TimeoutMs毫秒5000
API 密钥 ApiKey身份验证密钥(可选)
设备标识
设备名称 / 分组 DeviceName / DeviceGroup设备名(空=机器名)/ 所属分组空 / 默认分组
发送内容
内容类型 ContentType变量数据 / 自定义 JSON / 状态报告 / 混合模式变量数据
指定变量 VariableNames要发送的变量名(逗号分隔,空=全部)
自定义内容 CustomContent自定义 JSON,支持 ${变量}{}
包含日志 / 日志条数 IncludeLogs / LogCount是否带执行日志 / 最近几条(0=全部)否 / 50
结果处理
保存响应 / 响应变量名 SaveResponse / ResponseVariableName把服务器响应存到变量否 / web_response
失败时继续 ContinueOnError请求失败时继续执行

固定使用 POST + application/json;无自定义请求方法 / 请求头字段。

提示与交互 2 个动作

提示音 PlaySoundAction

播放系统提示音或音频文件,常用于报警提醒。

基本设置
声音类型 Type系统提示音 / 错误提示音 / 自定义音频文件系统提示音
自定义音频文件 CustomSoundPath.wav 文件路径(类型为自定义时)
播放次数 PlayCount播放几次1
播放间隔 PlayInterval多次播放的间隔(毫秒)500
异步播放 AsyncPlay不等播放完就继续下一个动作

消息弹窗 MessageBoxAction

弹出消息框,脚本暂停,等用户点确定再继续。

基本设置
弹窗标题 Title窗口标题文字提示
消息内容 Message显示内容,支持多行、${变量}脚本已暂停…
弹窗图标 IconType无图标 / 信息 / 警告 / 错误 / 问题信息
延迟 / 高级
关闭后延迟 DelayAfterClose关闭弹窗后再继续的延迟(毫秒)0
播放提示音 / 窗口置顶 PlaySound / TopMost弹出时响提示音 / 始终最前开 / 开

多线程 4 个动作

并行执行 ParallelAction

同时执行多个分支(分支列表在专用对话框里编辑)。

基本设置
等待模式 WaitMode等待所有分支 / 任一分支完成即继续 / 启动后不等待等待所有
超时时间(秒) TimeoutSeconds最长等待,0=无限0
失败策略 FailurePolicy一个失败取消所有 / 继续执行其他分支取消所有

后台任务 BackgroundTaskAction

在后台持续运行一个任务,不阻塞主脚本(子动作在专用入口编辑)。

基本设置
任务 ID TaskId唯一标识,供线程控制 / 通信引用Task1
任务类型 TaskType持续监控 / 一次性执行 / 事件驱动 / 定时执行持续监控
检查间隔 CheckInterval监控 / 事件模式的轮询间隔(毫秒)100
触发条件 TriggerCondition满足条件才执行(监控模式,留空=每次都执行)
等待消息 WaitMessageName事件模式下等待的消息名
定时设置(定时模式)
间隔时间 / 首次延迟 Interval / InitialDelay执行间隔 / 首次执行前等待(毫秒)1000 / 0
执行次数 RepeatCount0=无限0
执行模式 ExecutionMode允许重叠 / 上次完成才执行 / 忙时跳过上次完成才执行
高级
随脚本停止 AutoStopWithScript主脚本停止时自动停此任务

线程控制 ThreadControlAction

控制后台任务和定时器的运行状态。

设置
操作类型 ControlType等待任务完成 / 停止任务 / 停止定时器 / 停止所有任务 / 暂停 / 恢复 / 中断主流程并跳转等待任务完成
目标任务 ID TargetTaskId要控制的任务 ID
超时时间 Timeout毫秒,0=无限等待0
目标标签 TargetLabel中断后跳转的标签(中断并跳转时)

线程通信 ThreadCommunicationAction

在任务之间传消息、做信号同步。

设置
通信类型 CommunicationType发送消息 / 等待消息 / 设置信号 / 等待信号 / 清除信号发送消息
目标任务 ID TargetTaskId发送消息的目标任务
消息 / 信号名称 MessageName消息名;信号操作时作信号名
消息内容 MessageContent发送的消息内容
当前任务 ID CurrentTaskId接收消息用(留空=Main)
超时时间 Timeout毫秒5000
存储变量 ResultVariable接收到的消息存此变量

寻路 3 个动作 · 进阶

A* 寻路 PathFindAction

按地图用 A* 算法自动计算路径,用方向键绕开障碍移动。

地图 / 位置
地图文件 MapFilePath寻路地图(.json)
位置来源 PositionSource变量读取 / 固定起点变量读取
当前 X/Y 变量 CurrentXVariable / Y存当前坐标的变量名角色X / 角色Y
固定起点 X/Y FixedStartX / Y固定起点坐标0
目标 X/Y TargetX / Y目标坐标,支持 ${变量}0
移动设置
按键方案 KeySetWASD / 方向键 / 自定义WASD
方向模式 DirectionMode4 方向 / 8 方向(含对角线)8 方向
每格按键时长 / 步间延迟 StepDurationMs / StepDelayMs每格按住时间 / 两步间隔(毫秒)200 / 50
合并同向步骤 SmoothPath同方向连续移动合并为长按
自定义上下左右键 CustomKeyUp / Down / Left / Right自定义方案时的按键W / S / A / D
高级设置
允许贴角 AllowCornerCutting对角线移动擦角通过
最大搜索节点 MaxSearchNodes防大地图卡死100000
结果 / 步数变量 ResultVariable / StepCountVariable寻路成功失败 / 路径步数

自动探索建图 MapExplorerAction

像扫地机器人一样自动移动角色,实时生成障碍物地图。需配合 OCR / 像素识别持续更新坐标。

坐标 / 地图
X/Y 坐标变量 CoordXVariable / Y当前坐标变量名角色X / 角色Y
移动判定阈值 MoveThreshold坐标变化超此值才算移动成功2.0
地图保存路径 OutputMapPath探索完成后保存的地图(.json)
格子大小 / 列数 / 行数 CellSize / MapColumns / MapRows每格坐标单位 / 网格宽 / 高10 / 100 / 100
移动设置
按键方案 KeySetWASD / 方向键 / 自定义WASD
每步按键时长 / 读取延迟 StepDurationMs / ReadDelayMs每步按住时间 / 移动后等坐标更新(毫秒)300 / 200
自定义上下左右键 CustomKeyUp / Down / Left / Right自定义方案时的按键W / S / A / D
探索设置
探索策略 Strategy广度优先 BFS(推荐)/ 深度优先 DFS / 螺旋扫描(暂未实现)BFS
最大探索步数 MaxSteps防无限探索5000
完成 / 已探索格数变量 ResultVariable / ExploredCountVariable探索结果 / 已探索格子数

路径跟随 PathFollowAction

按预录路径自动行走,支持偏离纠正与卡住恢复。属性较多,下表按分组列出。

基本设置
路径文件 PathFile要跟随的路径(.json)
启用地图识别 EnableMapDetection按当前地图自动切换路径
循环执行 / 最大循环次数 LoopPath / MaxLoopCount走完从头开始 / 0=无限开 / 0
每次执行点数 ExecutePointCount执行几个点后暂停,0=全部0
进度变量名 ProgressVariable存进度,下次从此继续
移动设置
到达判定距离 / 坐标检测间隔 ArrivalThreshold / CheckInterval多近算到达 / 读坐标间隔(毫秒)8 / 500
移动超时 / 点击间隔 MoveTimeout / ClickInterval单点最长时间 / 连续点击间隔(毫秒)10000 / 1500
点击方式 ClickMode左键 / 右键 / 左键+右键 / 自定义组合键左键
Ctrl/Shift/Alt 键 + 自定义点击按钮 CtrlPosition 等自定义组合键模式的修饰键与按钮不使用 / 右键
移动技能键 1/2/3 MoveSkillKey / 2 / 3移动前依次按的技能键None
每次点击数 ClickCountPerMove每次移动点几下(1–10)1
最小 / 最大移动距离 MoveStepMin / Max每次点击移动的坐标距离区间15 / 40
最大点击距离(像素) MaxClickDistance点击距屏幕中心上限,防点出区域(50–800)300
偏离纠正
偏离判定距离 / 自动纠正 DeviationThreshold / AutoCorrect多远算偏离 / 偏离时回到最近点50 / 开
卡住检测时间 / 最大重试次数 StuckCheckTime / MaxRetryCount坐标多久不变算卡住(毫秒)/ 移动失败重试5000 / 3
坐标读取失败恢复
启用失败点击恢复 EnableFailClickRecovery坐标连续读失败时随机点击预设点恢复
失败触发次数 / 每次点击次数 / 点击间隔 FailClickThreshold / Count / Interval连续失败几次触发 / 点几个点 / 间隔(毫秒)5 / 3 / 300
最大恢复轮数 / 恢复轮数变量 / 超限后继续 FailRecoveryMaxRetries 等恢复点击最多几轮(0=无限)/ 记录变量 / 超限后继续而非停止3 / 空 / 开
恢复点位列表 FailRecoveryPoints失败时随机点击的屏幕坐标点(最多 8 个)
调试
显示调试信息 ShowDebugInfo日志显示详细执行信息

浏览器 5 个动作 · 测试中

用真实浏览器做网页自动化,通过元素选择器定位。选择器类型都支持「自动 / CSS / XPath」,建议选稳定的选择器,避开带时间戳、随机哈希的动态 id / class。

浏览器 · 打开网址 BrowserOpenAction

在浏览器中打开一个网址。

URL Url要打开的网址,支持 ${变量}https://www.baidu.com
新建标签页 OpenInNewTab新 tab 打开,否则当前 tab 跳转
等待加载完成 WaitForLoad等页面 load 后再继续
超时(ms) TimeoutMs毫秒30000
出错时继续 ContinueOnError打开失败也不停脚本

浏览器 · 点击元素 BrowserClickAction

用选择器定位并点击网页元素。

选择器 / 类型 Selector / SelectorTypeCSS(如 #login)或 XPath;类型 自动 / CSS / XPath空 / 自动
点击次数 ClickCount1=单击,2=双击1
点击前等待元素 WaitForElement等元素出现再点
超时(ms) TimeoutMs毫秒5000
找不到元素时继续 ContinueOnError找不到 / 失败也不停脚本

浏览器 · 输入文本 BrowserInputAction

向网页输入框填入文本。

选择器 / 类型 Selector / SelectorType定位输入框空 / 自动
文本 Text要输入的文本,支持 ${变量}
先清空 ClearFirst输入前先清空输入框
每字符延迟(ms) TypingDelayMs0=瞬间贴入,>0=逐字模拟0
输入后按回车 PressEnterAfter输入完按回车
超时(ms) / 出错继续 TimeoutMs / ContinueOnError毫秒 / 失败不停脚本5000 / 否

浏览器 · 等待元素 BrowserWaitAction

等待某个网页元素出现 / 可见 / 消失再继续。

选择器 / 类型 Selector / SelectorType定位元素空 / 自动
等待条件 Condition出现 / 可见 / 消失可见
超时(ms) TimeoutMs毫秒10000
超时不报错 TimeoutAsFailure勾选后超时不算失败,结果存到下面变量
结果变量 SaveResultTo把成功 / 超时结果存到变量(可选)

浏览器 · 取文本 BrowserGetTextAction

提取网页元素的文本或属性到变量。

选择器 / 类型 Selector / SelectorType定位元素空 / 自动
取属性名 AttributeName留空=取文本;填 href / value / src 取对应属性
存到变量 SaveToVariable把取到的文本存到此变量BrowserText
超时(ms) / 出错继续 TimeoutMs / ContinueOnError毫秒 / 找不到也不停脚本5000 / 否