兼容大多数鼠标和键盘，适用于大部分游戏和应用。
2026-06-08 更新使用文档，问题反馈请在 「留言」板块

⚠️ 免责申明
本软件为第三方辅助工具，仅供个人学习与交流使用。
使用本软件可能违反《王权与自由》ThroneandLiberty 游戏的相关用户协议-
因使用本软件导致的任何账号封禁、数据丢失或其他损失，作者概不负责
请用户自行评估使用风险，谨慎使用
若游戏官方明确禁止此类工具，请立即停止使用

使用者即视为已阅读并同意本免责申明

📖 一、项目简介

项目说明
软件名称TL_Macro
使用平台Windows 10/11（x64）
主要技术PyQt5 + Pynput + 硬件级输入
成品下载我同意免责申明并下载程序 下载最新版本使用
项目源码https://github.com/x0620x/tl_macro_tool

🧩 二、功能速览

模块功能备注
🎯 多键宏录制一串按键+精确时序支持3种触发模式
🔥 单键宏对单个键高速连点可设频率/按住连发
🖱️ 鼠标支持中键、右键、侧键1/2左键被禁用，防止误触
🎯 窗口焦点控制智能识别目标窗口，防止误操作支持进程名和窗口标题过滤
⌨️ 全局热键后台监听，无需焦点可识别组合冲突
📁 配置管理多配置、实时保存、历史记忆json文件，手动可编辑
🔔 系统托盘最小化常驻，双击唤出退出前自动保存
🛡️ 安全防护热键冲突检测、管理员权限防止误操作

🧪 三、技术栈

  • PyQt5 - QMainWindow、QTabWidget、QTableWidget、QSystemTrayIcon，用于构建主界面、标签页、表格、托盘菜单。
  • pynput - pynput.keyboard.Listener、pynput.mouse.Listener，用于录制键盘/鼠标按键，阻断式获取单键。
  • keyboard - keyboard.is_pressed、keyboard.read_event，用于后台循环检测热键状态，实现全局无焦点触发。
  • ctypes.SendInput - windll.user32.SendInput，调用 Win32 API 注入硬件级输入，绕过消息队列。
  • threading - Thread、Event，实现热键监听与宏执行异步化，保证UI不卡顿。
  • json + os - 用于配置读写、历史记录、多文件管理。

🛠️ 四、快速开始

✅源码运行

  • Python版本: 3.11

    $ pip install PyQt5 pynput keyboard
$ python app.py
    💡 提示: 程序启动时会自动请求管理员权限，请点击"是"确认，否则部分功能可能无法正常工作。

✅直接运行（推荐）

  • 操作系统: Windows 10/11 (64位)
  1. 解压或复制整个 TL_Macro 文件夹到任意目录，双击 TL_Macro.exe 启动。若弹出 UAC 管理员权限提示，请点击「是」。
  2. 文件夹内应包含：
   - TL_Macro.exe — 主程序
   - _internal/   — 程序依赖目录（不可删除）
   - config/      — 配置文件目录（首次运行后自动生成或使用已有配置）
   - log/         — 日志目录（运行后自动生成）

关闭主窗口时，程序不会退出，而是最小化到系统托盘继续运行：

操作方式
恢复窗口双击托盘图标，或右键 →「显示窗口」
彻底退出右键托盘图标 →「退出程序」

关闭窗口后，已启用的配置热键仍然有效，适合边玩游戏边在后台使用宏。

🖥️ 五、界面总览

  • 左侧：配置文件列表，分为「已启用」和「未启用」两个区域。

  • 右侧标签页：

    • 主页 — 仪表盘，显示已启用配置摘要、运行状态和窗口焦点信息
    • 多键宏 — 配置按键序列宏
    • 单键宏 — 配置单键连发
    • 图像宏 — 配置图像识别技能
    • 焦点控制 — 设置宏生效的窗口范围
    • 关于 — 版本信息、反馈链接、日志级别设置

主页
主页
多键宏
多键宏
单键宏
单键宏
图像宏
图像宏
图像宏设置
图像宏设置
焦点控制
焦点控制
关于
关于

⚙️ 六、配置文件管理

每个配置文件对应一套独立的宏设置（多键宏 + 单键宏 + 图像宏）。可以同时启用多个配置，但热键不能冲突。

