🌐 全局操作

全局操作用于控制软件整体运行状态：

功能	说明
🌙 休眠	立即终止所有宏，并禁用软件全部功能；取消休眠后恢复运行。
⏸️ 暂停	暂停当前所有宏，再次点击继续执行。
⛔ 终止所有宏	强制停止所有正在运行的宏任务，不可恢复，用于紧急情况。
🔄 重载	重新加载当前配置，撤销未保存的修改（图形节点编辑器中的修改不会撤销）。
💾 应用并保存	保存并立即应用所有修改；未点击前，修改的配置不会生效。

🗂️ 页签说明

软件主界面通过不同页签对功能进行分类管理：

页签	说明
⌨️ 按键宏	通过快捷键触发宏，支持手柄、键鼠以及它们的组合键（如 `Ctrl + C`）。
🔤 字串宏	通过输入特定字符序列触发宏（如连续按键、输入字符串）。
🧭 菜单宏	通过快捷键呼出菜单轮盘，再由菜单按钮触发对应宏（可用 `F1`～`F8` 快捷触发）。
🪟 界面宏	激活窗口时在界面上显示悬浮按钮，也可通过快捷键进行开关控制。
⏰ 定时宏	按时间触发宏，支持单次、软件启动时，以及秒 / 分钟 / 小时 / 天 / 周 / 月等自定义间隔。
🧩 宏	可被其他宏调用的宏片段。
🎮 按键替换	将某个按键映射为其他按键或组合键。
🛠️ 工具	辅助功能集合，如变量监视器、文件校验、截图、录制、取色、窗口信息等。
⚙️ 设置	修改软件的全局配置与行为选项。
❓ 帮助	使用说明、开源地址、交流群、反馈与更新日志。
❤️ 打赏作者	支持作者持续维护与功能迭代。
🌟 特别感谢	感谢代码贡献者、开源项目与社区成员。

📦 宏模块

对宏进行分类管理：

参数	说明
📝 备注	对模块进行说明，便于后续管理与维护。
🪟 前台	模块下所有配置只在设定的窗口中触发；置空则在所有窗口皆可触发。
➕ 新增宏	在模块最下方增加一条宏配置。
📋 粘贴宏	需先点击宏配置中的「复制」，再点击「粘贴」，可将复制的宏内容添加到新增宏配置中。
📁 新增模块	在当前模块下方新增一个模块。
🗑️ 删除模块	删除当前模块（不可恢复）。
🚫 禁用（模块）	禁用当前模块下所有宏配置的手动触发（仍可通过宏操作调用触发）。
📋 复制	复制当前宏内容，可在模块上粘贴使用。
🚫 禁用（宏）	禁用当前宏配置，不参与触发与执行。
🗑️ 删除	删除当前宏配置（不可恢复）。
⌨️ 菜单触发键	配置当前模块菜单轮盘的触发按键。
🪟 面板触发键	配置当前模块界面浮窗的控制开关。

🎯 宏配置

用于定义单条宏的触发方式与执行行为：

参数	说明
📝 宏名称	对宏用途进行说明，便于管理与维护。
⌨️ 触发键编辑	打开触发键设置界面，进行可视化配置。
🖼️ 触发键编辑（菜单宏 / 界面宏）	打开扇区或界面按钮上的图标设置。
⏰ 触发键编辑（定时）	打开定时设置界面。
🎯 触发类型	设置宏的触发按键与方式： • 按下：按下即触发，未松开可重复触发 • 松开：松开时触发 • 松止：按下持续触发，松开后终止 • 开关：首次触发开始，再次触发终止 • 长按：持续按下到指定时间后触发 • 双击：双击触发键后触发
🔁 循环次数	设置宏的重复执行次数（可下拉选择「无限」）。
🎹 宏设置 · 按键类型	• AHK Send：通用方式，适合办公软件与大多数游戏（管理员权限可让更多游戏有效） • keybd_event：系统接口方式，适合老软件或游戏（需管理员权限） • 罗技：调用罗技驱动模拟按键（需管理员权限，并使用 G HUB 2022.2.1154 及以前版本） • AHI：调用 Interception 驱动模拟按键（需管理员权限，并安装 Interception） ⚠️ keybd_event、罗技和 AHI 的按键可作为宏的触发按键，切勿自己触发自己导致死循环
🔊 宏设置 · 开始提示音	• 无：不播放提示音 • 触发提示：触发时提示，循环触发会多次提示 • 循环首次提示：触发时提示，循环触发不再提示
🔊 宏设置 · 结束提示音	• 无：不播放提示音 • 结束提示：宏结束时提示，循环多次结束就多次提示 • 循环结束提示：结束时提示，循环结束不再多次提示
✏️ 宏指令编辑	打开宏指令编辑器，编辑宏内容。
📋 复制	复制当前宏内容，可在模块上粘贴使用。
🚫 禁用	禁用当前宏配置，不参与触发与执行。
🗑️ 删除	删除当前宏配置（不可恢复）。

📂 配置管理

对配置进行分类管理：

参数	说明
📥 迁入配置文件夹	选择旧版本或同版本若梦兔（假定叫 A）的 `Setting` 文件夹，把 A 中所有配置覆盖同步到当前软件。 ⚠️ 当前软件的所有配置会自动备份到 `SettingOld` 目录下
✏️ 重命名	修改当前配置名称。
🔧 配置校准	迁入或重命名后若配置异常，可尝试使用该功能修复。
➕ 新增配置	新增一个配置。
📦 导入配置	选择一个 `.rmt` 文件导入配置（共享仓库可下载）。
🔀 合并导入	选择一个 `.rmt` 文件或本地已有的配置，合并到当前配置中。
📂 加载配置	切换到选中的配置。
🗑️ 删除配置	删除选中的配置。
📄 使用说明	共享仓库的配置要求必须填写；导入的 `.rmt` 文件配置可以查看说明。
📤 导出配置	将选中的配置导出为 `.rmt` 文件，可共享上传、方便配置分享。
🌐 打开仓库	打开共享仓库，可以下载学习案例，或他人已经共享的游戏相关配置。
☁️ 共享上传	选择本地的 `.rmt` 文件上传到服务器，经过审核后同步到共享仓库中。

🛠️ 软件工具

文件校验、信息获取等辅助功能：

设置项	说明
👁️ 变量监视器	可以实时查看全局变量的值，以便问题排查。
✅ 文件校验	为避免系统或人为误删除，可校验缺失资源并补齐。
🖱️ 鼠标信息	获取当前鼠标下详细信息：屏幕坐标、窗口坐标、窗口标题、进程名等等。
📌 窗口置顶	软件主窗口置顶。
⏺️ 指令录制	录制手柄（需要额外配置）、键鼠操作，自动生成宏配置。
🔤 图片文本提取	提取图片中的文字。

⚙️ 软件设置

用于调节整体行为与模拟真实性的全局参数：

设置项	说明
⏱️ 点击时间浮动（%）	按键点击时间的浮动范围。例如：设为 10，原 50ms → 最终约 45～55ms。
⏳ 每次间隔浮动（%）	多次点击、多次搜索、多次提取间隔浮动范围。例如：设为 10，原 500ms → 实际约 450～550ms。
⌛ 间隔指令浮动（%）	间隔指令的浮动范围。例如：设为 10，原 3000ms → 实际约 2700～3300ms。
↔️ 坐标 X 浮动（px）	模拟点击时 X 坐标的浮动范围。例如：设为 30，原 X=900 → 实际约 870～930。
↕️ 坐标 Y 浮动（px）	模拟点击时 Y 坐标的浮动范围。例如：设为 50，原 Y=400 → 实际约 350～450。
🧵 多线程数（-1～10）	`-1`：动态多线程；`0`：单线程；`n`：多线程固定为 n。
⚡ 开机自启	开机时自动运行软件。
🛡️ 管理员启动	软件运行后提权为管理员。
⌨️ 自动松开修饰键	修饰键 + 普通键触发宏时，自动松开修饰键。
🔁 连续触发	按下、开关、长按可以按住连续触发。
💬 无变量提醒	当使用不存在的变量时弹窗提示。
🪟 模态子窗口	只有关闭子窗口才能操作主窗口。
🌐 语言 / Lang	设置软件显示语言。
🔤 软件字体	设置界面字体。
🧩 首选编辑器	设置宏内容为空时打开的编辑器类型。
📸 截图方式	设置截图实现方式；当截图报错时请切换其他截图方式。
🎮 手柄类型	设置手柄宏的按键类型。
⌨️ 按下时按下	宏按键按下后再次按下时的特殊调整选项。
🎨 主题	配置软件所有的颜色配比。
⌨️ 快捷键	修改软件所有的快捷按键。
⏺️ 指令录制	设置指令录制时的一些录制细节。
🎡 轮盘	设置菜单轮盘大小、触发方式、显示位置。
🪟 界面浮窗	设置界面宏的默认位置、大小等。
📺 指令显示	设置宏执行时的内容显示位置等。

1️⃣. 按键触发连点器

功能说明：当你按下触发键时，RMT（若梦兔）软件会辅助你快速连续点击按键。

操作步骤：

添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击触发键编辑器的编辑按钮，新窗口选择触发键（例如 F6）后点击确定。
设置宏指令：点击宏编辑器的编辑按钮 → 指令选项中点击 按键 → 点击按键A → 设置循环次数10 → 点击按键编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。

图示：按键宏编辑界面

最终按键配置界面
图示：按键指令配置界面
4. 点击主界面左下角应用并保存按钮即可。

配置效果：当按下触发键F6时,软件辅助按下10次A键，每次按键时间100ms，每次间隔200ms，指令总时长2800ms

2️⃣. 组合键触发宏

功能说明：只有当一组特定组合键同时按下时，才会触发宏。

操作步骤：

添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：在触发键编辑界面勾选你想要的组合键，例如 Ctrl + Alt + A。

图示：触发键配置界面
设置宏指令：在宏指令编辑界面 → 指令选项中点击 输出 → 输出内容中输入RMT → 点击输出编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。

图示：输出指令配置界面
点击主界面左下角应用并保存按钮即可。

配置效果：当按下触发键Ctrl + Alt + A时,软件辅助输出RMT文本

3️⃣. 按键触发组合键

功能说明：按下一个键，让它自动执行一组组合键动作，比如按下 F9 自动发送 Ctrl + V。

操作步骤：

添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击触发键按钮，新窗口选择触发键，例如 F9。
设置宏指令：在宏指令编辑界面 → 指令选项中点击 按键 → 点击 Ctrl → 点击 V → 确定 → 点击宏指令编辑界面确定按钮。

图示：组合键配置界面
点击主界面左下角应用并保存按钮即可。

配置效果：当按下触发键F9时,软件辅助按下Ctrl + V

4️⃣. 指令录制（宏录制器）

功能说明：自动录制你在键盘和鼠标上的操作，自动生成宏指令。

操作步骤：

打开宏编辑器：主界面 → 宏编辑按钮
开启录制：宏编辑界面 →勾选 指令录制
在任意地方执行你想要录制的动作（按键、点击等）。
结束录制：编辑界面 →取消勾选 指令录制（录制结束指令自动填充到指令框，同时复制到剪切板中）

图示：指令录制界面
点击宏指令编辑界面确定按钮。
设置触发按键：点击触发键按钮，新窗口选择触发键，例如 F9。
点击主界面左下角应用并保存按钮即可。

配置效果：当按下触发键F9时,自动执行录制的内容
📌 录制器适合快速搭建流程操作，之后可手动微调。

5️⃣. 字串宏

功能说明：

当按下一系列设定的字串时，触发宏。
例如输入 wasd、word、aa、aaaa等等字串
字串宏和按键宏的区别是：字串宏根据输入的字串触发，按键宏根据按键状态触发

操作步骤：

