按键宏_TL_Macro

博主：爆胎
发布时间：2025 年 10 月 09 日
860 次浏览
18 条评论
7411字数
分类：分享

> 开源、免费、无广告，兼容大多数鼠标和键盘，大部分游戏和应用一样适用。

## 📖 一、项目简介

---

## 🧩 二、功能速览

---

## 🧪 三、技术栈一览

**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** - 配置读写、历史记录、多文件管理

---

## 🛠️ 四、快速开始
### 安装与运行

**✅系统要求**

- 操作系统: Windows 10/11 (64位)
- Python版本: 3.7+ (如运行源码)
- 权限要求: 管理员权限(自动获取)

---

**✅运行方式**

- 方式一：直接运行exe版本(推荐)、双击`TL_Macro.exe`
- 方式二：运行Python源码

```bash
  $ pip install PyQt5 pynput keyboard
  $ python app.py
```

> 💡 提示: 程序启动时会自动请求管理员权限，请点击"是"确认，否则部分功能可能无法正常工作。

---

### 基础使用教程

#### 1️⃣ 创建配置文件

- 点击左侧"新建"按钮
- 输入配置名称（最多10个字符），如"弓法配置"
- 点击确定创建，配置会自动保存

---

#### 2️⃣ 录制多键宏序列

- 切换到"多键宏"标签页
- 点击"添加"按钮开始录制或使用组合按键添加
- 设置时间参数：
  - 按下时间: 15ms (推荐)
  - 弹起时间: 15ms (推荐)
  - 间隔时间: 15ms (推荐)

> - 时间范围: 1 - 9999ms （毫秒）
> - 推荐值: 10-50ms
> ❓为什么是 1ms 下限？系统限制：Windows 的计时器精度默认是 15.6ms，即使用高精度计时器，5ms 以下 的延迟也可能被系统忽略或合并。 游戏/软件识别不了：很多游戏或程序检测不到低于 5ms 的按键事件，会被认为是无效输入或异常行为。 防止崩溃或卡顿：如果宏执行得太快，游戏引擎可能来不及响应，导致掉线、卡死、闪退。 
> ❓为什么是 9999ms 上限？防止误操作：超过 10 秒的间隔，可能以为宏没工作，误触多次，导致混乱。 实用性限制：大多数宏场景（连招、刷任务、挂机）不需要超过 10 秒的间隔，9999ms（约 10 秒）已经覆盖 99% 的使用场景。 安全机制：防止用户设置极端长时间隔（比如 5 分钟），误以为宏坏了，反复启动，造成资源浪费或逻辑冲突。5ms 是系统能稳定识别的极限，9999ms 是用户还能理解的“最大等待时间”。

---

#### 3️⃣ 设置启动热键

- 点击"设置热键"按钮
- 按下想要的触发按键：
  - ✅ 支持: 所有键盘按键，鼠标按键
  - ❌ 不支持: 组合按键

---

#### 4️⃣ 配置单键宏

- 切换到"单键宏"标签页
- 设置单键宏热键（仅支持单个键盘按键）
- 调整时间参数：
  - 按下时间: 20ms
  - 弹起时间: 20ms
  - 间隔时间: 30ms
- 选择执行模式
> 🎯 单键宏应用场景:
> - 弓法职业: 5秒自动按一次治愈之手
> - 弩匕职业: 自动按回蓝技能
> - 所有职业: 定时挂Buff技能

---

#### 5️⃣ 窗口焦点控制(v1.4新增)

- 切换到"焦点控制"标签页
- 选择"窗口模式"
- 点击"添加进程"从历史记录选择（如果无您要选择的记录，请切换到这个窗口一次）
- 或手动添加：
  - 进程名称: 精确匹配，如 TL.exe
  - 窗口标题: 包含匹配，如 王权与自由
> 🛡️ 焦点控制优势:
>    - 防止在聊天窗口误触发宏
>    - 只在游戏窗口中生效，焦点离开指定窗口宏立即停止
>    - 自动识别当前活动窗口

---

## 🚦 五、触发模式详解

### 多键宏模式

---

### 单键宏模式

---

## ⚡ 六、高级使用技巧

### 热键选择策略

🎮 游戏场景推荐:
 - 多键宏: 鼠标侧键、F1-F4功能键
 - 单键宏: 数字键1-4、字母键QERT
 - 避免: 常用技能键、移动键

