如何安装、设置或自行创建 Logitech G HUB 宏

区分原生宏、Lua 与板载内存

G HUB 针对同一设备提供几种不同机制。应根据目标和逻辑运行位置选择，而不是照搬其他鼠标型号的菜单。

.lua 属于第二种，在 Assignments 中录制的序列属于第一种。开启 On-Board Memory 不会把二者转换为无限制的固件自动化。

准备 G HUB、设备与回退方案

加载前先记录初始状态，可避免把错误配置或误改主按键当成硬件故障。

• 使用官方 G HUB。 完成更新，重新连接目标鼠标，并确认设备页面与设置能正常打开。
• 检查下载内容。 解压、扫描并阅读说明；如果本应只有数据或脚本，却出现未知可执行文件，不要运行。
• 保存当前布局。 截图记录活动配置和按键，保留普通主点击，进行敏感测试时准备备用鼠标。
• 选择真实应用配置。 关联到主可执行文件。Desktop Default 是中性备用配置，并非所有宏的必选位置。
• 从一次性动作开始。 用侧键和安全窗口测试，直到启动、时序和停止都明确。

创建并分配 G HUB 原生宏

内置编辑器适合快捷键、可控点击、文本与应用命令。先制作并验证短版本，稳定后再增加重复。

1. 打开正确设备。

   选择当前连接的鼠标，并核对页面所显示的应用配置。

2. 进入 Assignments → Macros。

   点击 Create New Macro，用应用与用途命名。

3. 明确选择播放方式。

   从 No Repeat 开始，其他模式仅在停止条件清楚时使用。

4. 添加操作。

   录制键盘、鼠标、文本或支持的命令，并删除意外输入。

5. 核对延迟和释放。

   为应用保留处理时间，确保每个按下动作都有对应释放。

6. 分配到按键。

   保存后拖到鼠标示意图，并在测试前核对新标签。

如果宏已在列表中，但实体按键仍执行旧功能，说明录制成功而分配或活动配置有误，无需再创建副本。

正确加载配置文件 Lua 脚本

G HUB 运行时，Lua 会响应配置中的受支持事件。只有目标配置确实提供 Scripting 时才使用此方式。

1. 选择目标配置。

   保存在 Desktop 或其他游戏下的脚本不会自动跟随正确程序。

2. 打开 Scripting。

   如没有该项，请检查型号、平台、固件与当前支持。

3. 备份原有代码。

   导入可能覆盖内容，因此先保存为带日期的文本文件。

4. 加载 .lua。

   使用打开或导入，先阅读设置、注释和事件处理，再保存。

5. 激活配置。

   切换到关联应用，并在日志中确认配置激活和预期按键事件。

6. 只做一次受控测试。

   使用安全场景和明确停止方法；若事件未到达，暂时不要改时序。

让按键与应用配置可预测

许多偶发问题其实是配置切换。G HUB 可按程序切换，而持久配置会在所有位置锁定同一布局。请分别测试。

1. 核对可执行文件。

   关联主进程，而不是只关联启动器、更新器或快捷方式。

2. 选择安全触发键。

   先用可编程侧键，不要在没有替代控制时改掉主点击。

3. 检查标签。

   原生宏名称应显示在按键旁；Lua 则监听支持的按键事件。

4. 观察自动切换。

   在 Desktop 与目标应用之间切换，查看活动配置名称。

5. 持久配置仅用于诊断。

   短暂固定已知配置，找到原因后恢复应用自动切换。

按板载内存限制选择播放方式

桌面 G HUB 与鼠标内部不是同一运行环境。先在软件模式验证，再判断简单便携分配是否足够。

开启 On-Board Memory 后，G HUB 无法按普通方式编辑鼠标。修改时返回 software mode，或仅对支持的型号使用 Onboard Memory Manager。

设计易于理解的自定义宏

可维护的宏只完成一项允许的任务，触发明确，并有可观察的结束。录制前先用文字描述。

1. 确定一个结果。

   例如应用命令、允许的固定文本或简短无障碍快捷键。

2. 拆分按下、等待与释放。

   记录每个事件和预期应用状态。

3. 选择最简单工具。

   线性序列用 Macros，受支持条件用 Lua，基础便携操作用板载。

4. 构建最小版本。

   删除意外输入，并清晰命名配置、宏和备份。

5. 测试一个周期。

   观察顺序，每次只改一个延迟，稳定性优先于速度。

6. 记录有效状态。

   保存设备、模式、配置、按键、播放方式和日期。

使用 Lua 时，先在日志中确认配置激活和按键事件。触发没有到达时，重写执行部分无法解决问题。

整理配置、版本与备份

保留一个按键普通的中性 Desktop，并为每个应用建立独立配置。描述性名称能在自动切换时立即说明当前设置。

验证后，在安装目录外保存按键图、Lua 源码，以及设备、G HUB 版本、exe 路径、播放与日期说明。

如需适用于受支持鼠标与应用的准备文件，请查看 EasyMacro 商店，并在购买前核对软件、型号和设置要求。

Logitech G HUB 宏不工作时的排查

按设备、文件类型、配置、触发、权限和规则的顺序检查。盲目重装可能删除线索，却不修正错误配置。

如需带界面的辅助步骤，也可查看 TopMacro 中文 Logitech 宏文章。

只在规则允许的场景使用自动化

G HUB 是官方软件，但并非所有操作序列都被每款游戏允许。发行商、服务器、联赛和赛事可以限制多项动作、重复、后坐力补偿或无人操作。

请阅读具体游戏、服务器和模式的最新规则。生产力、无障碍、创作工具和离线测试用途更明确，但任何销售者都不能保证未来的执法决定。

保留普通配置，从有限测试开始，并确保随时停止。良好设置应可理解、可撤销，且在当前场景获得许可。