选择字串宏页签: 主界面下点击切换到字串宏页签。
添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击触发键按钮，新窗口点击两次按钮A。

图示：字串宏触发键配置界面
设置宏指令：点击 宏指令按钮 → 指令选项中点击 运行 → 路径下输入notepad.exe → 点击编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。

图示：运行指令配置界面
点击主界面左下角应用并保存按钮即可。

配置效果：当双击按键A,软件辅助打开notepad.exe

6️⃣. 定时宏（指定时间触发）

功能说明：当到达指定时间时，触发宏。

操作步骤：

选择定时宏页签: 主界面下点击定时宏页签。
添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击定时按钮，新窗口开始时间设置成当前时间+2分钟。

图示：定时宏时间配置界面
设置宏指令：点击 宏指令按钮 → 指令选项中点击 输出 → 输出方法拉取选取软件弹窗 → 点击编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。

图示：输出指令配置界面
点击主界面左下角应用并保存按钮即可。

配置效果：当到达设置时间时,软件弹窗显示指定文本内容

7️⃣. 搜索图片（图像识别）

功能说明：寻找屏幕上的某张图片，找到后执行点击动作。（按键实现b站点赞）

操作步骤：

添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击触发键按钮，新窗口选择触发键，例如 F7。
设置宏指令：在宏指令编辑界面 → 指令选项中点击 搜索。
打开UP的B站视频：https://www.bilibili.com/video/BV1oWVRzaEzk
设置图片：点击截图按钮，截取你要识别的图片，只要截图能识别的特征部分

图示：截图内容（要自己截图，因为电脑的色差，缩放不同）
设置搜索区域（可选）：按F1后鼠标左键点击拖拽一个矩形区域
设置点击：勾选找到后鼠标移动至目标点击

图示：搜索指令配置界面
确定设置：点击搜索编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。
点击主界面左下角应用并保存按钮即可。

配置效果：当按下触发键F7时,软件辅助找到点赞图标，移动过去自动点击

📌 注意：图像不能经过缩放，图像大小48*48识别效果最佳。减小搜索范围可以降低性能消耗，增加搜索速度。

8️⃣. 搜索颜色

功能说明：在指定屏幕区域查找某个颜色（可用于检测 UI 状态）。

操作步骤：

添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击触发键按钮，新窗口选择触发键，例如 F6。
设置宏指令：在宏指令编辑界面 → 指令选项中点击 搜索。
设置搜索类型：搜索类型选择颜色
取色：鼠标移动到取色位置，按F3即可完成取色，颜色文本框会自动填写颜色值
设置找到后指令：配置任意指令即可
设置未找到后指令：配置任意指令即可

图示：搜索指令配置界面
确定设置：点击输出编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。
主界面左侧点击应用并保存按钮即可。

配置效果：当按下触发键F6时,软件找到颜色执行找到后指令，否则执行未找到后指令

📌 注意：减小搜索范围可以降低性能消耗，增加搜索速度，不限定搜索范围，屏幕中只要有这个颜色就会触发，这可能是你不需要的。

9️⃣. 搜索文本（OCR 识别）

功能说明：识别屏幕上的文字内容，并据此执行条件操作。

操作步骤：

添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击触发键按钮，新窗口选择触发键，例如 F3。
设置宏指令：在宏指令编辑界面 → 指令选项中点击 搜索。
设置搜索类型：搜索类型选择文本
设置文本：在文本编辑框输入搜索的文本（例如：测试文本）
设置搜索区域（可选）：按F1后鼠标左键点击拖拽一个矩形区域
设置找到后指令：配置任意指令即可
设置未找到后指令：配置任意指令即可

图示：搜索指令配置界面
确定设置：点击搜索编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。
主界面左侧点击应用并保存按钮即可。

配置效果：当按下触发键F3时,软件辅助识别文本后执行找到后指令，否则执行未找到后指令

🔟. 鼠标移动

功能说明：鼠标移动到指定坐标

操作步骤：

添加新宏: 点击按键宏模块顶部新增宏按钮。
设置触发按键：点击触发键按钮，新窗口选择触发键，例如 F4。
设置宏指令：点击 宏指令按钮 → 指令选项中点击 移动
设置移动坐标：修改坐标位置x、坐标位置y
设置移动速度：修改移动速度（100则瞬移）

图示：移动指令配置界面
点击移动编辑界面确定按钮 → 点击宏指令编辑界面确定按钮。
主界面左侧点击应用并保存按钮即可。

配置效果：当按下触发键F4时,软件辅助鼠标移动至桌面坐标（100,100）

1 间隔

指令界面
配置界面

功能说明

插入间隔：用于在其他指令之间加入延时。
控制宏循环：放置在宏末尾，用于设置循环间隔时间。

类型说明

固定：固定间隔时间
随机：时间1~时间2 随机间隔时间

参数解析

整数：表示间隔的时长（毫秒）。
变量：取变量值作为间隔时长（毫秒）。

2 按键

指令界面
配置界面

功能说明

使勾选上的按键执行按下、松开、点击动作

特别说明

按下，松开是不消耗时间的，可以理解为瞬发
指令按下a，不是连续不间断的输入a（物理键盘上长按a，系统会经过处理，不断的松开，然后再按下）
按下后建议搭配一个松开，如果不松开再次按下，后续按下指令可能无效（卡键）
点击时间小于200表现为点击，大于250表现为长按
点击消耗的时间：（点击时间+每次间隔）*点击次数 - 每次间隔

手柄按键说明

使用前需安装软件Joy目录下 ViGEmBus.exe，否则手柄功能无法生效」。

键盘按键检测

点击输入框。
按下目标按键/组合键。
点击「确定」按钮，自动勾选对应按键。

参数解析

类型：按下 / 松开 / 点击（只有点击操作可配置以下参数）。
点击时间：按下到松开的时间。
点击次数：连续点击次数。
每次间隔：松开到下一次按下的间隔时间。

指令格式

按键_按键名_按键类型_点击时间_点击次数_每次间隔

3 搜索

指令界面
配置界面

功能说明

在屏幕上搜索 图片、颜色或文本，并根据搜索结果执行不同分支指令。

特别说明

鼠标动作和分支指令是同时执行的，必要时分支指令前需要加上间隔，让鼠标动作结束后再执行分支指令
搜索文本支持正则表达式
搜索范围越小，搜索速度越快
搜索图片越小，搜索速度越快
搜索图片时，只需要截取特征内容部分，不要包含会变化的背景元素（推荐32*32 或者 48*48）
搜索图片，文本出现dll加载失败，请浏览问题及应对措施，或者自己从网络上下载dll打上补丁

快捷键

F1：开启框选范围（左键松开后关闭）。
F2：截图作为搜索图片素材，并根据图片位置、大小自动选取搜索范围。
F3：选取当前鼠标位置颜色值作为颜色搜索的素材。

定位取色器

方便更加精细确定坐标，拾取颜色

搜索类型

图片：在范围内匹配目标图片，可选择本地图片或者截图。
颜色：在范围内查找颜色，可输入颜色值或用 F3快捷键取色。
文本：在范围内匹配文本，可输入文本进行匹配（支持正则表达式）。

搜索范围

指定起始坐标到终止坐标的矩形区域。

搜索目标

搜索图片：通过选择本地图片，或屏幕截图
搜索颜色：鼠标移动到目标点位，按下F3选取颜色
搜索文本：输入要搜索的文本即可

鼠标动作

无动作：不操作鼠标
移动至目标
移动并点击 1 次
移动并点击 2 次

分支指令

找到目标 → 执行找到后的指令（可选）。
未找到目标 → 执行未找到后的指令（可选）。

4 搜索Pro

指令界面
配置界面

功能说明

该功能是搜索，不是识别，因此源素材要和目标基本一致才能搜索成功
屏幕搜索：屏幕上搜索 图片、颜色或文本，并根据搜索结果执行不同分支指令。
窗口搜索：在符合窗口信息的窗口中搜索 图片、颜色或文本，并根据搜索结果执行不同分支指令。
PRO：支持保存结果到变量中。找到目标时也支持将目标中心点坐标保存到变量中
搜索Pro 和搜索指令本质是一样的，搜索指令简化很多配置，这样小白更容易上手

特别说明

搜索次数无限时，会一直搜索直到目标图片出现后执行结果真的分支指令（结果假分支指令不可能触发）
搜索Pro指令消耗的时间：（检索时间+每次间隔）*真实搜索次数-每次间隔
截图大小推荐（32*32px），文本搜索推荐多文本搜索

定位取色器

方便更加精细确定坐标，拾取颜色

窗口信息

此配置用于锁定目标窗口：句柄ID、标题+窗口类+进程名
当多窗口匹配时，鼠标动作会对多个窗口进行处理

基本参数

相似度：搜索元素与素材的匹配度（值越大越严格）。
搜索次数：多次尝试，直到找到或次数用尽。
搜索范围：指定起始坐标到终止坐标的矩形区域。
搜索间隔：每次搜索之间的间隔（仅当次数 > 1 时生效）。

鼠标动作

移动速度：鼠标移动到目标的速度（100 为瞬移）。
点击次数：移动后点击次数。

图片识别模型

OpenCV 模型（推荐使用）（仅 64 位）：
- 相似度 0~94：灰度识别（特别快，不校对颜色）。
- 相似度 95~100：图像+颜色识别（快）。
RMT 识图：使用 AHK 默认的 ImageSearch 接口（速度很慢）。

文本识别模型

中文模型：识别中/英/数字（字库大，速度稍慢）。
- 字库文件：Plugins\RapidOcr\ch_models\ppocr_keys_v1.txt
英文模型：识别英文/数字（字库小，速度稍快）。
- 字库文件：Plugins\RapidOcr\en_models\ppocr_keys_v1.txt

⚠️ 如果 ppocr_keys_v1.txt 中缺少特定文字，请手动添加到文件顶部。

搜索文本

输入文本：检索范围内对应文本（支持正则）。
变量值：检索范围内变量的值。

分支指令

找到目标 → 执行找到后的指令（可选）。
未找到目标 → 执行未找到后的指令（可选）。

结果保存

搜索成功：保存真值到变量中。
搜索失败：保存假值到变量中。

目标点保存

搜索成功：保存目标点全局坐标到变量。
搜索失败：不进行任何操作。

5 移动

指令界面
配置界面

功能说明

鼠标指针根据参数进行移动。

快捷键

F1：将当前坐标设置成指令目标点。

基本参数

坐标位置X：移动目标点的X轴坐标。
坐标位置Y：移动目标点的Y轴坐标。
移动速度：指针的移动速度（0~100，100为瞬移）。

相对位移

勾选：勾选时使用相对位移：

目标点X轴坐标：当前鼠标坐标X + 坐标位置X。
目标点Y轴坐标：当前鼠标坐标Y + 坐标位置Y。

未勾选：未勾选使用绝对位移

目标点X轴坐标：坐标位置X。
目标点Y轴坐标：坐标位置Y。

指令格式

移动_坐标X_坐标Y_移动速度_是否相对位移

6 移动Pro

指令界面
配置界面

功能说明

鼠标指针根据参数进行移动或点击。

快捷键

F1：将当前坐标设置成指令目标点。

基本参数

坐标位置X：整数/变量。
坐标位置Y：整数/变量。
移动次数：进行多次移动（相对位移下该参数才有效）。
每次间隔：移动开始后，间隔一段时间后进行下次移动（移动次数>1该参数才有效）。

相对位移

勾选：勾选时使用相对位移：

目标点X轴坐标：当前鼠标坐标X + 坐标位置X。
目标点Y轴坐标：当前鼠标坐标Y + 坐标位置Y。

未勾选：未勾选使用绝对位移

目标点X轴坐标：坐标位置X。
目标点Y轴坐标：坐标位置Y。

游戏视角