操作方式说明
新建配置点击「新增」，输入名称新建后默认处于未启用状态
选中配置单击配置名右侧显示该配置的设置，可进行编辑
取消选中再次单击已选中的配置名清空右侧编辑区
启用 / 禁用双击配置名启用后右侧编辑区锁定，需先禁用才能修改
重命名选中未启用配置 →「重命名」启用中的配置不可重命名
删除选中未启用配置 →「删除配置」启用中的配置不可删除，需先禁用

启用与编辑的关系

  • 配置未启用时：可以自由编辑多键宏、单键宏、图像宏的所有设置。
  • 配置已启用时：右侧各标签页的按钮和输入框会被锁定，防止运行中误改。
  • 需要修改已启用配置：双击禁用 → 修改 → 双击重新启用。

配置文件存储位置

路径内容
config/<配置名>.json宏配置数据
config/enabled_configs.json当前已启用的配置列表
config/window_focus.json窗口焦点设置（全局，不随配置变化）
config/assets/<配置名>/图像宏的技能图标、Buff 图标等截图资源

备份或迁移时，可复制整个 config 文件夹。

热键冲突规则

启用配置时，程序会自动检测已启用配置之间的热键冲突。若存在冲突，将无法启用并弹出提示。

冲突规则如下;

-  多键宏启动热键不能重复
-  单键宏启动热键不能重复
-  图像宏启动热键不能重复
-  各类型启动热键之间不能相同（例如多键宏热键和单键宏热键不能是同一个键）
-  宏序列中的按键不能包含其他已启用配置的启动热键
同一配置内部也会检测热键冲突（例如多键宏热键不能与单键宏热键相同）。

🎮 七、多键宏

多键宏用于按顺序执行一系列按键，适合「一键连招」「循环释放技能栏」等场景。

配置步骤

  1. 点击左侧「新增」，创建一个配置并单击选中。
  2. 切换到「多键宏」标签页。
  3. 点击「设置热键」，按下你想用作启动键的按键（支持键盘键和鼠标键）。

  4. 添加宏序列（二选一或组合使用）：

    • 录制序列：自动录制你按下的每个键及其按下时间、间隔。
    • 添加：手动逐行添加，设置「按键 / 按下时间(ms) / 间隔(ms)」。
  5. 用「上移」「下移」调整执行顺序，「删除」移除不需要的步骤。
  6. 选择执行模式。
  7. 双击左侧配置名启用。
  8. 进入游戏，按下启动热键测试。

宏序列表格说明

列含义
按键要模拟按下的键，支持组合键（如 ctrl&a）
按下时间(ms)按键保持按下的时长
间隔(ms)该步骤完成后到下一步骤之间的等待时间

执行模式

模式行为
模式1按下启动宏热键 → 循环执行，直到再次按下结束
模式2按下启动宏热键 → 执行一次就结束（默认）
模式3按下启动宏热键 → 循环执行，松开停止

示例：一键循环释放 3→4→5 技能

  1. 新建配置，命名为「技能循环」。
  2. 多键宏热键设为 1。
  3. 添加三行宏序列：
按键按下时间(ms)间隔(ms)
311723
47014
52181
  1. 执行模式选「模式1」（循环执行，再次按下停止）。
  2. 双击启用配置。游戏中按 1 开始循环，再按 1 停止。

组合键说明

  • 组合键格式：修饰键&主键，例如 ctrl&a、shift&1。
  • 组合键中的单个键不能与当前配置的启动热键冲突。

🔁 八、单键宏

单键宏用于对一个键盘按键进行高速连发，适合需要快速重复按某个键的场景。

配置步骤

  1. 新建并选中一个未启用的配置。
  2. 切换到「单键宏」标签页。
  3. 点击「设置热键」，按下启动键（仅支持键盘按键）。
  4. 设置「按下时间(ms)」— 每次按键保持按下的时长。
  5. 设置「间隔时间(ms)」— 两次按键之间的等待时间。
  6. 选择执行模式。
  7. 双击启用配置，进入游戏测试。

执行模式

模式行为
模式1按下启动热键一直循环执行，直到再次按下就停止（默认）
模式2按下启动热键一直循环执行，松开停止

与多键宏的区别

对比项单键宏多键宏
按键数量只连发一个键按序列执行多个键
热键类型仅键盘键盘 + 鼠标
典型用途快速连点一个键连招、多技能循环
如果需要鼠标按键连发，请在多键宏的宏序列中添加对应的鼠标按键。