---

💼 办公场景推荐:
- 多键宏: F9-F12、Insert、Delete
- 单键宏: 小键盘数字键
- 避免: Ctrl、Alt、Win系统键

---

### 时间参数优化

⚡ 高速连招 (PVP场景):
- 按下时间: 15-20ms
- 弹起时间: 15-20ms
- 间隔时间: 30-40ms

---

🛡️ 稳定输出(PVE场景):
- 按下时间: 20-30ms
- 弹起时间: 20-30ms
- 间隔时间: 50-80ms

---

🎯 精确控制 (特殊技能):
- 按下时间: 50-100ms (长按技能)
- 弹起时间: 20-30ms
- 间隔时间: 100-200ms (冷却等待)

---

### 窗口焦点高级配置

🔧 精确匹配:
- 进程名: `tl.exe` (精确文件名)
- 窗口标题: `王权与自由` (包含关键词)

---

🎯 多条件配置:
1. 添加多个进程名应对不同版本
2. 使用窗口标题关键词覆盖更多情况
3. 进程名和标题条件为"或"关系

---

📝 实际示例:
- 进程名: `tl.exe`, `tl_launcher.exe`
- 窗口标题: `Throne and Liberty`, `王权与自由`

---

### 配置管理技巧

💾 备份策略:
1. 定期导出重要配置
2. 使用描述性配置名称
3. 为不同职业创建独立配置

---

🔄 快速切换:
1. 为常用配置设置简短名称
2. 利用历史记录快速加载
3. 配置间热键避免冲突

---

## ⚠️ 七、注意事项

### 权限与安全

- 管理员权限必须 - 部分游戏屏蔽非管理员输入
- 杀毒软件误报 - 如遇拦截请添加白名单
- 游戏合规性 - 了解游戏规则，避免违规使用

### 性能优化

- 适当时间间隔 - 避免设置过短间隔增加CPU负载
- 按需启用功能 - 不需要时关闭窗口焦点监控
- 及时停止宏 - 切换窗口前停止正在运行的宏

---

## 🔧 八、故障排除

#### ❌ 热键无法触发

**症状**: 按下热键无反应，程序无提示；
🔍 排查步骤:
1. 检查是否以管理员权限运行
2. 确认热键没有与其他软件冲突
3. 验证窗口焦点设置是否正确
4. 查看系统托盘程序是否正常运行

---

#### ❌ 宏执行不稳定

**症状**: 宏时灵时不灵，按键遗漏；
🔍 解决方案:
1. 增加时间参数，特别是间隔时间
2. 检查目标窗口是否保持焦点
3. 降低执行频率避免系统资源占用
4. 关闭其他可能干扰的软件

---

#### ❌ 窗口焦点识别错误

**症状**: 宏在错误窗口中触发或不触发；
🔍排查方法
1. 使用"刷新信息"按钮确认当前窗口
2. 检查进程名称拼写是否正确
3. 尝试使用窗口标题关键词匹配
4. 确认窗口模式已启用(非全局模式)

---

#### ❌ 程序无法启动

**症状**: 双击exe无反应或闪退；
🔍 解决方案
1. 确认系统为Windows 10/11 64位
2. 安装VC++运行库
3. 右键"以管理员身份运行"
4. 查看log文件夹内日志获取错误信息

---

### 高级调试技巧
程序运行日志会在日志文件输出，包含：
   - ✅ 热键监听状态
   - ✅ 宏执行信息
   - ✅ 窗口焦点变化
   - ❌ 错误信息详情
---

## 🎯 九、使用场景示例

### 游戏场景配置

#### 🏹 弓法职业配置

**多键宏** (鼠标侧键1):
1 → 2 → 3 → 4 (技能连招)
时间: 20ms按下, 20ms弹起, 50ms间隔

**单键宏** (F1键):
治愈之手 (每5秒自动释放)
时间: 30ms按下, 30ms弹起, 5000ms间隔

---

#### ⚔️ 弩匕职业配置

**多键宏** (鼠标侧键2):
Q → W → E → R (爆发连招)
时间: 15ms按下, 15ms弹起, 40ms间隔

**单键宏** (F2键):
回蓝技能 (低蓝量时自动使用)
时间: 25ms按下, 25ms弹起, 3000ms间隔

---

## 🤝 十一、致谢与开源