该选项主要用于调整游戏的镜头视角。
此模式下强制鼠标动作为移动，相对位移，移动速度100。

7 输入

指令界面
配置界面

功能说明

弹窗或按钮输入变量值
控制宏暂停&继续的指令

类型

弹窗：弹窗输入变量值
状态：通过真假按钮输入真值为1，假值为0
继续：点击按钮以继续宏指令
继续&取消：继续或终止宏指令

交互时

暂停当前宏：输入交互时暂停当前执行的宏
暂停所有宏：输入交互时暂停所有执行的宏

取消时

终止当前宏：点击取消按钮时终止当前宏
终止所有宏：点击取消按钮时终止所有宏

特别说明

交互时：回车键默认为真值或继续
交互时：ESC键默认为假值或取消

8 输出

指令界面
配置界面

功能说明

以指定的形式输出信息

输出类型

发送内容：使用AHK的SendText指令发送内容。
粘贴内容：使用Ctrl+V组合键粘贴内容。
临时提示：使用ToolTip在鼠标指针旁显示内容（默认显示5s）。
指令窗口：将内容输出到指令显示窗口。
软件弹窗：通过软件弹窗显示内容。
系统语音：通过语音播输出内容。
复制到剪切板：将输出内容复制到剪切板。

输出内容特别说明

{var}：执行时将变量var的值替换内容中的{var}
{εArr}：执行时将数组Arr的值替换内容中的{εArr}

9 循环

指令界面
配置界面

功能说明

多次执行循环体中的指令

基本参数

循环次数：循环体将要执行的次数
循环条件：满足条件时继续循环或退出循环
逻辑关系：条件之间的逻辑关系
循环体：多个指令组合，每次循环时执行

循环条件

无：按循环次数执行循环体
继续条件：按循环次数执行循环体，每次执行循环体判断条件是否符合，符合条件才执行循环体
退出条件：按循环次数执行循环体，每次执行循环体判断条件是否符合，符合条件时退出循环

10 宏操作

指令界面
配置界面

功能说明

对正在运行的宏进行管理操作

特别说明

插入到当前宏: 指定宏按循环次数插入（无限循环仅插入一次）

基本参数

宏类型：要操作的宏类型。
宏序号：要操作的宏索引。

操作类型

插入到当前宏：将指定宏插入当前宏指令中，配置时可以简化逻辑模块。
触发：运行指定宏，指定宏和当前宏同时执行。
暂停：暂停正在运行的指定宏（如果指定宏不在运行状态则指令无效）。
取消暂停：恢复被暂停的指定宏（如果指定宏不在暂停状态指令无效）。
终止：终止正在运行的指定宏（如果指定宏不在运行或暂停状态指令无效）。

11 变量

指令界面
配置界面

功能说明

创建变量、字符变量、随机数值变量、变量值复制、删除变量、实时获取句柄、实时获取坐标等系统变量

特别说明

所有创建的变量都是全局变量
系统变量不能进行赋值操作（操作也无效）

指令选项

变量存在忽略：如果变量已经存在忽略对该变量的操作

操作类型

数值：对变量进行赋值
随机数值：在最小值和最大值之间随机生成一个数值对变量赋值
字符：使用字符对变量赋值
系统：获取系统内置变量
删除：删除变量，如果变量不存在指令无效

系统变量

循环次数：如指令上级存在循环指令，则该变量为该循环体执行的次数
宏循环次数：配置整体执行的次数
句柄ID：实时获取当前鼠标窗口句柄ID
当前鼠标颜色：实时获取当前鼠标指针下颜色（形如EEFF44）
当前鼠标坐标X：实时获取当前鼠标X"
当前鼠标坐标Y：实时获取当前鼠标Y"
当前日期：实时获取当前日期（形如2026-04-12）
当前时间：实时获取当前时间（形如19:46）
当前时间秒：实时获取当前时间(秒)（形如19:46:58）
当前秒：实时获取当前秒（形如58）

12 变量提取

指令界面
配置界面

功能说明

从屏幕、剪切板、窗口中提取数值或者文本保存到变量中

基本参数

提取源：屏幕、剪切板、窗口
提取文本：从源文本提取变量的格式
搜索次数：多次尝试，直到找到或次数用尽。
搜索间隔：每次搜索之间的间隔（仅当次数 > 1 时生效）。
屏幕提取选项: 提取源为屏幕时，需要设置的必要选项
结果保存选项：提取结果按顺序保存到对应的变量中

窗口信息

此配置用于锁定目标窗口：句柄ID、标题+窗口类+进程名
当多窗口匹配时，会对多个窗口内容进行处理

屏幕提取选项

识别模型

中文模型：识别中/英/数字（字库大，速度慢）。
- 字库文件：Plugins\RapidOcr\ch_models\ppocr_keys_v1.txt
英文模型：识别英文/数字（字库小，速度快）。
- 字库文件：Plugins\RapidOcr\en_models\ppocr_keys_v1.txt

⚠️ 如果 ppocr_keys_v1.txt 中缺少特定文字，请手动添加到文件顶部。

F1：左键框选提取范围（快捷键）
提取范围：起始坐标和终止坐标点对应的矩形范围

结果保存选项

变量存在忽略：如果变量存在忽略对变量的操作
开关：未勾选后，将忽略对应变量赋值操作
变量名：将提取到的内容保存到对应的变量中

提取文本

空内容时，屏幕/剪切板所有文本信息保存到变量中
使用&x代替数字变量位置，使用&c代替文本变量位置
提取文本中{变量名}表示变量的值
形如："&x"从识别的的文本中提取第一个数值到变量1中
形如："&c"从识别的的文本中提取第一段文本到变量1中
形如："HP：&x"可以从"HP：3,000"文本提取中的3000到变量1
形如："坐标(&x,&x)"可以从"坐标(10.5,8.6)"文本提取中的10.5和8.6到变量1和变量2
形如：{Title}："&x"如果Title变量值是"血量"，则可以从"血量：20.5"文本提取中的20.5到变量1
形如：{Title}："&x"如果Title变量值是"蓝量"，则可以从"蓝量：20.5"文本提取中的20.5到变量1

注意事项

1. 变量提取不是100%成功
1. 假如现在要提取变量到->Num1中
- 如果“Num1”变量不存在，并且提取失败，那么会创建“Num1“变量，值为0
- 如果“Num1”变量已经存在，并且提取失败，那么不会对变量进行任何操作
- 如果“Num1”变量已经存在，并且提取成功，那么会创建“Num1“变量，值为提取的值
- 如果“Num1”变量不存在，并且提取成功，那么会创建“Num1”变量，值为提取的值

13 如果

指令界面
配置界面

功能说明

根据逻辑结果执行对应的分支指令

判断类型

大于：左边数值大于右边数值
大于等于：左边数值大于等于右边数值
等于：左边数值等于右边数值
小于等于：左边数值小于等于右边数值
小于：左边数值小于右边数值
字符包含：左边的字符包含右边的字符
变量存在：左边变量存在
正则表达式：左边变量或值符合右边的正则表达式

逻辑关系

且：所有判断都真，结果真，否则结果假
或：只要有一个判断真，结果真，否则结果假

分支指令

找到目标 → 执行找到后的指令（可选）。
未找到目标 → 执行未找到后的指令（可选）。

流程控制

无：不进行任何流程控制操作
循环-跳过本轮：跳过本轮循环，即立即结束本轮循环
循环-跳出：跳出上层循环
分支-跳出：跳出上层分支

结果保存

开关：未勾选，则不保存结果
选择/输入：保存结果对应的真值或者假值的变量名

指令顺序：结果保存->分支指令->流程控制

14 如果Pro

指令界面
配置界面

功能说明

自上而下执行满意第一个条件的分支指令，若都不满足则执行"以上都不是"分支指令

分支右键菜单

编辑：打开新窗口编辑分支的条件，分支指令
向上插入分支：对应位置插入新的分支
向下下入分支：对应位置插入新的分支
向上移动：分支位置上移，优先级增加
向下移动：分支位置下移，优先级降低
删除：删除对应分支

15 运算

指令界面
配置界面

功能说明

通过运算表达式获得新数值保存到变量中

基本参数

运算表达式：对选择的变量进行运算变换操作，不会改成变量原本的值
保存结果变量：用一个变量保存运算表达式中运算后的结果值

16 运行

指令界面
配置界面

功能说明

运行文件、运行进程、访问网址，执行文件、执行脚本、播放音乐等。

快捷键

F1：将鼠标下进程设置成路径。

路径

网址：执行指令时访问该网址。
路径：执行指令时运行该文件。

17 文件读写

指令界面
配置界面

功能说明

对文本文件、Excel读取或写入内容

操作类型

读取Excel

单元格：读取指定单元格内容
指定行：读取指定单元格右侧的所有表格内容
指定列：读取指定单元格下方的所有表格内容
指定区域-行：逐行读取指定区域所有表格
指定区域-列：逐列读取指定区域所有表格

写入Excel

单元格：把输出内容写入特定单元格
行号自增：把输出内容写入指定单元格右侧第一个空表格中
列号自增：把输出内容写入指定单元格下方第一个空表格中
指定区域-行：把数组写入指定单元格右下方区域（一维数组时：写入一行）
指定区域-列：把数组写入指定单元格右下方区域（一维数组时：写入一列）

读取文本文件

读取全部内容：读取文本文件中所有的文本
逐行读取：从指定行开始逐行读取文本文件的内容
指定行：读取文本文件指定行中的内容

写入文本文件：

覆盖写入：清空文本文件所有内容，然后写入内容
追加写入：文本文件中末尾追加写入内容
追加写入-行: 文本文件末尾添加回车后写入内容
指定行：替换指定行的内容
行号自增：有空行内容时替换空行，否则末尾追加写入-行

特别说明

如果Excel表格写入时表格没打开，写入速度特别慢。已打开写入速度比较快。
表名或序号：此处输入要写入的表格名称或者表格在所有表格中的序号（从1开始）

18 文本处理

指令界面
配置界面

功能说明

对文本或变量进行处理（分割，提取，替换，去空格，大小写转换，统计等）

处理类型

文本分割：按文本内容或固定长度分割源文本
文本提取：提取源文本中的数字，单词，中文
文本替换：替换源文本中的内容
去除空格：按类型去除前、后或所有的空格
大小写转换：源文本中的大小写按类型调整
文本统计：统计源文本中字符数、单词数、行数

类型参数

分割文本：根据分割文本对源文本进行分割
定长分割：源文本分割成固定长度的文本段
查找文本：源文本中需要替换的文本
替换文本：源文本中查找文本替换成该文本

19 数组

指令界面
配置界面

功能说明

包含值的列表或序列

类型

创建：按初始数据创建数组
克隆：复制已存在的数组
删除：删除数组
包含：数组中是否包含指定的值或数组
取值：获取数组值列表中的值
赋值：修改数组值列表中的值
插入：数组值列表中插入新的值
追加：数组值列表末尾追加新值
移除：数组值列表移除对应序号的值
移除最后：数组值列表末尾的值移除
反转：数组值列表反转，即第一个值变成末尾的值，末尾的值变成第一个值
长度：数组值列表的个数

子索引

数组支持二维，该参数可控制数组或子数组进行调度
一维数组时，保持默认值0即可
0时，类型操作对象是数组本身
N时，类型操作对象是数组值列表第N个值

数组访问下标从1开始

20 RMT指令

指令界面
配置界面

功能说明

调用RMT（若梦兔）软件指令或者操作系统指令。

操作类型