🖼️ 九、图像宏

图像宏通过识别屏幕上的技能图标，自动按下对应按键释放技能。支持 Buff 前置条件，适合「技能好了自动放」「Buff 消失自动补」等场景。

限制：全局同时只允许 1 个配置 的图像宏在运行。若已有图像宏在扫描，其他配置的图像宏将无法启动。
识别重点：为了识别效率和性能，程序不会全屏幕抓取图像，当你截图技能的时候，会自动保存该技能在屏幕上坐标信息，请固定你的游戏分辨率以及屏幕大小，如果你的游戏技能位置变了，或是屏幕大小分辨率变化，请重新截图。buff栏设计，buff不是固定的顺序出现，位置也不固定，所以先选择buff识别的区域，再选择具体的buff图标。程序就会在这个区域内去识别对应的buff图标。

配置步骤

  1. 新建并选中一个未启用的配置。
  2. 切换到「图像宏」标签页。
  3. 点击「设置热键」，设置启动扫描的热键。
  4. 选择执行模式和扫描间隔。
  5. 点击「新增技能」，在弹出的「技能设置」对话框中配置每个技能。
  6. 在技能列表中用「上移」「下移」调整扫描优先级（排在前面的优先检测）。
  7. 双击启用配置。
  8. 进入游戏，按下热键启动扫描。

执行模式

模式行为
模式1按下启动热键开始扫描，再次按下停止（默认）
模式3按住启动热键开始扫描，松开停止

扫描间隔

  • 范围：30 ~ 500 ms，默认 100 ms。
  • 间隔越小扫描越频繁，响应更快，但 CPU 占用更高。
  • 建议从 100 ms 开始，根据实际情况调整。

技能设置对话框

点击「新增技能」或「编辑」打开，包含两个标签页。

技能设置（必填）

字段说明
技能名称最多 6 个字符，便于识别
技能按键识别到技能图标后要按的键
技能图标点击「框选截图」，在游戏界面框选该技能的图标区域
按下时间(ms)模拟按键的按下时长，默认 50 ms
重复次数识别到后连续按几次，默认 1
重复间隔(ms)多次按键之间的间隔，默认 100 ms
置信度阈值图像匹配的相似度要求，默认 0.85，识别不准时可适当降低
位置容差(px)允许图标位置偏移的像素范围
搜索扩展(px)在上次匹配位置周围扩展搜索的范围
亮度阈值过滤过暗区域的亮度下限

配置完成后，点击「测试识别」验证当前屏幕能否正确匹配该技能图标。

前置条件（可选）

勾选「启用 buff 前置条件」后，可以设置 Buff 相关的触发逻辑：

字段说明
触发模式「Buff 存在时触发」或「Buff 不存在时触发」
Buff 名称最多 6 个字符
Buff 搜索区域框选 Buff 图标所在的屏幕区域
Buff 图标截取 Buff 图标作为匹配模板
等待时间Buff 出现/消失后的等待毫秒数
Buff 置信度Buff 图标的匹配置信度

典型用法：

  • Buff 存在时触发：身上有某 Buff 时才自动释放对应技能。
  • Buff 不存在时触发：某 Buff 消失后自动补 Buff 技能。

使用技巧

  1. 先测后玩：每个技能配置好后，用「测试识别」确认截图能匹配，再启用配置。
  2. 图标尽量小且独特：框选技能图标时，只框选图标本身，避免包含背景干扰。
  3. 合理排序：把优先级高的技能放在列表前面，程序按顺序扫描。
  4. 识别不准时：适当降低置信度阈值，或重新框选更清晰的图标；检查游戏分辨率/ UI 缩放是否变化。
  5. Buff 前置：Buff 搜索区域应框选 Buff 栏的固定位置，Buff 图标只框选图标本身。

🎯 十、焦点控制

焦点控制决定宏在哪些窗口中生效。此设置为全局配置，保存在 config/window_focus.json，不随单个宏配置文件变化。

切换到「焦点控制」标签页进行设置。

全局模式（默认）

选择「全局模式：在所有应用程序中生效」后，无论当前焦点在哪个窗口，已启用的宏都会响应热键。

窗口模式

选择「窗口模式：只在指定应用程序中生效」后，只有当活动窗口匹配以下任一条件时，宏才会执行：

  • 进程名在「目标进程名称」列表中
  • 窗口标题在「目标窗口标题」列表中