献给 所有《王权与自由》的冒险者。
- 开源协议: MIT – 可商用、可修改、请保留原作者信息
- 问题反馈: GitHub Issue 区或反馈链接

💬 **交流渠道**:

- GitHub Issues: 技术问题反馈
- 项目Wiki: 使用教程和开发文档
- 社区讨论: 使用心得分享

---

## 📜 十二、版本记录

| 版本  | 日期       | 更新内容                                     | 重要提示                     |
| :---- | :--------- | :------------------------------------------- | :--------------------------- |
| 1.5.0 | 2025-11-16 | 支持组合按键、多配置同时启用、重新设计线程池 | 只面向Win10_Win11用户        |
| 1.4.2 | 2025-10-29 | 应用户需求，宏序列支持鼠标和alt组合按键      | 多键宏序列支持鼠标和组合按键 |
| 1.4.1 | 2025-10-27 | 修改最小5ms限制                              | 时间范围可以修改1-9999ms     |
| 1.4   | 2025-10-19 | 新增窗口焦点控制功能，支持进程和窗口标题过滤 | 大幅提升使用安全性           |
| 1.3   | 2025-10-16 | 配置结构优化，多键宏和单键宏统一存储         | 解决职业切换配置问题         |
| 1.2   | 2025-10-09 | GUI用QT5重构，输入方式改为SendInput          | 提升输入兼容性和稳定性       |
| 1.1   | 2025-08-10 | 首版发布，基于TKinter构建                    | 基础功能实现                 |

---

## ⌛️ 十三、后续开发计划

| 功能       | 状态     | 说明                      | 预计版本 |
| :--------- | :------- | :------------------------ | :------- |
| 多个单键宏 | ✅ 已完成 | 支持同时执行多个单键宏    | v1.5     |
| 持续录制   | ❌ 不做了 | 一键录制完整宏序列        | v1.5     |
| 硬件级输入 | 🔍 研究中 | 调用罗技DLL实现真硬件输入 | v2.0     |
| 条件触发   | 💡 构思中 | 基于游戏状态的智能触发    | v2.0     |
| 云端同步   | 💡 构思中 | 配置文件的云端备份同步    | v2.1     |

---

## 🎮 开始使用

立即下载，开启你的自动化冒险之旅！
**温馨提示:**

- 🛡️ 合理使用宏工具，享受游戏乐趣
- 📚 遵守游戏规则，避免账号风险
- 🔧 遇到问题先查看本手册故障排除章节
- 💝 开源项目，欢迎Star和贡献代码

如果这个项目对你有帮助，请给个⭐Star支持一下！

[1]: https://p.tiax.cn/Macro
  [2]: https://p.tiax.cn/T/Macro

最后修改：2025 年 11 月 19 日

钥匙你想请我喝酱香拿铁的话！

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

18 条评论

阿良 1
1 星期前

作者加油空了研究一下罗技换了鼠标难受死了

回复
1. 爆胎
  1 星期前
  
  @阿良
  
  已经找到问题了，罗技的 Logitech G HUB 最新版本，提高了他本身在系统里面的优先级，已经找到解决办法了，目前还在做多配置，组合按键，下个版本一起发。
  
  回复
知名的学生
1 星期前

好像打不开下载链接了

回复
1. 爆胎
  1 星期前
  
  @知名的学生
  
  多刷新几次或者隔个几分钟再试，用的alist对接的阿里云盘，接口不太稳定。😂
  
  回复
阿良 1
2 星期前

有老版本吗给我网站我下载一下我安装老的也直接出现新版本

回复
1. 爆胎
  2 星期前
  
  @阿良
  
  我在国外的罗技网站下载的：https://support.logi.com/hc/en-us/articles/360025298133-Logitech-G-HUB、下载这个版本就可以：Software Version: 2023.1.364056 安装完了记得先关闭自动更新
  
  回复
  1. 阿良
    2 星期前
    
    @爆胎
    
    Software Version: 2023.1.364056 我使用了還是這樣算了無語
    
    回复
阿良
2 星期前

我也找找看老版本

回复
旧城以西 1
2 星期前

老哥，Logitech G HUB 怎么退老版本？下载安装的始终是最新版本💫

回复
1. 爆胎
  2 星期前
  
  @旧城以西
  
  我也是，下载的老版本安装包，安装后直接变成最新的了，66M的似乎都是在线安装包，我直接找了一个200多M的，2023年版本的，就OK了。
  
  回复