截图：调用RMT软件截图指令，截图保存到 Images\ScreenShot 文件夹下。
截图提取文本：调用RMT软件提取文本指令，提取文本保存到剪切板中。
自由贴：调用RMT软件自由贴指令，将剪切板中的图片或文本贴在桌面上。
开启指令显示：勾选指令显示开关，窗口显示软件运行的指令。
关闭指令显示：取消勾选指令显示开关。
显示菜单：显示指定序号的菜单轮。
关闭菜单：关闭菜单轮。
启用键鼠：恢复键盘鼠标的正常输入（需要管理员身份运行软件）。
禁用键鼠：禁用键盘鼠标的输入（需要管理员身份运行软件）。
休眠：立即终止所有宏，并禁用软件的所有功能。
暂停所有宏: 立即暂停所有宏。
恢复所有宏: 恢复所有被暂停的宏。
终止所有宏：强制终止所有正在运行的宏任务，不可恢复。
重载：重新加载当前配置，撤销未保存的修改，恢复至最近一次应用状态。
关闭软件：退出关闭若梦兔软件

21 后台鼠标

指令界面
配置界面

功能说明

对指定窗口进行后台鼠标操作，不影响真实键鼠操作

特别说明

部分窗口该指令无效
部分窗口需要管理员权限运行软件，才有效

快捷键

F1：设置鼠标下窗口标题。
F2：设置鼠标下窗口的鼠标窗口坐标。
F3：设置鼠标标题和位置。

基本参数

鼠标按键：左键、中键、右键、滚轮。
操作类型：点击、双击、按下、松开。
窗口坐标：后台鼠标操作时的窗口位置。
滚动数值：滚轮滚动的数值。

22 后台按键

指令界面
配置界面

功能说明

对指定窗口进行后台按键操作。不影响真实键鼠操作

特别说明

部分窗口该指令无效
部分窗口需要管理员权限运行软件，才有效
按下，松开是不消耗时间的，可以理解为瞬发
指令按下a，不是连续不间断的输入a（物理键盘上长按a，系统会经过处理，不断的松开，然后再按下）
按下后建议搭配一个松开，如果不松开再次按下，指令可能无效
点击消耗的时间：（点击时间+每次间隔）*点击次数 - 每次间隔
点击时间小于200表现为点击，大于250表现为长按

窗口信息

指令绑定的窗口信息

参数解析

类型：按下 / 松开 / 点击（只有点击操作可配置以下参数）。
点击时间：按下到松开的时间。
点击次数：连续点击次数。
每次间隔：松开到下一次按下的间隔时间。

23 窗口管理

指令界面
配置界面

功能说明

对指定窗口进行窗口相关的操作

操作类型

激活窗口：让处于后台或者最小化的窗口激活到前台
最大化窗口：让处于后台或者最小化的窗口最大化窗口
最小化窗口：让指定窗口最小化到任务栏或者托盘
还原窗口：让处于最大化或者最小化窗口还原到之前的窗口大小
关闭窗口：让指定窗口关闭（并不会关闭进程）
移动窗口：让指定窗口（左上角）移动到指定坐标
调整大小：设置指定窗口的宽高
置顶窗口：指定窗口置顶，不会被其他窗口遮挡
取消置顶：窗口恢复正常显示，可以被激活的窗口遮挡
修改标题：设置窗口的标题名称
修改透明度：设置窗口的透明度，让窗口可以半透明
开启鼠标穿透：设置窗口不接受鼠标交互
关闭鼠标穿透：设置窗口恢复正常，可以进行鼠标交互

24 按键检测

指令界面
配置界面

功能说明

检测单个或多个按键的状态

检测模式

同时按下：选择的所有按键按下结果为1，否则为0
有一个按下：选择按键中只要有一个按键按下结果为1，否则为0

检测类型

物理状态：玩家真实按键状态（通过手指操作键盘的按键）
逻辑状态：物理或者宏指令操作的按键状态

tip：罗技等驱动宏也属于物理状态

结果变量

按键检测符合条件时结果变量值为1，否则为0

25 注释

指令界面
配置界面

功能说明

给指令添加备注，没有任何实际效果

26 抓图

指令界面
配置界面

功能说明

指定屏幕区域截图、指定窗口区域截图
截图路径可以保存到变量、搜索图片指令可以使用该变量

抓图类型

屏幕抓图：从屏幕指定区域截图
窗口抓图：从窗口指定区域截图

固定名称

勾选：填写XXX，即固定为名称为XXX.png
不勾选：按时间戳动态生成名称

配置无法生效

正常配置触发键和宏配置后，按下触发键无法触发宏执行
即按下触发键后，对应宏配置序号位置没有出现绿色色块
正常触发效果

解决方法：

宏配置右侧禁用取消勾选
宏配置模块中禁用取消勾选
宏配置模块中的前台内容清空（除非你知道前台的作用）
配置后需要应用并保存配置才会生效

提示：不支持覆盖文件更新软件，覆盖内容更新也出现宏触发无效（请使用软件的配置迁移，或导出导入同步配置）

游戏中配置无效

在记事本中可以正常触发，但在游戏中无法触发或触发后配置不生效。

解决方法：
1、RMT(若梦兔)设置界面勾选 管理员启动 选项，左下角应用并保存后，测试配置是否正常
2、宏配置->按键类型 -> AHI确定后，左下角应用并保存后，测试配置是否正常
3、运行GHUB、进入若梦兔宏配置，修改宏按键类型->罗技确定后，左下角应用并保存后，测试配置是否正常
4、如以上方法无效，请执行1、2 或者 1、3：以管理员身份运行软件 + 修改宏按键类型

侧键无法触发宏

触发键设置为其他按键可以正常触发，但设置为鼠标侧键时无法触发宏。
这通常是因为侧键已经在 G HUB、雷蛇 等驱动配置软件中被绑定了其他功能。

解决方法：
打开对应鼠标硬件的配置软件，删除侧键上已绑定的功能，保存后即可正常触发。

部分宏按键无效

使用360、火绒、腾讯电脑管家等安全软件，若梦兔的宏按键鼠标左键、右键、回车键将统统无效
解决方法：

关闭安全软件
把若梦兔软件添加到安全软件的白名单中

配置突然失效

此类问题通常由环境或配置变动引起，请逐项排查。

解决方法：

设置界面忘记勾选 管理员启动
宏配置模块中误填了前台信息，请清空
360、火绒、腾讯电脑管家等安全软件拦截了按键（关闭或将若梦兔加入白名单）
文件被系统误删，点击软件 工具 → 文件校验 补齐

罗技键鼠无效

按键类型选择「罗技」时，键盘与鼠标都依赖 G HUB 2022.2.1154 及更早版本。

解决方法

1、安装旧版 G HUB（交流群文件下载）
2、打开 设备管理器，确认能看到罗技的两个 GHUB 虚拟设备（如下图）。
看不到这两个设备时，罗技功能无法使用。

设备管理器中的 GHUB 虚拟设备

3、若没有上述设备：到系统「安装的应用」中卸载 G HUB，再重新安装旧版，直到设备管理器中出现这两个虚拟设备为止。
4、运行「禁用 G HUB 更新」脚本（交流群文件可下载），尽量避免被自动升到新版。

提示：仅在 G HUB 软件里关掉更新有时会失效。一旦G HUB升级到新版本，若梦兔罗技按键类型将失效

指令丢失

宏指令执行过于紧凑时，可能会导致部分指令未被系统识别或执行。
原因：系统处理指令需要时间，若指令之间没有合理间隔，后续指令可能被丢弃。

解决方法

在指令之间增加适当的间隔，可以有效提升宏执行的稳定性。

场景	推荐值/做法
宏按键点击时长（按下到松开）	推荐 100ms
宏按键点击时长（最低不建议）	低于 30ms 易丢失
搜索按钮点击操作（不影响功能前提下）	后续增加 500ms 或更多间隔，避免按钮响应慢，影响后续指令
宏末尾（不影响功能前提下）	增加 200ms 间隔，有助于避免状态异常
通用习惯	不追求极限速度时，多插入100ms间隔是良好的习惯

宏按键说明

基本规则

宏配置结束后，请确保所有宏按键都已松开，否则可能导致配置失效或按键卡住（除非刻意需要保持按下状态）。
宏按键的「点击」操作，实际由三个指令组合而成：按下 → 间隔（点击时长）→ 松开。

点击时长与表现

点击时长	表现
≤ 250ms	点击操作
250ms ~ 500ms	因不同软件、游戏而有所差异
≥ 500ms	长按操作

重复按下

宏按键「按下后未松开又再次按下」的行为，可在软件设置中配置处理方式。

真实键盘无法触发此行为（通常无效）；部分按键检测网站可能检测不到，但记事本中可正常输出。

随机间隔

设置界面「数值选项」中可配置以下随机浮动：

点击时间浮动：宏按键点击时长的随机浮动
每次间隔浮动：宏按键多次点击时，每次间隔的随机浮动

如有其他问题，请前往用户交流群或 GitHub 提交 issue 获取进一步帮助。

运行报错1

下载软件压缩包，未解压运行

$问题截图$

原因：
下载zip包后，直接浏览zip包里面的文件，并运行若梦兔应用程序

解决方法：

解压后再运行软件

运行报错2

运行若梦兔应用程序报错
问题截图

原因：
若梦兔文件放在受保护的文件夹中，导致若梦兔运行时没有创建文件夹的权限、没有访问自己配置文件的权限
解决方法：

更换若梦兔文件的存放位置
移除相关文件的保护限制：window安全中心 -> 病毒和威胁防护 -> 管理设置 -> 文件夹限制访问 -> 受保护的文件夹，找到对应的文件夹并移除

运行报错3

通过阿里云盘或者百度网盘下载软件文件不全或者系统误杀删除部分文件

问题截图

解决方法：

设置->文件校验自动补齐缺失文件
通过开源网址的发行版处重新下载软件
通过软件交流群中的群文件重新下载软件

配置迁移报错

低于1.0.8版本配置迁移到1.0.8版本中

问题截图

解决方法：

不支持低于1.0.8版本配置迁移到1.0.8及以上版本，请重新配置

音频播放错误

播放音频时报错

问题截图

解决方法：

命令行窗口执行（忽略报错弹窗）：regsvr32 wmp.dll
没勾就勾上
勾上了取消保存在重新勾选

Excel读写失败

Windows存在UAC（用户账户控制）隔离

问题截图

解决方法：

Excel表格以管理员权限打开，若梦兔（RMT）软件也需要以管理员权限打开
Excel表格以非管理员权限打开，若梦兔（RMT）软件需要以非管理员权限打开

如有其他问题，请前往用户交流群或 GitHub 提交 issue 获取进一步帮助。

📘 开发指南（RMT）

本文档概述了 RMT（若梦兔）按键宏工具的模块架构与功能，方便开发者快速理解项目结构与功能。

📂 项目总体架构

用户操作 / 热键触发
    ↓
BindUtil.ahk (热键路由)
    ↓
MacroUtil.ahk.OnTriggerMacroOnce (指令解析 & 分发)
    ↓
ExecuteMacroCmdOnce (单条指令执行)
    ├─ 键盘/鼠标/手柄模拟
    ├─ 图片识别 (OpenCV)
    ├─ 文字识别 (RapidOcr)
    ├─ 循环/条件判断
    ├─ 运行程序/脚本
    └─ 其他指令...
支持多线程: WorkPool.ahk → Thread/Work.exe (独立进程)

📂 主程序入口

`RMT.ahk`

程序的主入口，负责初始化与启动。

初始化流程：

SelfCheckMissingFiles() — 文件完整性自检（开发阶段注释掉）
InitFilePath() — 初始化文件路径（配置文件、日志等）
LoadCurMacroSetting() — 加载用户配置文件
HandleOpenArg() — 处理打开软件的参数
EditListen() — 滚轮按键监听
InitData() — 初始化软件内部数据缓存
InitUI() — 初始化主界面 UI
SetEditData() — 缓存编辑器数据
PluginInit() — 初始化插件（耗时较长，放后面）
TimingCheck() — 轮询检测定时触发
BindKey() — 绑定全局快捷键

