DiademMacro：图像识别自动化宏工具

项目简介

Diadem Macro 是一款基于图像识别的桌面自动化宏工具：在目标程序的画面中查找事先登记的图片，找到后执行鼠标点击或键盘输入，并按设定循环运行。使用 Avalonia 与 .NET 10 开发，界面提供韩语和英语，常用于 Nox、LDPlayer（momo）、Peak、BlueStacks 等模拟器中的重复操作。

支持平台：

• Windows 10 版本 2004 及以上（x64）
• macOS 14 及以上（Apple Silicon 与 Intel）

主要功能

• 捕获运行中进程的画面并进行图像查找
• 四种事件类型：
  • Image：找到图片后点击匹配区域内的位置
  • Mouse：直接在目标窗口记录左键、右键或拖拽坐标
  • Keyboard：向目标窗口发送按键或组合键，如 CTRL+A
  • RelativeToImage：以匹配图片中心为基准，加上 X、Y 偏移后点击
• 物理点击（Physical Click）：移动真实光标到屏幕坐标点击后归位，适合 Unity 程序
• 关注区域（ROI）、单项相似度、重复次数、后置延迟、跳转到指定事件
• 父子事件嵌套：父事件匹配成功后才检查子事件，形成 AND 条件
• 批量模式与遍历模式两种执行方式
• 多进程搜索或锁定单一进程；触发项支持复制、移动、拖拽排序与运行状态显示
• 运行画面中显示匹配结果预览
• 设置中可打开日志文件夹、检查 GitHub 正式版本更新
• MCP：3.3.1 起可在设置中开启本地 MCP 服务器，让同一台电脑上的 AI 应用通过 Streamable HTTP 读取与创建事件

安装与使用

Windows

从 GitHub Releases 下载单个 EXE，放到有写入权限的文件夹后直接运行。不需要安装程序，也不需要单独安装 .NET。

macOS

下载对应架构的 ZIP，解压后把 Diadem Macro.app 移到应用程序文件夹再打开，无需单独安装 .NET。

首次使用时进入设置中的 macOS 权限页，分别授予输入控制和屏幕捕获权限，可能需要在授权后重启应用。

快速开始

1. 运行要自动化的程序和 Macro.exe
2. 在已连接进程中选择目标程序，列表中没有就点刷新
3. 只想对一个进程生效时选择固定
4. 点添加，在目标窗口中截取要查找的图片
5. 在选项中设置事件类型和执行条件（Unity 程序请在触发项的选项中开启物理点击）
6. 保存并确认勾选要运行的触发项，点开始
7. 结束点停止，正在进行的捕获、查找与输入会被取消后再退出

触发项与截图默认保存在 Save/save.dll 与 Save/img。

用 AI 配置事件（MCP）

1. 打开设置中的 MCP 服务器页
2. 填写端口并点 MCP 打开，默认端口为 8192
3. 在同一台电脑的 MCP 客户端中选择 Streamable HTTP，注册界面显示的连接地址，默认是 http://127.0.0.1:8192/mcp
4. 关闭设置窗口后向 AI 提出事件配置需求
5. 结束时回到设置点 MCP 关闭

端口可在服务关闭状态下改为 1024~65535 之间的整数，修改后 AI 客户端中的连接地址也要同步修改。不提供 stdio 方式。需要认证时，在启动前设置 DIADEM_MCP_TOKEN 环境变量，并在 AI 客户端的 Bearer 令牌中填入相同值。MCP 只负责事件与图片的查看和编辑，没有点击、键盘输入和启动宏的工具，实际运行仍需在应用中点开始。

注意事项

• 物理点击要求目标窗口未最小化且未被其他窗口遮挡；若目标程序以管理员权限运行，Macro 也需使用相同权限级别；执行时不要手动移动或点击鼠标；不能与同一图片拖拽同时使用。
• 未最小化的窗口优先使用 Windows Graphics Capture，可捕获 Unity 的 GPU 渲染画面；最小化的 GPU 渲染窗口可能返回空白画面。
• 图片查找失败时，先检查屏幕缩放比例是否与截图时一致，适当降低相似度，确认 ROI 覆盖实际位置，并重新截取只包含目标元素的图片。
• 保存文件名为了兼容性仍叫 save.dll，内容是 JSON；截图存在同一路径的 img 文件夹。迁移时把两者一起复制并在设置中选择保存路径。
• 日志在产生第一条日志事件后生成于 logs/LogFile.txt，可通过设置中的打开日志文件夹快速定位。
• Mac 版本使用 ad-hoc 签名，未经 Apple 公证，不提供自动更新；作者说明尚未对实际运行、权限授予与捕获输入进行验证。
• 项目采用 MIT 许可证。

---

本作品整理自 GitHub 开源项目 EomTaeWook/DiademMacro，原作者 @EomTaeWook，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。