下载清单

主程序

KMA_Software_v5.20_release.zip

键鼠助手 5.0 的 Windows 完整发布包，解压即用，无需安装。包含主程序 键鼠助手5.exe、按键映射.exe、键鼠透传.exe 三个可执行程序，另有自带更新器 updater.exe、二次开发用的 kma_api_x64_shared.dll 与 Qt 6 运行库。

• 适用系统：Windows 10 及以上，64 位
• 内含三个程序：键鼠助手5.exe（键鼠助手主程序，含宏绑定、宏编辑与烧录）、按键映射.exe、键鼠透传.exe
• 对应版本：KMA Software v5.20，本版新增内置函数 GetUpTime()（毫秒级运行时钟，用法与示例见 键鼠助手 5.20 新增内置函数 GetUpTime()）
• 本版为精简发布包：不再附带调试版运行库（*d.dll）、Qt 翻译文件、.pdb 与 tools/ 打包脚本

下载 KMA_Software_v5.20_release.zip（24.73 MiB）

注意事项

• 解压后请整目录使用，不要只取单个 exe —— 程序与 Qt 运行库必须在同一目录。
• 包内不再附带 vc_redist.x64.exe；若提示缺少 VCRUNTIME140.dll，请自行到微软官网安装 VC++ 2015–2022 x64 运行库。
• 首次运行 Windows SmartScreen 可能拦截，点「更多信息 → 仍要运行」。

KMA_5.20_Release.dmg

键鼠助手 5.0 的 macOS 磁盘映像，挂载后内有三个 app：键鼠助手.app（主程序）、按键映射.app、键鼠透传.app，拖入「应用程序」即可使用。

• 适用系统：macOS（已集成 Qt 6 框架与 OpenSSL）
• 内含三个 app：键鼠助手（宏绑定 / 宏编辑）、按键映射、键鼠透传
• 对应版本：KMA 5.20 Release
• 支持软件内检查更新（关于 → Check Software Update）

下载 KMA_5.20_Release.dmg（62.04 MiB）

注意事项

• 三个 app 必须放在同一目录（例如都拖进「应用程序」）。按键映射 / 键鼠透传是外壳 app，靠启动器调用主程序包里的真实程序，只装外壳无法运行。
• 不要直接在挂载的 dmg 里运行 —— 映像只读，配置无法写入，自更新也会失败。
• 首次打开可能需要到「系统设置 → 隐私与安全性 → 输入监控」重新授予权限。
• 本包为 ad-hoc 签名，未做 Apple Developer ID 公证；Gatekeeper 可能提示「无法验证开发者」，需右键「打开」或先去掉隔离属性（xattr -d com.apple.quarantine 键鼠助手.app）。

说明文档

键鼠助手 5.0 使用文档.md

键鼠助手 5.0 的完整使用文档（Markdown 源文件），涵盖软件界面讲解、宏的完整使用流程、Lua 脚本语法与全部键鼠函数定义。建议在使用软件前先通读一遍。

• 特色功能：纯硬件 Lua 宏、三种触发方式、单键可绑按下/松开两个宏、延时误差小于 1ms、10 个可切换场景
• UI 讲解：宏绑定、宏编辑（三栏：宏目录 / 编辑器 / 函数说明）、偏好、关于、状态栏
• 脚本流程：编辑 → 编译校验语法 → 运行 Lua 测试 → 绑定按键与触发类型 → 烧录 → 实机验证
• 语法参考：数据类型、控制语句、键盘鼠标命令与全部函数定义

下载 键鼠助手 5.0 使用文档.md（18.28 KiB）

注意事项

• 文档针对 5.0 版本撰写，4.0 及以下版本的界面与函数名不完全一致。
• Markdown 源文件，可用任意编辑器或 Typora 打开。

配套工具

键盘鼠标事件录制工具.exe

写宏时的辅助录制工具：把你对键盘和鼠标的真实操作录下来，直接生成可用的 Lua 宏脚本，省去手工写参数的过程。录完可预览、复制或保存成 .lua，再粘到键鼠助手的「宏编辑」里编译烧录。

• 可分别开关：单独选择「录制键盘事件」或「录制鼠标事件」
• 鼠标事件完整：按下 / 松开 / 移动 / 滚轮，区分左键、右键、中键、侧前键、侧后键
• 热键控制：按自定义热键开始 / 停止录制，无需切回界面点到按钮
• 后台录制：最小化到系统托盘后仍继续录制，双击托盘图标恢复窗口
• 导出方式：脚本预览、复制到剪贴板、保存 .lua 文件

下载 键盘鼠标事件录制工具.exe（176.00 KiB）

注意事项

• 采用低级钩子（low-level hook）采集全局输入，杀毒软件可能敏感拦截，请放行。
• 若提示「输入钩子启动失败」或「当前平台暂不支持全局输入钩子」，请以管理员身份运行。
• 录制结果是事件序列的直接翻译，使用前建议先在宏编辑里「编译」校验，并精简多余的鼠标移动采样点。

鼠标定位.exe

屏幕坐标辅助工具：在鼠标位置叠加显示实时坐标。写需要精确位移、或要定位到某个像素点的宏时，用它读出目标坐标，再把数值填进脚本。

• 叠加显示：跟随鼠标显示当前坐标，不抢焦点
• 全局热键：随时开关显示
• 设置面板：右键菜单可进入，调整显示方式
• 多显示器：按可用屏幕区域取坐标

下载 鼠标定位.exe（56.00 KiB）

注意事项

• 绿色免安装单文件，双击即用。
• 热键若与其他软件冲突，在系统托盘退出本工具后重开即可解除占用。
• 坐标以屏幕左上角为原点，填脚本前请确认脚本里用的是否同为绝对坐标。

上手顺序推荐

1. 先看 使用文档，了解宏绑定、宏编辑和烧录的完整流程；
2. 下载对应平台的主程序（Windows 解压即用 / macOS 拖入应用程序）；
3. 写脚本时可配合 录制工具 生成骨架、用 鼠标定位 取坐标；
4. 测试通过后再点到键鼠助手里烧录到硬件。