🧠 核心模块 (`Main/`)

`GlobalUtil.ahk`

功能概述：
全局变量声明与模块引用中心。通过 #Include 串联所有核心模块和 GUI 模块。

职责内容：

声明 MySoftData、MainSoftData 等全局变量
#Include 所有核心模块（WorkPool, UIUtil, TimingUtil, BindUtil, VariableUtil 等）
#Include 所有 GUI 模块
#Include 部分插件（ViGEm, AHK-XAML, MacroGraph）

`DataClass.ahk`

功能概述：
定义程序中用到的数据结构与宏指令的数据模型。

职责内容：

TableItem — 主表格数据结构，含每个宏项的状态、触发键、循环次数等
Timer — 定时器/计划配置
SoftData / MainConfig — 全局配置对象（主题、快捷键映射、用户偏好设置）
各类 *Data 类（KeyboardData, SearchData, LoopData, RunData 等）— 宏指令数据模型

`AssetUtil.ahk`

功能概述：
统一管理资源（如图标、配置文件等）的加载、保存与转换。

职责内容：

InitFilePath() — 初始化所有文件路径
加载本地资源（图像、图标、模板等）
保存用户生成的数据（宏配置文件）
语言文件加载与切换

`SelfCheck.ahk`

功能概述：
文件完整性自检工具。

职责内容：

SelfCheckMissingFiles() — 检查关键依赖文件是否存在（OCR模型、DLL、音频等）
若缺失则从 GitHub Releases 自动下载

工具模块 (`Main/Util/`)

`MacroUtil.ahk` — ⭐ 核心宏执行逻辑

功能概述：
解析并执行宏指令。

职责内容：

OnTriggerMacroOnce(tableItem, macro, index) — 触发并执行单条宏（拆分指令、遍历执行）
ExecuteMacroCmdOnce(tableItem, cmdStr, index, graphNode) — 执行单条宏指令
所有指令类型的执行函数：OnPressKey, OnInterval, OnSearchWrapper, OnMouseMove, OnRunFile, OnCompare, OnVariable, OnLoop 等
支持递归调用（循环、条件分支等）

`MacroClipboardUtil.ahk`

宏的复制、粘贴、导入导出操作。

`GraphMacroUtil.ahk`

流程图宏的执行逻辑。

`JsonUtil.ahk`

JSON 解析与序列化。

`InputUtil.ahk`

输入框验证与处理工具。

`TextOpsUtil.ahk`

文本处理指令的执行逻辑。

`SearchUtil.ahk`

图片搜索指令的执行逻辑（调用 OpenCV 插件）。

`CompareUtil.ahk`

条件比较指令的工具函数。

`ExcelUtil.ahk`

Excel 文件读写工具。

`FileIOUtil.ahk`

文件读写指令的执行逻辑。

`ExpressUtil.ahk`

表达式计算引擎。

`LangUtil.ahk`

国际化工具（加载语言文件、翻译字符串）。

`FixCompatUtil.ahk`

旧版本配置文件的迁移改写（入口 Gui/SettingMgrGui.ahk）。仅主程序加载，由 Main/GlobalUtil.ahk 引入，Worker 不加载。新增迁移函数请放这里。

`CompatDataUtil.ahk`

内存数据结构的旧版本字段补齐（Compat1_0_8F4FlodInfo、CompatEnsureArrLength）。主程序与 Worker 共用，由 Main/AssetUtil.ahk 引入，因此不可引用主程序专属函数。

`Gdip_All.ahk`

GDI+ 图像处理库。

`HumanMouse.ahk`

人类化鼠标移动算法。

`PresssKeyUtil.ahk`

底层按键模拟工具。

`ArrayUtil.ahk`

数组操作工具函数。

`SerialUtil.ahk`

指令序列化标识管理（GetCMDSerialStr）。

`RingBuffer.ahk`

环形缓冲区（用于 Worker 进程通信）。

`SharedMemory.ahk`

共享内存封装（用于 Worker 进程通信）。

`PluginUtil.ahk`

插件加载与管理。

`ErrorHandler.ahk`

全局错误处理与报告。

`MergeUtil.ahk`

配置合并工具。

其他核心模块

`WorkPool.ahk`

功能概述：
多线程 Worker 池管理。

职责内容：

TaskQueue — 任务队列
WorkerData — Worker 进程数据封装
Worker 进程的创建、销毁、任务分发
通过共享内存 + 环形缓冲区与 Worker 通信

`BindUtil.ahk`

功能概述：
全局热键注册与触发路由。

职责内容：

BindKey() — 绑定所有快捷键
BindShortcut() — 注册单个热键/热字串
InitTriggerKeyMap() — 初始化触发键映射
暂停/终止/截图/自由粘贴等工具热键

`UIUtil.ahk`

功能概述：
主窗口 UI 模板，负责构建和控制所有主窗口相关的 UI 元素。

`TimingUtil.ahk`

功能概述：
定时/计划宏的调度与执行。

职责内容：

TimingScheduler — 定时调度器类
支持按时间、间隔、系统启动等多种触发方式

`VariableUtil.ahk`

功能概述：
变量管理与替换引擎。

职责内容：

系统变量与用户变量的读取/写入
宏文本中的变量替换
支持 {变量名} 语法

`RecordUtil.ahk`

功能概述：
键盘/鼠标宏录制。

职责内容：

底层原始输入（Raw Input）监听
按键/鼠标动作捕获与序列化

`RecordJoyUtil.ahk`

功能概述：
手柄宏录制。

`JoyMacro.ahk`

功能概述：
手柄宏支持（按键映射、轴处理）。

`TriggerKeyData.ahk`

功能概述：
触发键数据结构定义。

职责内容：

TriggerKeyData 类 — 管理单个按键的多种触发方式（按下、松开、长按、双击、开关等）

`WindowHotkeyManager.ahk`

功能概述：
窗口热键管理器（为指定窗口绑定热键）。

`FolderPackager.ahk`

功能概述：
文件夹打包工具（用于导出配置）。

🖥️ GUI 模块 (`Gui/`)

`MacroEditGui.ahk`

功能概述：
主宏编辑器，支持用户自定义宏逻辑。

职责内容：

编辑界面的布局与控件初始化
支持多步骤宏指令添加/插入/删除等
提供"录制按键"、"调试"等便捷功能
各类指令的按钮入口

流程图编辑器 (`MacroGraph/`)

功能概述：
可视化流程图宏编辑与执行模块，包含 12 个文件：

文件	职责
`MacroGraphGui.ahk`	主界面
`MacroGraphData.ahk`	数据结构
`MacroGraphNodeUI.ahk`	节点 UI 渲染
`MacroGraphConnections.ahk`	连线管理
`MacroGraphEvents.ahk`	事件处理
`MacroGraphFormal.ahk`	格式化/布局
`MacroGraphFormalHandlers.ahk`	格式化事件处理
`MacroGraphHandlers.ahk`	通用事件处理
`MacroGraphEdit.ahk`	编辑功能
`MacroGraphBranch.ahk`	分支逻辑
`MacroGraphIfPro.ahk`	条件判断节点
`MacroGraphMenu.ahk`	右键菜单

指令编辑 GUI（部分列举）

文件	编辑功能
`KeyGui.ahk`	按键指令编辑
`BGKeyGui.ahk`	后台按键编辑
`BGMouseGui.ahk`	后台鼠标编辑
`SearchGui.ahk`	图片搜索编辑
`SearchProGui.ahk`	专业搜索编辑
`LoopGui.ahk`	循环指令编辑
`RunGui.ahk`	运行文件编辑
`CompareGui.ahk`	条件比较编辑
`CompareProGui.ahk`	专业比较编辑
`TextOpsGui.ahk`	文本处理编辑
`ArrayGui.ahk`	数组操作编辑
`InputGui.ahk`	输入指令编辑
`FileIOGui.ahk`	文件读写编辑
`VariableGui.ahk`	变量编辑
`ExVariableGui.ahk`	变量提取编辑
`OperationGui.ahk`	运算编辑
`UIMacroGui.ahk`	UI 宏编辑
`MouseMoveGui.ahk`	鼠标移动编辑
`MMProGui.ahk`	专业鼠标移动编辑
`KeyCheckGui.ahk`	按键检测编辑
`OutputGui.ahk`	输出指令编辑
`SubMacroGui.ahk`	子宏调用编辑
`WindowManageGui.ahk`	窗口管理编辑
`ScreenShotGui.ahk`	截图指令编辑
`CommentGui.ahk`	注释编辑
`TimingGui.ahk`	定时设置编辑
`TriggerKeyGui.ahk`	触发按键配置
`TriggerStrGui.ahk`	触发字串配置
`MenuWheelGui.ahk`	菜单滚轮设置
`FreePasteGui.ahk`	自由粘贴设置
`SettingMgrGui.ahk`	配置管理
`VarListenGui.ahk`	变量监听
`RMTCMDGui.ahk`	RMT 命令

🧵 线程 Worker (`Thread/`)

文件	说明
`Work.ahk`	工作脚本入口，编译为 `Work.exe` 用于并行执行宏
`WorkUtil.ahk`	Worker 工具函数（初始化、指令执行、通信）
`WrokGlobalUtil.ahk`	Worker 全局配置与变量声明

Worker 通过共享内存（SharedMemory）+ 环形缓冲区（RingBuffer）与主进程通信。

🔌 插件 (`Plugins/`)

插件	能力
`OpenCV/`	图片识别（模板匹配、特征检测），含 x64/x86 版本 DLL
`RapidOcr/`	文字识别（OCR），支持中文/英文模型
`ViGEm/`	虚拟手柄模拟（通过 ViGEmBus 驱动模拟 Xbox/DS4）
`AhiDriver/`	虚拟输入驱动
`ScreenCapture/`	屏幕截图工具（独立 exe 进程）
`AHK-XAML/`	XAML/WPF UI 渲染库
`IbInputSimulator.ahk` + `.dll`	输入模拟库
`MouseControl.ahk` + `.dll`	鼠标控制库
`CLR.ahk`	.NET CLR 宿主，支持调用 C# 代码
`RMT/`	C# 辅助库（RMT.dll, Device.cs, Http.cs）

🌐 国际化 (`Lang/`)

文件	说明
`中文.txt`	中文 UI 字符串
`English.txt`	英文 UI 字符串

语言文件通过 LangUtil.ahk 的键值对查找实现切换。

📦 其他资源目录

目录	说明
`Audio/`	提示音（Start.wav, End.wav）
`Images/`	图片资源（FreePaste, Gif, ScreenShot, Soft）
`Setting/`	用户配置文件（MainSettings.ini, themes.ini）
`MinTool/`	小工具（CountDown 倒计时, PlayAudio 音频播放）
`Log/`	运行时日志
`Web/`	文档（开发指南、指令手册、更新日志、常见问题等）
`ReleaseX64/` / `ReleaseX86/`	发布版本资源
`Joy/`	手柄驱动与按键映射图片

🆕 新指令添加流程（以"开源"指令 OpenSource 为例）

如果你想新增指令，请参考以下流程：

新增数据保存文件路径
在 AssetUtil.ahk 的 InitFilePath 函数中添加：
```
global OpenSourceFile := A_WorkingDir "\Setting\OpenSourceSettings.ini"
```
定义指令数据结构
在 DataClass.ahk 中新增结构体 OpenSourceData，类似已有的 RunData。
重点字段：
- SerialStr — 指令序列化标识，必须唯一，用于区分不同指令。
- 其他参数根据指令需求定义。
新增指令编辑界面
- 复制现有的 Gui/RunGui.ahk，重命名为 Gui/OpenSourceGui.ahk。
- GetCMDSerialStr("运行") 改成 GetCMDSerialStr("开源")
- 根据指令参数调整 AddGui() 和相关接口，确保界面能编辑对应参数。
添加指令按钮入口
- 在 Gui/MacroEditGui.ahk 中新增按钮，调用 OpenSourceGui.ahk 以打开编辑界面。
- 参考已有"文件"按钮实现。
实现指令执行逻辑
- 在 Main/Util/MacroUtil.ahk 的 ExecuteMacroCmdOnce() 中添加 Actions 映射：
```
"开源", OnOpenSource,
```
- 实现 OnOpenSource() 函数，复杂指令参考"按键"指令，简单指令参考"文件"指令。