阿良
2 星期前

1.為什麼我使用的時候會停止不了？一直自動重複，我要切出去才能停止自動。如果沒選擇只能在遊戲界面到桌面也在自動重複

回复
1. 爆胎
  2 星期前
  
  @阿良
  
  可以描述的再具体一点吗？根据您描述的信息应该是用的第一种模式，第一种模式是按下启动(宏)，再次按下停止(宏)，如果使用焦点控制功能，请添加窗口后，选择窗口模式执行 😝🍭🤨🚲
  
  回复
  1. 阿良 2
    2 星期前
    
    @爆胎
    
    模式3 是窗口有時候會一直自動循環技能本來我是鼠標側啟動只能切別的窗口才能停止
    
    回复
    
    爆胎
    2 星期前
    
    @阿良
    
    是罗技鼠标吗🤔 我使用罗技鼠标也有这个问题，一度怀疑代码的线程处理机制有问题，排查了好几遍也没找到问题。然后我换了一个别的鼠标，杂牌子带侧键的，就再也没出过这个问题，如果你也是罗技鼠标可以换个鼠标试下。
    
    回复
    
    阿良
    2 星期前
    
    @爆胎
    
    哈哈哈確實是罗技鼠标 ....
    
    回复
    
    旧城以西
    2 星期前
    
    @阿良
    
    哈哈我也是罗技鼠标，和你一样的问题🤦‍♀️
    
    回复
    
    爆胎
    2 星期前
    
    @阿良
    
    确认了，确实是新版本的 Logitech G HUB 的问题，新版本对侧键的松开事件，有遗漏，尝试退回老版本，并关闭自动更新。
    
    回复
    
    爆胎
    2 星期前
    
    @阿良
    
    先用其他鼠标吧，我空了研究一下，初步的推断是Ghub 最新版本有什么问题，因为之前我用罗技是没问题的，最近一次ghub自动更新后就有这个问题出现了。
    
    回复

阿良
作者加油空了研究一下罗技换了鼠标难受死了
知名的学生
好像打不开下载链接了
阿良
Software Version: 2023.1.364056...
阿良
有老版本吗给我网站我下载一下我安装老的也直接出现新版本
阿良
我也找找看老版本

按键宏_TL_Macro

爆胎 • 2025 年 10 月 09 日

> 开源、免费、无广告，兼容大多数鼠标和键盘，大部分游戏和应用一样适用。

## 📖 一、项目简介

---

## 🧩 二、功能速览

---

## 🧪 三、技术栈一览

**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** - 配置读写、历史记录、多文件管理

---

## 🛠️ 四、快速开始
### 安装与运行

**✅系统要求**

- 操作系统: Windows 10/11 (64位)
- Python版本: 3.7+ (如运行源码)
- 权限要求: 管理员权限(自动获取)

---

**✅运行方式**

- 方式一：直接运行exe版本(推荐)、双击`TL_Macro.exe`
- 方式二：运行Python源码

```bash
  $ pip install PyQt5 pynput keyboard
  $ python app.py
```

> 💡 提示: 程序启动时会自动请求管理员权限，请点击"是"确认，否则部分功能可能无法正常工作。

---

### 基础使用教程

#### 1️⃣ 创建配置文件

- 点击左侧"新建"按钮
- 输入配置名称（最多10个字符），如"弓法配置"
- 点击确定创建，配置会自动保存

---

#### 2️⃣ 录制多键宏序列

---

#### 3️⃣ 设置启动热键

- 点击"设置热键"按钮
- 按下想要的触发按键：
  - ✅ 支持: 所有键盘按键，鼠标按键
  - ❌ 不支持: 组合按键

---

#### 4️⃣ 配置单键宏

---

#### 5️⃣ 窗口焦点控制(v1.4新增)

---

## 🚦 五、触发模式详解

### 多键宏模式

---

### 单键宏模式

---

## ⚡ 六、高级使用技巧

### 热键选择策略

🎮 游戏场景推荐:
 - 多键宏: 鼠标侧键、F1-F4功能键
 - 单键宏: 数字键1-4、字母键QERT
 - 避免: 常用技能键、移动键

---

💼 办公场景推荐:
- 多键宏: F9-F12、Insert、Delete
- 单键宏: 小键盘数字键
- 避免: Ctrl、Alt、Win系统键