重要：窗口模式下，如果未添加任何目标进程或窗口标题，宏将不会执行。

如何添加目标窗口

  1. 切换到你想让宏生效的游戏窗口。
  2. 回到 TL_Macro，在「焦点控制」页点击「刷新信息」，查看当前活动窗口的进程名和标题。

  3. 点击「添加窗口」，从历史记录中选择并添加：

    • 「添加窗口」— 按进程名匹配
    • 「添加标题」— 按窗口标题匹配
  4. 不需要的目标可以用「删除选中的进程」或「删除选中的标题」移除。

主页查看焦点状态

主页底部的「窗口焦点」区域会显示当前模式（全局 / 窗口）以及已配置的目标进程和窗口标题。

❓ 十一、常见问题（FAQ）

启用配置时提示「配置冲突」?


多个已启用配置之间存在热键重复。请检查不同配置的启动热键是否相同，或某配置的宏序列按键是否包含了另一个配置的启动热键。

启用配置后无法编辑设置?


这是正常设计。已启用的配置处于运行状态，编辑区会被锁定。请先双击禁用配置，修改完成后再双击启用。

宏设置了但不执行?


按以下顺序排查：

  1. 配置是否已双击启用（出现在左侧「已启用」列表中）？
  2. 「焦点控制」是否为窗口模式？若是，是否已添加正确的目标进程或窗口标题？
  3. 启动热键是否与其他已启用配置冲突？
  4. 程序是否以管理员权限运行？

单键宏无法设置鼠标按键?


因为在Windows系统内,鼠标是事件,单键宏仅支持键盘按键作为热键。如需鼠标连发，请在多键宏的宏序列中添加鼠标按键。

图像宏识别不准确?

  1. 在技能设置中点击「测试识别」，查看当前屏幕是否能匹配。
  2. 适当降低「置信度阈值」（如从 0.85 降到 0.75）。
  3. 重新「框选截图」，确保图标清晰、范围准确。
  4. 检查游戏分辨率或 UI 缩放是否发生变化。
  5. 调整「搜索扩展」和「位置容差」参数。

关闭窗口后程序还在运行?


这是正常行为。TL_Macro 关闭窗口后会最小化到系统托盘，热键仍然有效。若要彻底退出，请右键托盘图标 →「退出程序」。

图像宏提示已有其他配置在运行?


为了执行效率，全局同时只允许 1 个配置的图像宏执行。请先停止当前正在运行的图像宏，或禁用正在运行的那个配置。

如何查看日志?

  • 日志文件位于程序目录下的 log/ 文件夹。
  • 在「关于」标签页可以切换日志级别（DEBUG / INFO / WARNING / ERROR），便于排查问题。

📜 十二、版本记录

版本日期更新内容重要提示
1.6.32026-08-04修复图像宏bug队列执行bug新增一个间隔时间
1.6.22026-07-10修复图像宏一个bug无
1.6.12026-06-08新增DXGI识别引擎，UI界面修改全局配置修改，请先禁用所有配置
1.6.02026-06-08去掉弹起时间设置、新增录制序列、新增图像宏、修复已知问题新增图像宏功能、项目依赖添加识别模型、相关图像识别运行库所以本次版本体积较大
1.5.02025-11-16支持组合按键、多配置同时启用、重新设计线程池只面向Win10_Win11用户
1.4.22025-10-29应用户需求，宏序列支持鼠标和alt组合按键多键宏序列支持鼠标和组合按键
1.4.12025-10-27修改最小5ms限制时间范围可以修改1-9999ms
1.42025-10-19新增窗口焦点控制功能，支持进程和窗口标题过滤大幅提升使用安全性
1.32025-10-16配置结构优化，多键宏和单键宏统一存储解决职业切换配置问题
1.22025-10-09GUI用QT5重构，输入方式改为SendInput提升输入兼容性和稳定性
1.12025-08-10首版发布，基于TKinter构建基础功能实现

🚀 十三、开始使用

立即下载，开启你的自动化冒险之旅！

  • 🛡️ 合理使用宏工具，享受游戏乐趣
  • 📚 遵守游戏规则，避免账号风险
  • 🔧 遇到问题先查看本手册故障排除章节
  • 💝 开源项目，欢迎Star和贡献代码
最后修改：2026 年 08 月 13 日
© 允许规范转载
钥匙你想请我喝酱香拿铁的话！