🚀 Debug 运行测试

编译 Work.ahk

如果调整会对 Work.ahk 有影响，需要先重新编译：
如果重新编译觉得麻烦，也可以临时把多线程改成 0。

清理旧文件
删除 Thread 目录下所有的 .exe 文件（或删除后运行时会自动重新生成）。
打开编译工具
通过 AutoHotkey Dash → 选择 Compile。
选择源文件
- Source：选择 Thread\Work.ahk 文件。
设置输出路径
- Destination：设置为 Thread 目录下的 Work.exe。

运行 RMT.ahk

直接双击 RMT.ahk 文件即可运行。

RMTv1.2更新内容

新增

新增窗口管理指令
新增双击触发类型；触发键可选择两个组合
支持配置合并
新增鼠标拟真移动轨迹
新增界面宏
设置新增管理员权限选项
新增小工具：倒计时（可传参调用，双击打开配置）
新增系统变量「星期几」
宏编辑器支持展开全部 / 折叠；可插入注释（双击编辑）
间隔指令新增随机类型
窗口相关能力增强：透明度、鼠标穿透开/关
输出新增「字符变量」类型
界面宏前台信息支持句柄变量
新增「文件校验」工具：可手动检查并补全缺失文件（不再启动时自动执行）
新增文本处理指令（分割 / 提取 / 替换，支持正则）
新增抓图指令（屏幕或窗口截图，结果可存入变量）
新增「仅前台运行宏」选项
新增图形节点编辑器
新增 PS5 手柄输入支持
运行指令增强：支持向程序输入内容、等待返回结果、窗口启动方式建议等
宏编辑器支持拖拽添加 / 调整指令位置
菜单宏支持粘贴；扇区数量可调整
RMT 指令新增启用 / 禁用鼠标、键盘、键鼠
完善快速输入相关能力
图形节点编辑器：如果 / 搜索 / 搜索Pro / 如果Pro 分支与循环体支持「内联展开」为可编辑节点，并可收缩回写
开关选项新增「自动松开修饰键」（默认开启）：组合键触发宏前先松开 Ctrl / Alt / Shift 等，避免宏内按键被污染
开关选项新增「连续触发」（默认开启）：关闭后，按下 / 开关 / 长按需先松开触发键才能再次触发
新增 AHI 按键类型：首次使用前若未安装驱动，会提示并可一键自动安装（也可按提示手动安装）
指令显示设置新增「输出到文件」与「自动清理时间」（每天 / 每周）选项
宏编辑器树视图支持 Ctrl 多选、Shift 连选，可批量复制 / 粘贴 / 删除
开关选项新增「共享复制」
下拉框选项新增「自动备注」
新增宏终止方法：智能终止 / 强制终止
新增按键检测指令

优化

子窗口改为模态，操作更集中
支持动态多线程（可按需求使用单线程或多线程）
菜单宏热键改为窗口内生效
主界面新增复制按钮
路径可作为变量实时替换
搜索图片路径更易用：自增命名、界面显示路径、不存在时可弹窗选择
运行指令界面优化，支持等待返回值 / 完整输出
指令录制增强：托盘可开始/结束；结束时可覆盖、追加或取消；内容同时复制到剪切板
菜单宏轮盘优化：多屏适配、大小可调、中心关闭、扇区位置、图标显示、数字快捷键
图片识别体积优化；文字识别改为需要时再加载，加快启动
搜索可预览搜索范围
配置合并时，子项勾选会联动父项
组合键新增「触发顺序」选项
设置前台后，宏仅在该前台运行
定时宏可设置结束时间，到期自动停止
管理员权限改为软件内引导提升
轮盘、浮窗、主题与各类设置界面整体美化，并支持统一主题
设置页增加选项说明问号；宏编辑器右键菜单更精简
图形节点编辑器跟随主题，完善搜索 Pro / 循环 / 如果 Pro 等节点
菜单宏默认条目改为 4，界面宏默认 3 并配备注名
优化手柄按键体验、框选坐标提示、日志写入性能
提升多线程协作与按键顺序触发的稳定性
图形节点与逻辑树切换：切回逻辑树时正确压平嵌套图形开始节点（含循环 / 搜索 / 如果 / 如果Pro 分支）
图形节点完整复制：支持深拷贝图形开始节点子图及嵌套分支
图形编辑器内联展开布局与交互（展开间距、嵌套分支清理等）
界面宏浮窗设置：控件值变化增加节流防抖，移除冗余 Tag（#247）
手柄录制：按当前手柄类型（Xbox / PS5）分别映射录制键名；扫描全部物理 XInput 槽并跳过 ViGEm 虚拟手柄
罗技按键兼容性提升：优先使用更稳妥的发送方式；未运行 G HUB / LGS 时会提示，并可一键启动
统一罗技相关提示：键盘与鼠标均需 G HUB 2022.2.1154 及以前版本
提升罗技模式下滚轮与跨屏/大距离鼠标移动的稳定性
搜索 Pro 图片路径：可使用同名变量；不再强制要求本地图片文件事先存在
开关选项分组排列更清晰（开机自启、管理员启动、仅前台运行宏等）
宏编辑器等界面快捷键改为「仅窗口内生效」，离开窗口后不再全局占用按键
Excel 指定区域读取规则更清晰：支持单行/单列，禁止只读一个格子；跨行跨列时输出二维结果
跨进程传递数组时保留嵌套结构，二维数组不再被压扁
AHI 模式下，移动 / 移动Pro / 搜索后的移动点击会真正走 AHI，不再悄悄改用普通移动
移动相关指令统一按「移动选项 + 当前按键类型」选择普通 / 罗技 / AHI；速度统一为 0~100（越大越快，100 为瞬移）
设置页选项顺序调整为：语言 → 软件字体 → 首选编辑器
帮助文档改版：软件介绍 / 快速上手 / 指令手册 / 常见问题 / 常见报错 / 更新日志支持左侧展开与分页浏览，并可直达某一条说明；指令手册各项前显示对应图标；无目录时不再显示右侧大纲栏
软件介绍文案润色：统一图标含义，修正笔误与表述
设置页「手柄类型」修改为「虚拟驱动类型」，触发键中修改手柄触发键类型
变量监视器：标题栏「变量名」「类型」支持横向拖动分界线调整列宽
变量监视器：点击变量条目出现选中高亮，反馈更明显
变量监视器：默认窗口置顶，「窗口置顶」复选框状态与实际置顶同步
逻辑树编辑器支持 Ctrl+C / Ctrl+V 复制、粘贴指令
逻辑树编辑器复制、粘贴指令时，屏幕右下角显示提示并渐隐消失
逻辑树编辑器多选时「跳过指令」/「取消跳过」支持批量应用
统一使用 x86 表示 32 位架构（ReleaseX32 目录更名为 ReleaseX86）
宏高级设置中，按键类型改为「罗技」或「AHI」时，自动检测对应驱动/软件是否安装，未安装则弹出安装提示
添加每10分钟 work 残留清除机制
变量名支持加减乘除符号
关闭模态子窗口后支持编辑器多开
优化版本号显示，附带软件架构类型
手柄宏配置方式、表现方式优化
优化逻辑树空节点也可以使用快捷键粘贴
完善软件常见问题、常见报错文档内容
文件校验清单补齐
补充搜索、抓图相关日志

修复

修复发送内容缓冲异常、文字识别遇到下划线异常
修复手柄自己触发自己、手柄绑定 / 长按检测异常
修复搜索文本坐标不能用变量、搜索 Pro 截图与坐标校验问题
修复宏执行超过约 10 秒被自动终止
修复多线程下数据不同步、变量操作重复执行
修复界面宏浮窗重复打开、关闭后仍弹出、任务栏唤起异常
修复窗口管理最大化黑屏、窗口信息显示与位置宽高保存问题
修复轮盘划线位置不准、主题未保存、仅一个宏时触发区过小等
修复导入旧配置缺字段、本地配置导入报错、配置合并冲突
修复部分按键失效、快速点击易丢、暂停 / 继续宏异常
修复定时宏无法暂停、后台鼠标点击时间未生效
修复拖拽指令到末尾报错、编辑器焦点残留等交互问题
以及其它若干稳定性与兼容性修复
修复管理员账号运行提示问题
修复运行指令兼容问题
修复开始节点呼出右键菜单问题
修复图形节点粘贴、边界与操作细节相关问题
修复分支内联展开后指令列表重复或不刷新
修复内联展开后后继节点间距不正确
修复收缩父节点 / 分支时内联子节点残留画布
修复纯修饰键（Shift / Alt / Ctrl / Win 及其组合）无法作为触发键的问题（#246）
修复移动 Pro「修改」屏幕规则时误写入搜索 Pro 配置文件，导致 SearchProFile 混入移动 Pro 数据
修复旧配置兼容迁移时定时序列码非法（如 0）写入 TimingFile，以及打开定时编辑时的防护
修复取消「开机自启」后注册表残留、软件仍会开机自启的问题（启动时与注册表对账）
修复宏内配置手柄按键时因 GetKeyState(Joy*) 非法键名抛错导致手柄输出不生效
修复 Xbox 手柄录制时左/右摇杆与 LT/RT 无法录制（误读 ViGEm 占用的 XInput 槽）；同步兼容 PS5 录制映射
修复复制粘贴多个「移动Pro」等指令时互相覆盖的问题
修复「自动松开修饰键」误操作未按下的右 Alt，导致多出幽灵 Ctrl 的问题
修复多个界面窗口同时打开时可能闪退
修复界面宏浮窗关闭后，其它界面窗口打不开的问题
修复界面宏标题栏菜单被挡住的问题
修复已禁用的菜单宏仍弹出轮盘、界面宏被误当成菜单宏的问题
修复开关触发的无限循环宏（无间隔、连续搜索等）难以关闭的问题
修复强制停止后偶发的严重错误导致软件异常
修复设置页输入数字过程中因空内容报错
修复罗技 / AHI 模式下移动速度与界面设置相反的问题
修复罗技 / AHI 相对移动时速度偏高（如 90）表现成瞬移的问题，仅 100 为瞬移
修复 AHI 绝对移动鼠标乱飘（改为真正的绝对坐标移动）
修复发行版罗技模式鼠标移动无效（缺少相关组件）
修复暂停宏在部分情况下不生效的问题
修复多线程数设为 -1 时关闭宏可能卡住按键（未自动松开）的问题；单线程不受影响
修复手柄扳机 LT/RT 按下问题
修复 Excel 多次读取报错问题
修复变量监视器在任务管理器中图标缺失的问题
修复打开变量监视器时崩溃的问题
修复宏操作编辑器缺失部分界面宏选项的问题
修复 RMT 指令「关闭指令显示」「开启指令显示」后设置选框状态不刷新的问题
修复指令显示状态在 worker 与主线程之间不同步的问题
修复移动Pro「移动方式：游戏视角」会进行多余点击的问题
修复同按键多次点击录制的问题
修复宏编辑器多选时循环次数 / A、B、C 等被一并删除的问题
修复宏编辑器右键改变状态异常的问题
修复松止触发宏偶发「invalid memory read/write」崩溃的问题（Worker 强杀/重建时残留引用读取已释放的共享内存）
修复保存时任务栏闪烁报错的问题（保存时彻底释放 Worker 进程与共享内存，避免新旧进程竞争同一命名对象）
修复单线程模式（多线程数设为 0）下数组克隆指令无效的问题
修复保存/重载期间宏编辑器多选高亮、拖拽消息处理器访问已销毁控件报错的问题
修复多线程模式下罗技鼠标移动无效的问题
修复逻辑树编辑器右键复制后粘贴时界面闪烁的问题
修复宏结束自动松开按键问题
修复配置合并多层前台合并指令丢失问题
修复逻辑树真假分支粘贴报错问题
修复视角调整受按键类型影响问题
修复窗口抓图 Y 轴偏移问题（含带标题窗口）
修复如果 Pro 分支指令空编辑后条件丢失问题
修复如果 Pro 条件出现空格被截断问题
修复逻辑树编辑器没有焦点时按快捷键（含 Delete）报错问题
修复没有提权托盘显示管理员权限问题
修复关闭指令显示没有及时关闭问题