---

### 时间参数优化

⚡ 高速连招 (PVP场景):
- 按下时间: 15-20ms
- 弹起时间: 15-20ms
- 间隔时间: 30-40ms

---

🛡️ 稳定输出(PVE场景):
- 按下时间: 20-30ms
- 弹起时间: 20-30ms
- 间隔时间: 50-80ms

---

🎯 精确控制 (特殊技能):
- 按下时间: 50-100ms (长按技能)
- 弹起时间: 20-30ms
- 间隔时间: 100-200ms (冷却等待)

---

### 窗口焦点高级配置

🔧 精确匹配:
- 进程名: `tl.exe` (精确文件名)
- 窗口标题: `王权与自由` (包含关键词)

---

🎯 多条件配置:
1. 添加多个进程名应对不同版本
2. 使用窗口标题关键词覆盖更多情况
3. 进程名和标题条件为"或"关系

---

📝 实际示例:
- 进程名: `tl.exe`, `tl_launcher.exe`
- 窗口标题: `Throne and Liberty`, `王权与自由`

---

### 配置管理技巧

💾 备份策略:
1. 定期导出重要配置
2. 使用描述性配置名称
3. 为不同职业创建独立配置

---

🔄 快速切换:
1. 为常用配置设置简短名称
2. 利用历史记录快速加载
3. 配置间热键避免冲突

---

## ⚠️ 七、注意事项

### 权限与安全

- 管理员权限必须 - 部分游戏屏蔽非管理员输入
- 杀毒软件误报 - 如遇拦截请添加白名单
- 游戏合规性 - 了解游戏规则，避免违规使用

### 性能优化

- 适当时间间隔 - 避免设置过短间隔增加CPU负载
- 按需启用功能 - 不需要时关闭窗口焦点监控
- 及时停止宏 - 切换窗口前停止正在运行的宏

---

## 🔧 八、故障排除

#### ❌ 热键无法触发

---

#### ❌ 宏执行不稳定

---

#### ❌ 窗口焦点识别错误

---

#### ❌ 程序无法启动

---

### 高级调试技巧
程序运行日志会在日志文件输出，包含：
   - ✅ 热键监听状态
   - ✅ 宏执行信息
   - ✅ 窗口焦点变化
   - ❌ 错误信息详情
---

## 🎯 九、使用场景示例

### 游戏场景配置

#### 🏹 弓法职业配置

**多键宏** (鼠标侧键1):
1 → 2 → 3 → 4 (技能连招)
时间: 20ms按下, 20ms弹起, 50ms间隔

**单键宏** (F1键):
治愈之手 (每5秒自动释放)
时间: 30ms按下, 30ms弹起, 5000ms间隔

---

#### ⚔️ 弩匕职业配置

**多键宏** (鼠标侧键2):
Q → W → E → R (爆发连招)
时间: 15ms按下, 15ms弹起, 40ms间隔

**单键宏** (F2键):
回蓝技能 (低蓝量时自动使用)
时间: 25ms按下, 25ms弹起, 3000ms间隔

---

## 🤝 十一、致谢与开源

献给 所有《王权与自由》的冒险者。
- 开源协议: MIT – 可商用、可修改、请保留原作者信息
- 问题反馈: GitHub Issue 区或反馈链接

💬 **交流渠道**:

- GitHub Issues: 技术问题反馈
- 项目Wiki: 使用教程和开发文档
- 社区讨论: 使用心得分享

---

## 📜 十二、版本记录

---

## ⌛️ 十三、后续开发计划

---

## 🎮 开始使用

立即下载，开启你的自动化冒险之旅！
**温馨提示:**

如果这个项目对你有帮助，请给个⭐Star支持一下！

[1]: https://p.tiax.cn/Macro
  [2]: https://p.tiax.cn/T/Macro

按键宏_TL_Macro

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

18 条评论

Win11 下基于 WSL2 安装 kali-linux子系统完全指南

표은지(Eunji Pyoapple)

博客个性化字体修改

命令行参数和配置文件参数指南

为你的博客添加一个萌萌哒的看板娘吧

主题个性化备忘录

命令行参数和配置文件参数指南

内网Web代理解决方案

在回忆里，我们永远是恋人

표은지(Eunji Pyoapple)

按键宏_TL_Macro

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

18 条评论

按键宏_TL_Macro

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款