删除

等待+完整输出（已由更清晰的运行等待选项替代）

待更新

后续计划（供参考，尚未实装）：
小工具指令（倒计时、后台播放音频等）
工具页扩展：难删文件清理、批量重命名、垃圾清理
语音宏、图像目标检测（仍在规划）

RMTv1.1.2更新

优化

窗口信息编辑变量下拉内容优化
更新日志改成倒序

修复

如果Pro分支添加报错
变量自动去除空格问题
读取Excel空内容报错问题
Excel读取区域异常问题
表达式空值运算问题
如果Pro报错问题
进程名获取报错问题
窗口信息使用句柄变量报错
变量提取后调试报错

RMTv1.1更新内容

新增

软件打开支持-min参数
运算增加取余操作
RMT指令新增窗口相关指令
新增数组指令（支持二维数组）
支持设置调试起点
新增输入指令
输出文本文件可指定文件编码
手柄从vjoy改成ViGEm
增加亮度调整按键
新增SC截图类型
前台|窗口信息增加句柄绑定
搜索pro支持窗口搜索图片、颜色、文本
变量增加句柄ID选项
如果增加正则表达式比较类型
变量提取支持窗口
增加颜色实时变量
新增文件读写指令
新增离线帮助说明文档
如果指令新增流程控制

优化

item采用无尽列表刷新方式，让软件不再卡顿
优化指令编号问题
多语言问题优化
软件部分排版问题优化
系统托盘休眠中文化
优化配置导入速度
调整前台检测逻辑
变量名规范化
调整间隔变量兼容处理时机
取色器优化，解决左下角，右上角，右下角无法取色问题
按键指令_按键名_动作类型改成中文
优化默认变量名Num改成Var
变量、运算、宏操作添加默认备注
搜索pro，变量提取支持坐标
指令简化形如搜索_Search1234_备注 => 搜索1234_备注
优化运算对浮点数的处理
循环次数重复
优化如果编辑器
运算指令优化
RMT指令优化
文本处理指令重构
重构宏操作指令
按键编辑提示优化
跳过指令可以编辑
优化导入功能
变量提取，提取文本编辑增加说明
文本处理处理参数提示文本优化
文本处理新增特定变量制表符
浮动数值保存检测
特别感谢信息调整
开发文档完善，辅助其他的人使用源码
定时宏采用Schedule和小顶堆处理
取消音频文件的绑定，支持替换Start和End音频
优化变量提取指令（空格处理）
更新图标调整指令顺序
变量提取-提取文本编辑优化
输入时交互回车按键默认真值或继续
输入时交互 ESC按键默认假值或取消
按键编辑界面优化
按键替换编辑界面优化
触发按键编辑界面优化
优化主界面刷新逻辑，减少卡顿
主界面下划线位置调整
优化后台按键编辑界面
优化指令窗口-增加颜色状态
变量监视器窗口可动态调整-但是没有记录大小
罗技鼠标没有鼠标按键按AHK模式处理
指令更加防呆设计（空格和Tab判断）
OpenCV模型升级至4.8.1
终止所有用时，关闭菜单按钮
变量监视器大小，置顶状态保存
搜索pro无限次数时，假分支置灰
初始化错误提供更多信息，辅助排查
搜索Pro颜色支持变量
优化变量相关内容
RMT指令优化
输出指令支持数组
多语言完善
编辑界面右侧增加按钮图标
部分指令编辑界面优化
按键逻辑优化（按下时按下增加选项）
流程控制编辑器界面优化显示
录制选项细化-鼠标关键点位选项
截图快捷键->Alt+F1
自由贴快捷键->Alt+F2
托盘显示软件版本以及管理员权限

修复

按键编辑器关闭后F1快捷键没有关闭问题
关闭变量监听窗口，宏指令编辑器勾选状态异常问题
变量提取会去除空格问题
后台鼠标中键和右键错位问题
如果Pro完全复制报错问题
搜索两个真值
按键被屏蔽问题
指令窗口颜色背景颜色设置无效问题
提示音多次触发软件闪退
重命名打开菜单轮失去焦点（第一次打开仍然无效）
循环次数重复
菜单轮线条闪烁问题
英文模式下无法调试问题
说明文档换行问题
删除如果pro分支指令异常
如果等于不能用于字符比较
文本提取空格式无效问题
完全复制引用异常问题处理
指令窗口不跟随问题
指令上下移动，分支不会调整问题
禁用模块定时仍然生效
配置导入无效
运算只对第一个编辑生效问题
输出弹窗无法显示_,{,}符号问题
调试标识影响指令执行问题
输入excel内容自动关闭excel文件问题
excel输入二维数组异常问题
编辑器文本状态无法录制指令问题
快捷键无法改成热字串问题
录制快捷键单个按键时，无法关闭录制状态问题
字串宏清除后保存报错问题
输入交互取消无效问题
开启自启偶尔弹窗问题
后台按键应用保存错误问题
应用保存对象池清除错误
按键替换1~8无效问题
开机自启最小化问题
关闭RMT残留work问题处理
部分取色后提示错误
选择图片时复制问题
F5版本rmt无法导入问题
任务计划程序运行没有托盘图标问题
变量提取问题
第二个指令上移问题
松止时松开其他按键问题
后台按键保存报错问题
数据越界问题
输入保存选框状态问题
运算表达式校验修复
如果Pro，循环指令完全复制问题
输出excel关闭问题
Excel读取保存问题
输入指令变量问题
输出指令保存问题
Excel写入保存提示问题
滑动条问题修复
文件读写下拉框显示问题修复
宏编辑界面关闭后异常刷新问题
非如果pro提示流程控制报错问题

删除

输入指令-文本文件、Excel
输出指令-文本文件、Excel
删除变量存在则忽略（只保留变量指令中该选项）
工具->截图和自由贴展示删除

RMTv1.0.9 更新内容

新增

分割线开关选项
宏编辑器新增编辑模式【逻辑树，文本】
逻辑树真假节点双击可以直接编辑
配置管理新增直接打开操作说明文档
宏新增提示音选项
新增变量监视器
新增循环指令
新增如果Pro指令
逻辑树增加上下移动指令功能
配置迁移
新增共享上传功能
新增逻辑按键类型
变量监视器新增双击修改值操作
增加多语言-中文/英语选项
进程通信增加回包检测机制
新增逻辑树-跳过指令/取消跳过
按键宏触发键按钮右键可自定义触发按键
RMT指令-开启/关闭变量监视
新增使用说明编辑器
编辑器支持多窗口
编辑器增加工具菜单栏
(变量监视器，指令窗口)
编辑器增加调试菜单栏
(运行，单步运行，终止)
搜索pro增加窗口规格选项
移动Pro增加窗口规格选项
编辑器新增delete快捷删除操作
编辑器新增窗口置顶选项

优化

调整主界面宏配置布局
共享配置网址调整
宏操作-插入操作，可以自定义插入次数
编辑窗口标题自适应显示文本
优化修正功能，支持修正兼容适配问题
调整字串宏的选项文本
优化指令状态传递方式
多线程设置优化(0~10且自动生成对应的work)
搜索编辑器打开时检查图片路径，提醒使用配置校准功能修复问题
开关打开菜单宏第一次打开第二次关闭
备注文本优化，防止影响指令
优化循环次数变量下拉出现时机
优化通信，避免重复处理指令
部分指令去除下拉内部变量,减少干扰变量
变量监视器在保存后根据上次状态自动打开
指令监视器双击时显示当前数值
优化罗技按键初始化问题
优化导入配置存在弹窗的字体
优化配置迁移操作
优化共享上传操作流程
指令通讯方式优化
优化搜索Pro选择图片功能,适配导出导入
优化变量指令实现方式
优化循环次数的显示文本
指令手册-增加循环，如果Pro指令说明
优化指令显示窗口
配置序列号增加至七位（6位+随机数）
前台信息编辑器功能简化（去除不必要的快捷键）
编辑器Debug时清空指令窗口
编辑器Debug结束弹窗置顶
编辑器Delete快捷键优化
RMT指令编辑器默认显示10个选项
变量提取指令编辑器优化
变量提取，最多提取变量增加至6个
优化搜索Pro编辑器**

修复

按键1~8触发按键无法屏蔽问题
终止所有宏无法终止子宏问题
加载配置/导入配置不显示窗口问题
宏配置上下移动，宏指令没有移动问题
文本模式下无法添加指令问题
配置太多导入异常问题
语音提示配置报错问题
多线程交互过快，信息丢失问题
如果pro功能没有实装问题
剪切板提取变量多换行符问题
共享上传临时文件删除报错问题
多屏重载后软件窗口位置重置问题
宏操作指令响应延迟问题
循环-如果Pro中创建变量不会出现在下拉框问题
罗技按键终止没有松开按键问题
模块中删除所有宏后，宏Label遗留问题
配置重命名后路径没有修复问题
编辑器指令窗口没有显示指令问题
使用说明添加图片报错问题
菜单按钮快捷键没有屏蔽问题
运行次数保存问题
Debug弹窗问题
间隔变量时间异常问题
多语言同步问题
多宏编辑器窗口报错
按键编辑器，点击模拟按钮报错问题
按键1~8触发按键触发异常问题
跳过指令完全复制报错问题

删除功能

运行后显示窗口
按键指令编辑器去掉按键模式选项
指令窗口删除指令个数配置项

RMTv1.0.8 更新内容

新增：

优化滑动组件
新增配置分组功能
新增分组禁用功能
宏编辑器右键新增完全复制选择
增加背景色选项(不怎么好用，还不如不用)
新增定位取色器，移动或搜索颜色指令点位编辑优化
RMT指令：新增关闭软件类型
定时宏：新增软件启动时触发
特别感谢页签增加
帮助页签增加视频合集链接
宏模块增加前台功能
指令编辑器增加指令的图标
新增菜单宏
新增后台按键指令
菜单宏增加出现位置选项
新增配置导出，导入功能
新增配置共享链接
移动Pro新增鼠标动作类型：移动，点击1次，点击2次
输出指令新增：输出到文本文件，输出到Excel表格

优化：

优化指令录制结果
变量提取：支持提取所有文本信息
变量提取：不存在变量时创建默认值0的变量
如果：判断字符包含时右边可以直接使用字符
输出：新增指令窗口选项
搜索Pro：UI微调整
定时：前台判断增加保护
浮动值：可以通过+-控制浮动方向
优化软件保存后重新打开的位置
按键宏：支持相同触发键配置不同的宏
按键宏长按触发优化
自由贴可以用滚轮缩放
提供多种默认字体，都不存在时选择字库第一个字体
微软截图时增加自动框选范围
RMT截图状态增加提示
创建变量增加规范提醒
录制操作去除触发录制的快捷按键
分支指令默认显示真假分支
真假分支右键增加'添加指令'
宏操作去掉默认备注功能
全局快捷键输出到指令窗口
问题及应对措施添加案例
调整界面窗口大小
打赏功能调整（赞助太少，活不起了）
禁用键鼠，启动键鼠多线程也可以正常使用
按键，触发键编辑器增加勾选背景色
按键指令可以勾选任意选项
后台指令保留窗口信息缓存
提取变量增加{变量名}功能
完善菜单宏的触发方式
路径修正功能进一步完善
菜单宏界面鼠标移动超过160px根据角度触发对应按钮
优化配置导入，导出操作
优化输出指令
菜单宏增加数字按键触发**

修复：

修复移动速度100时编辑指令速度90问题
弹窗指令bug修复
修复应用保存报错
修复新增配置报错
修复移动pro完全复制bug
修复嵌套逻辑完全复制报错
修复快捷键编辑异常问题
修复折叠框初始状态异常问题
修复设置滑动条异常问题
修复删除模块是界面UI位置偏移问题
修复Win按键长按触发异常检测问题
修复多修饰组合键长按触发问题
修复粘贴分支逻辑是显示错误
修复按键_F20_3_100指令双击编辑报错问题
修复未勾选"运行后显示窗口"，应用、重载后界面不显示问题
修复按键替换功能屏蔽问题
修复前台相关问题
修复前台信息报错后，溢出问题
修复菜单轮显示获取焦点，导致指令输出到菜单轮问题
修复菜单轮非100%屏幕缩放显示异常问题
修复配置重命名bug
修复定式宏，停止时间后触发问题
修复按键替换前台问题
修复自增导入配置异常问题
修复备注文本溢出问题
修复导入兼容问题
调整字串宏长度提示

RMT v1.0.7 更新内容

新增

无变量提醒选项
变量提取指令（从之前的变量指令摘出来）
新增全局变量
搜索Pro文本搜索支持文本变量
新增软件截图选项
触发键编辑界面新增键盘监听输入
新增截图功能，新增自由贴功能
新增配置管理功能能
新增字体选项
新增定时宏
新增指令显示开关
新增RMT指令
"截图", "截图提取文本", "自由贴","开启指令显示", "关闭指令显示",
"启用键鼠", "禁用键鼠", "全局暂停", "终止所有宏", "重载"
新增上移下移功能
指令录制新增鼠标轨迹录制
按键指令新增组合键选项和按键监听
全局暂停功能
增加宏状态背景颜色标识
输出指令，增加弹窗，语音
宏操作新增暂停操作类型
宏指令编辑器可以右键复制，粘贴指令
指定进程改名前台：支持配置窗口标题，窗口类，窗口进程名
RMT指令新增暂停所有宏、恢复所有宏类别
增加指令手册说明文档

优化

优化间隔指令，可以使用变量设置时间
优化间隔、移动Pro、运算指令
优化变量、变量提取、运算、如果指令
调整默认快捷键（改成更加生僻，以免不知道情况下误触发）
搜索界面UI简化，搜索Pro界面UI调整
变量提取不存在&x，&c增加提示反馈
变量提取执行测试指令，可提示变量截取结果
搜索指令：搜索次数支持无限搜索
优化宏指令编辑器
优化编辑器变量下拉预选
优化开关触发模式
删除并联模式
指令录制改成串联
指令录制选项优化
删除记录窗口默认位置功能
指令显示有注释时去掉标识符号
子宏，终止宏合并为宏操作指令
定时宏优化触发时间点
搜索颜色：取色时自动框选搜索范围
搜索图片：RMT截图时自动框选搜索范围
路径修正：修正因为导入别人配置路径不对的问题
帮助界面新增表格链接（bug文档，需求文档，使用备注）
界面UI布局调整优化
输出指令增加更多选项
文件指令改名运行执行，并优化相关功能
文本识别参数回调
修改游戏选项->下拉式按键类型：虚拟/拟真
宏指令编辑器
宏指令编辑器新增双击编辑指令操作
搜索Pro界面UI调整
子宏增加默认备
调整默认的指令显示窗口配置
变量提取次数可以无限次
调整键鼠禁用指令提示文本
手柄录制适配新录制指令
快速上手文档内容更新
调整变量提取指令布局
优化vjoy初始化模块**
删除局部变量，只保留（宏循环次数）

修复

修复串联终止后指令无法再次生效问题
滑动滚轮，会莫名其妙导致一些宏变无限次和串联
开宏全局终止宏新增配置点空白的地方报错
编辑器修改参数后，指令缓存导致编辑器模式执行指令异常
变量提取只有第一个宏生效问题
游戏模式下滚轮无效问题
框选范围结果异常问题
幂运算结果异常问题
子宏指令异常问题
指令显示窗口会获取焦点问题
子宏自己插入自己问题
串联多线程指令显示报错问题
终止宏
定时宏多个无法删除问题
快捷键显示问
变量创建提示错误问题
部分指令变量没有出现在变量下拉框
宏指令编辑器修改备注无法保存问题
软件运行时立马触发宏报错问题
快捷键显示问题
编辑器搜索指令修改后报错问题
宏操作指令序号显示异常问题
编辑器处理嵌套指令显示异常问题
多个自由贴无法关闭问题
上下进程名无法上下移动问题
暂停会吧休眠勾选上问题
多线程暂停功能异常
多线程输出语音和弹窗报错
录制轨迹时无法录制"/"按键问题
无限搜索时超过900次的报错问题（真无限）
内置变量没有拉取显示问题
定时宏默认配置点击报错问题
指令编辑器执行报错问题
新增配置是，上下移动异常问题
搜索坐标Y无法下拉选取变量问题
运算指令无法下拉选取变量问题
宏被子宏多次触发问题
宏终止卡键问题
宏操作调用自己问题
无权获取窗口信息时报错问题
xoutput中默认配置空问题
定时宏勾选结束时间异常问题

RMT v1.0.6 更新内容

新增

指令录制新增手柄选项

优化

优化软件目录结构
优化设置显示快捷键文本
软件窗口宽度减少35px
调整【循环次数】UI位置（移动到比较靠前的位置）
调整【长按时间】UI位置（移动到触发键编辑界面）
优化宏信息保存：每个宏单独保存，不再拼接保存
如果手柄宏被其他软件屏蔽，可以运行joy目录下的Xoutput，【RMT虚拟手柄转Xbox手柄】点击开始

修复

修复滚动条无法使用滚轮滚动问题
修复滚动条拖拽界面UI重叠
修复手柄十字键触发相关问题

RMT v1.0.5 更新内容

新增

免责申明：使用软件前需同意协议
"如果"指令支持逻辑关系"或"
内置变量：支持获取 X/Y 坐标与循环次数
托盘图标状态区分（暂停状态下不同图标）
新增串联指令多线程功能
新增简单搜索指令，降低新手编辑门槛
搜索指令新增截图快捷键
增加后台鼠标指令

优化

快捷键修改逻辑
按键反馈机制
界面字体大小调整
文本与变量提取功能格式优化
文本提取快捷键默认设为 Alt+U
分支指令模式按宏指令的模式串联，并联
优化搜索框选功能提示
优化搜索鼠标动作参数设置
优化部分窗口排版
优化图片搜索功能（使用OpenCV接口）
优化文本识别功能（识别模型升级）
优化循序次数组件
优化图片搜索，图片一样只是有色差（黑色蒙版等），相似度99或100可以防止误触发
优化文本搜索的匹配方式，支持正则表达式（\d+ 这样就可以匹配任意整数了
工具可以获取窗口坐标
工具中增加窗口置顶选项，以便实时查看获取相关信息
后台鼠标增加滚轮操作
增加指令缓存，而不是每次都读取配置

修复

取消选择图片时报错
快捷键修改 Bug
滚轮与数字区回车无法录制
组合键触发误触其他快捷键
快捷键 | 修改为 \
中文插入英文符号错误
125% 缩放下文本重叠问题
工具开关状态保存失败问题
子宏设置后删除前序宏引起序号错误
文本提取快捷键无法触发问题
运算功能的表达式中出现括号后，退格报错
修复删除配置报错问题
修复点击指令录制内容重复问题
修复多线程vbs路径适配问题
修复移动指令速度100保存问题
修复搜索界面编辑指令，二次编辑指令为空问题
修复多线程暂停无效问题
修复多线程子宏暂停问题
修复子宏保存序号显示问题
修复暂停时，开关触发宏状态没有重置问题
修复子宏，终止操作宏报错问题
修复多线程子宏问题
子宏调用自己问题

RMT v1.0.2~4 更新内容

新增指令执行模式：

现默认指令为串联模式（上个指令执行完才执行下个）
每次间隔可以设为 0，实现无缝衔接
录制指令仍为并联模式，以支持多键同时按下
⚠ 注意：录制时不适用于串联模式
修复编辑指令时报错的问题
修复指令并联无法保存的问题
新增打赏功能
优化文本识别与配置管理功能

RMT v1.0.0 更新内容

软件更名为 RMT（若梦兔），原名 ButtonAssist 不易记忆

功能更新

新增宏触发类型：按下、松开、松止、开关、长按
按键指令优化：支持点击、按下、松开
移动指令简化
新增移动 Pro 指令：支持更多参数与变量控制
设置中新增坐标浮动功能：鼠标移动可随机浮动
指令编辑器优化：支持右键编辑与快捷键录制
文件功能：支持 MP3 后台播放
搜索指令改为类存储结构（与旧版不兼容）

新增指令

输出指令：便于文本输入
终止指令：中途退出宏执行
子宏功能：子宏不依赖触发按键，可多次循环

进阶变量指令

支持变量存储运行时状态
优化变量提取：可处理千位分隔数字（如 1,000,003）
新增变量运算指令：变量可通过运算改变值
新增"如果"指令：支持分支处理逻辑

后续优化方向

搜索简化版指令：当前参数过多，学习成本高
宏分享功能：便于排查配置问题、快速复用
触发指令类型细分：引入单线程与多线程选项，降低使用门槛

ButtsonAssistv6.0.0 更新内容

搜索功能新增文本搜索类型
搜索范围功能优化：按下 F1 后可以框选范围
宏录制功能优化：可在设置中配置录制参数
工具新增 OCR 图片识别提取文本功能
简化指令语法：减少无意义参数
新增比较指令：可提取变量进行运算与比较
新增坐标指令：提取文本中的坐标并用于移动
搜索图片支持软件内截图
修复若干已知 Bug

🐰 RMT 文档

🌐 全局操作

🗂️ 页签说明

📦 宏模块

🎯 宏配置

📂 配置管理

🛠️ 软件工具

⚙️ 软件设置

1️⃣. 按键触发连点器

2️⃣. 组合键触发宏

3️⃣. 按键触发组合键

4️⃣. 指令录制（宏录制器）

5️⃣. 字串宏

6️⃣. 定时宏（指定时间触发）

7️⃣. 搜索图片（图像识别）

8️⃣. 搜索颜色

9️⃣. 搜索文本（OCR 识别）

🔟. 鼠标移动

1 间隔

功能说明

类型说明

参数解析

2 按键

功能说明

特别说明

手柄按键说明

键盘按键检测

参数解析

指令格式

3 搜索

功能说明

特别说明

快捷键

定位取色器

搜索类型

搜索范围

搜索目标

鼠标动作

分支指令

4 搜索Pro

功能说明

特别说明

定位取色器

窗口信息

基本参数

鼠标动作

图片识别模型

文本识别模型

搜索文本

分支指令

结果保存

目标点保存

5 移动

功能说明

快捷键

基本参数

相对位移

指令格式

6 移动Pro

功能说明

快捷键

基本参数

相对位移

游戏视角

7 输入

功能说明

类型

交互时

取消时

特别说明

8 输出

功能说明

输出类型

输出内容特别说明

9 循环

功能说明

基本参数

循环条件

10 宏操作

功能说明