装机前的提醒、驱动报错、固件信息读不出、硬件宏保存失败等常见问题，见另一篇：键鼠助手 4.0 使用需知：装机前请先看这篇

合规提示：本软件及配套工具仅供提升效率的合法自动化用途。请遵守中国法律法规与相关软件、平台的使用条款，
不得用于游戏外挂、破坏公平性、规避安全机制或侵犯他人权益的场景。

下载清单

主程序

KMA_Software_v4.50_release.zip

键鼠助手 4.0 的 Windows 完整发布包（KMA Software v4.50），解压即用。主程序是 键鼠助手4.exe，另有 按键映射.exe 与更新器 updater.exe；包里同时带了 Qt 6 运行库、VC++ 运行库安装程序，以及做二次开发要用到的 kma_api_x64_shared.dll / 静态库 / kma_lua.lib / key_map.lib。

• 版本：KMA Software v4.50，Windows 64 位解压即用（不需要安装）
• 主程序 键鼠助手4.exe：宏绑定、Lua 宏编辑、编译烧录、场景切换
• 附带工具：按键映射.exe（按键重映射）、updater.exe（软件升级）、kma_api_test.exe（API 自检）
• 二次开发件：kma_api_x64_shared.dll + .lib（动态库，含导出 lib 与 exp）、kma_api_x64_static.lib（静态库）、kma_lua.lib、key_map.lib
• 依赖件：Qt6Core/Gui/Widgets/Network/Svg.dll、opengl32sw.dll、d3dcompiler_47.dll，以及 platforms/、imageformats/、styles/、tls/ 等 Qt 插件子目录
• tools/ 目录是打包、签名、生成 macOS 图标的脚本与 7z，普通用户无需理会

下载 KMA_Software_v4.50_release.zip（53.55 MiB）

注意事项

• 解压后请整目录使用，不要只把 exe 单独拷出来 —— Qt 运行库必须与程序在同级目录，platforms/、imageformats/ 这些插件子目录也要一起保留，否则启动即报错退出。
• 若提示缺少 VCRUNTIME140.dll、MSVCP140.dll，先运行包内的 vc_redist.x64.exe 安装 VC++ 运行库。
• 首次运行 Windows SmartScreen 可能拦截，点「更多信息 → 仍要运行」。
• 本包只有 64 位 Windows 版本；32 位系统不可用，macOS 请到「键鼠助手5.0」版块取 dmg 版本。

驱动程序

CH372_DRIVER.exe

沁恒 CH372 / CH375 系列 USB 芯片的驱动安装程序。第一次打开软件弹出「找不到 CH375DLL64.DLL」时，装它就好 —— 缺那个 DLL 说明驱动没装，跟主程序没关系统，也不必重装软件。

• 适用症状：首次运行 keyMap / 键鼠助手时提示「由于找不到 CH375DLL64.DLL，无法继续执行代码」
• 包内含动态库：CH375DLL.dll（32 位）与 CH375DLL64.dll（64 位）
• 包内含驱动文件：CH375WDM.INF、CH375WDM.SYS、CH375WDM.CAT、CH375W64.SYS、CH375M64.SYS
• 安装程序由包里的 DRVSETUP64.exe 驱动，按提示一路下一步即可
• 实为 WinRAR 自解压包（SFX），也可以直接解压后手动指定路径安装

下载 CH372_DRIVER.exe（346.23 KiB）

注意事项

• 建议以管理员身份运行，否则可能写不进系统的驱动存储区。
• 装完重启一次 Windows 再打开主程序 —— 不重启有时仍认不到设备。
• 64 位系统用 64 位库 CH375DLL64.dll，32 位用 CH375DLL.dll；报错说缺哪个就补哪个。
• 校验值 SHA256：8B768DE015C0DF225337F6865041E969939525DBF24F9C5A9FDD1370027CA480（346.23 KiB），下载后可自行比对。
• 若 SmartScreen 拦截，点「更多信息 → 仍要运行」。

说明文档

键鼠助手软件宏编程文档.pdf

键鼠助手 Lua 宏编程的完整说明（18 页 PDF，Typora 导出）。前半部分是 Lua 编程简介：如何获取系统分辨率、Lua 事件驱动的两种写法（OnEvent 模式 / while 循环模式）；后半部分是 函数说明，逐个列出宏脚本能调的全部函数，最后是附录 A。写宏之前建议先通读一遍。

• 编程简介：获取系统分辨率、事件驱动的 OnEvent 模式与 while 循环模式（两者不可混用）
• 控制与日志：Sleep、OutputLogMessage、GetRunningTime、GetDate、ClearLog、OutputLCDMessage、ClearLCD
• 键盘：PressKey、ReleaseKey、PressAndReleaseKey、ReleaseAllKey、IsKeyPressed、IsModifierPressed、IsKeyLockOn、EnablePrimaryMouseButtonEvents
• 鼠标：PressMouseButton、ReleaseMouseButton、PressAndReleaseMouseButton、IsMouseButtonPressed、MoveMouseTo、MoveMouseRelative、MoveMouseWheel、GetMousePosition
• 宏控制：PlayMacro、AbortMacro
• 找色找图：FindPictureByOpenCv、FindColor、FindMultiColor、FindMultiColorT、GetColorRgb、GetColorNumber、IsColorSimilar

下载 键鼠助手软件宏编程文档.pdf（544.87 KiB）

注意事项

• 本文档针对 4.0 版本的 Lua 接口撰写；5.0 起界面与函数有调整，请对照使用。
• PDF 18 页，带书签，可按目录跳转。

二次开发 · 头文件

kma_api .h

KMA SDK 的 C++ 主头文件。定义了两个枚举 —— KeyCode（HID usage 键码：A~Z、数字行、F1~F24、方向键、小键盘、以及 224~231 的八个修饰键）和 MouseButton（左 / 右 / 中 / 侧前 X2 / 侧后 X1），以及全部导出函数：初始化、设备状态、事件监听、键鼠模拟、场景切换、宏播放、数据烧录与回读。

• 连接管理：Kma_Init（可传连接状态回调）、Kma_DeInit、Kma_IsDeviceConnected
• 设备信息：Kma_GetUid(timeoutMs) 取设备唯一标识（异步，需传等待毫秒，-1 为无限等待）
• 事件监听：Kma_SetKeyboardEventMonitor（标准 6 键无冲，8 字节报告）、Kma_SetMouseEventMonitor（4 字节：按键 / 保留 / 滚轮）
• 键盘模拟：Kma_PressKey、Kma_ReleaseKey、Kma_ClickKey、Kma_PressKeys（组合键）、Kma_ReleaseAllKeys、Kma_SendRawKeyEvent（裸报告）
• 鼠标模拟：Kma_PressMouseButton、Kma_ReleaseMouseButton、Kma_ClickMouseButton、Kma_MoveMouseRelative（±32767）、Kma_MoveMouseTo（0~65535 绝对坐标）、Kma_ScrollMouseWheel
• 场景与宏：Kma_SwitchScene（0~9，共 10 个场景）、Kma_QueryCurrentSceneIndex、Kma_PlayMacro、Kma_AbortMacro、Kma_IsMacroRunning
• 固件数据：Kma_BurnData、Kma_LoadData，两者都支持进度回调（当前帧 / 总帧数）
• 跨平台导出宏：Windows 用 __declspec(dllexport)，GCC/Clang 4+ 用 visibility 属性

下载 kma_api .h（8.55 KiB）

注意事项

• 文件名点号前有一个空格：下载下来是 kma_api .h，而 kma_api_c_wrapper.h 里写的是 #include "kma_api.h" —— 放进工程前请先改名为 kma_api.h，否则编译报「找不到头文件」。
• 头文件顶部是完整的免责声明：本软件仅供提升效率的合法自动化用途，不得用于违反法律法规、破坏游戏公平性或规避安全机制的场景。
• 原文注明：连接状态以下的接口必须在设备连接成功后调用才有效，建议在 Kma_Init 的回调里再去挂监听、发事件。
• Kma_GetUid 与 Kma_QueryCurrentSceneIndex 是异步取结果，务必传入合理的超时毫秒数，超时返回异常值。
• 键值沿用 HID usage id：普通键 KeyCode::A 起顺序递增，修饰键是 224（LEFT_CTRL）到 231（RIGHT_GUI），写死数字前请对照枚举。

kma_api_c_wrapper.h

KMA SDK 的 C 语言封装头文件，把 C++ 版里 std::function、std::vector、std::initializer_list 这些无法跨语言直接调用的类型，一律换成函数指针 + 数据指针 + 长度的形式，函数统一加 _C 后缀并声明 __stdcall。C、C#（P/Invoke）、Delphi、易语言等语言用它对接。

• 五个回调类型：ConnectStateCallback、KeyboardEventCallback、MouseEventCallback、ProgressCallback、DataCallback
• 生命周期：Kma_Init_C / Kma_Init_C2(回调) / Kma_DeInit_C / Kma_IsDeviceConnected_C（返回 int）
• 键鼠模拟：Kma_PressKey_C、Kma_ReleaseKey_C、Kma_ClickKey_C、Kma_ReleaseAllKeys_C、Kma_ClickMouseButton_C、Kma_MoveMouseRelative_C、Kma_MoveMouseTo_C、Kma_ScrollMouseWheel_C
• 组合键：Kma_PressKeys_C(const KeyCode *keys, int keySize) —— 数组 + 长度，替代 C++ 的初始化列表
• 原始数据：Kma_SendRawKeyEvent_C(data, size)、Kma_BurnData_C(data, size, 进度回调)、Kma_LoadData_C(数据回调, 进度回调)

下载 kma_api_c_wrapper.h（4.10 KiB）

注意事项

• 同样依赖 kma_api.h：#include "kma_api.h"，所以两个头文件要放同一目录并按上面说的改好名。
• __stdcall 在 64 位目标上会被 MSVC 忽略；跨语言声明时以 DLL 实际导出名为准，找不到入口就先用 dumpbin /exports 看一眼。
• C++ 版 Kma_ClickKey(KeyCode key, int internal) 的参数名拼作 internal，实际含义是按下与松开之间的毫秒间隔，别当成「内部标志」传 0/1。
• Kma_IsMacroRunning_C 返回 int，跨语言声明时不要写成 BOOL 或 bool 以外的宽类型。

二次开发 · 示例工程

kma_api_demo_vs2019.zip

VS2019 控制台示例工程，演示 SDK 的最小接入闭环：Kma_Init 里注册连接回调 → 回调内挂键盘 / 鼠标监听 → 主线程轮询 Kma_IsDeviceConnected 等上线 → Kma_GetUid(20) 读设备 UID → 起异步任务做 Kma_QueryCurrentSceneIndex + Kma_ClickKey + Kma_IsMacroRunning。源码里被注释掉的那一段完整覆盖了其余键鼠调用，解开就能逐个试用。

• 工程文件：kma_api_demo_vs2019.sln / .vcxproj，入口 kma_api_demo_vs2019.cpp（约 2.5 KB，很短，适合当模板）
• 随包带上 kma_api.h、kma_api.dll、kma_api.lib 与调试版 kma_api_d.lib，还有日志辅助头 log.h
• x64/Debug/kma_api_demo_vs2019.exe 是已编译产物
• 示范了连接回调、事件监听的注册与取消（传 nullptr 即取消监听）、异步等待两类写法

下载 kma_api_demo_vs2019.zip（79.50 MiB）

注意事项

• 需要 Visual Studio 2019（v142 工具集）与 Windows x64 目标。
• 包里 .vs/ 与 ipch/ 占了大部分体积（约 80 MB 中的绝大部分），只是为了让工程打开即用；想精简直接删掉这两个目录，源码本身只有几 KB。
• 拿到新机器建议先用 VS 重新生成一次再运行，避免本机缺 v142 的运行库导致 exe 启动即退出。
• 这是控制台示例，看不到界面；要看窗口化的按钮演示请用下面的 kma_demo_vs2019_UI 包。

kma_demo_vs2019_UI_20250919.zip

带界面的示例工程（2025-09-19 版），Win32 对话框形式，把 SDK 的每个能力都做成了按钮和输入框 —— 不用写代码就能逐个验证硬件是否正常响应，排查问题时非常顺手。

• 连接区：连接设备 按钮 + 静态文本实时显示设备状态
• 键盘区：按下 / 释放 / 点击三个按钮，各自配输入框填键码，另有清屏按钮
• 鼠标区：左键 / 中键 / 右键 / 侧键1 / 侧键2 点击、滚轮，相对移动（X / Y）与绝对移动（X / Y）
• 数据区：数据写入 / 数据读取，对应 Kma_BurnData / Kma_LoadData，用于把配置烧进硬件再回读校验
• 监听开关：键盘事件、鼠标按键事件、鼠标移动三个复选框，勾选即开始把收到的报告打到日志区
• 含 x64/Release/kma_demo_vs2019.exe（已编译）、源码 kma_demo_vs2019.cpp（约 13 KB）、资源文件 .rc / .aps / resource.h / 图标，以及 kma_api.lib

下载 kma_demo_vs2019_UI_20250919.zip（105.99 MiB）

注意事项

• 不想编译的话，直接跑 x64/Release/kma_demo_vs2019.exe 就能用。
• 同样带 .vs/ 与 ipch/，可以删掉；源码和资源加起来不到 1 MB。
• 「数据写入」是把配置真正烧进硬件（对应 Kma_BurnData），会覆盖原有内容；操作前确认设备已连接，拿不准就先点「数据读取」备份一份再写。
• 对话项目标平台 x64，VS2019 v142。

调试工具

move_algorithm.exe

鼠标 HID 报告解析 / 位移换算的测试工具，出自 hid-report-translater 工程（MinGW 编译），用来验证「不同品牌鼠标上报的位移数据该怎么翻译」。包里能看到针对具体型号的适配实现：罗技 G203 / G402 / Light Speed 接收器、雷蛇 RZ01-0254、惠普 M1、EM 905pro、Acer（erazer）KN301 等；输出形如 Move:[x:xx,y:xx],then delay:xx 的位移 + 延时序列。

• 解析 HID 报告描述符：parse_report_descriptor、parse_usb_mouse、get_mouse_field_data
• 按型号做位移换算：make_mouse_translate、mouse_translate_usage_handler，每种鼠标一个 .c 实现
• 移动模拟与回调：simulate_random_mouse_movement（随机移动压测）与 on_receive_mouse_movement（收到位移即打印）
• 另保留了一份旧解析器 old_mouse_parser 与 mouse_test 可对照调试

下载 move_algorithm.exe（178.32 KiB）

注意事项

• 这是给开发调试用的命令行程序，不是面向普通用户的客户端：双击会一闪而过，请在 CMD 或 PowerShell 里运行。
• 输出的是 HID 报告里的相对位移量与延时，不是屏幕像素坐标，不要直接拿去当脚本里的绝对坐标。
• 需要目标鼠标在线并被正确枚举，才有数据可读。

键鼠测试.html

浏览器端的「极致事件捕获器 - Pro」，单文件网页，用来确认按键和鼠标到底有没有被系统收到、收到的键码是什么。日志按「时间 / 类型（KBD·MSE·SYS）/ 详情」三列滚动显示，最多保留 1000 行。

• 键盘：e.code（物理位置）+ e.key（实际字符）双显示，连续输入会标 [连续重复]，并记录中文输入法的 compositionstart
• 鼠标：按下 / 松开 / 滚轮，区分左键、中键、右键、后退、前进，按下时附带坐标
• 可单独开关「键盘监听」和「鼠标监听」
• Alt+C 清空记录，焦点回到页面即恢复监控

下载 键鼠测试.html（8.23 KiB）

注意事项

• 纯前端单文件，用浏览器打开即可，不联网、不落数据。
• 页面用 capture 阶段拦截并 preventDefault，部分默认行为（如 F5、Tab、空格）会被吃掉 —— 这是刻意的，方便观察按键本身。
• 窗口失焦时会盖一层遮罩提示监控已挂起，点页面任意位置恢复；按 F11 全屏能拦到更多组合键。
• 系统级热键（Win+L、Alt+Tab 等）浏览器层面拿不到，看不到属正常。
• 它反映的是 DOM 层的事件，不是硬件 HID 报告；要验证盒子实际发出的数据请用上面两个工具。

第三方工具

Wireshark-4.2.3-x64.exe

Wireshark 4.2.3 官方安装包（Windows x64），网络协议分析器。放在这里主要不是为了抓网络，而是用它抓 USB HID 通信，核对键鼠盒子到底有没有把报告发出来、发出去的是什么数据。

• 版本 4.2.3，官方原版安装包，64 位
• 可分析 USB、TCP/UDP、蓝牙等多种通道
• 与上面的 move_algorithm.exe 配合，能从协议层确认报告内容与实际产出的位移序列是否一致

下载 Wireshark-4.2.3-x64.exe（82.37 MiB）

注意事项

• 安装向导里要勾选 USBPcap 才能抓 USB（默认不勾），装完需要重启。
• 抓 USB 需要以管理员身份运行。
• 包体 82 MiB，安装过程较慢，属正常。

WCHISPTool_Setup (1).exe

沁恒微电子（WCH）的官方 ISP 下载工具安装包，用于给沁恒 CH 系列芯片（CH32x、CH5xx 等）通过串口或 USB 烧写 / 升级固件。手里硬件用的是沁恒芯片时，固件更新走这个工具。

• 沁恒官方原版安装程序
• 支持串口（UART）与 USB 两种下载方式
• 覆盖了沁恒 RISC-V 与 ARM Cortex-M 系列的主流型号

下载 WCHISPTool_Setup (1).exe（19.42 MiB）

注意事项

• 文件名里的 (1) 只是下载时自动加的重名后缀，安装后不影响使用，介意的话安装前自行改名。
• 使用前要在工具里选对自己的芯片型号和下载方式；型号选错会连不上或烧写失败。
• 如果目标不是沁恒芯片，这个工具用不上。
• 安装过程 Windows Defender SmartScreen 可能拦截，选「仍要运行」。

向日葵_15.3.0.62055_x64.exe

向日葵远程控制客户端安装包（版本 15.3.0.62055，上海贝锐信息科技股份有限公司），用于远程或无人值守访问另一台机器 —— 例如在你不在电脑旁时，远程跑上面的调试工具。

• 版本 15.3.0.62055，官方包，64 位
• 远控客户端，安装绑定被控主机后可用手机 / 另一台电脑连过来

下载 向日葵_15.3.0.62055_x64.exe（43.66 MiB）

注意事项

• 第三方软件，与键鼠助手本身没有依赖关系，用不上可以不装。
• 这里提供的是固定历史版本，不是最新版；要新版请到官网下载。
• 装之前建议到官网核对安装包哈希。远控软件权限很高，只在自己信任的机器上安装。

大漠综合工具.zip

大漠插件 7.2119 的综合工具包。根目录是 dmcjwapjb7.2119/7.2119/，里面除了插件本体 dm.dll，还有 大漠综合工具.exe、大漠后台系统.exe、大漠类库生成工具v23.0.exe、获取本机机器码.exe、注册/卸载 两个 bat、RegDll.dll、大漠插件接口说明.chm、一个答题器示例工程（含 VC++ 源码），以及「不注册调用 dm.dll 的方法 v11.0」（DmReg.dll + 说明）。

• 大漠插件接口说明.chm 是完整的接口文档，用之前先看它
• 大漠综合工具.exe 是可视化辅助工具，另有一个「隐藏路径」版本
• 大漠类库生成工具v23.0.exe 可按语言生成调用封装
• 答题器/ 目录是完整的示例工程：Get_Question / Put_Question 源码 + 编译好的 exe + 使用说明
• 获取本机机器码.exe 用来取机器码（大漠插件绑定需要）

下载 大漠综合工具.zip（8.66 MiB）

注意事项

• 第三方工具包，使用请遵守大漠自身的授权条款。
• 注册 / 卸载插件要用管理员身份运行 注册大漠插件到系统.bat / 从系统里卸载大漠插件.bat。
• 压缩包里中文文件名没有打 UTF-8 标志位（实际是 GBK），Windows 资源管理器能正常显示；在其他系统或用第三方解压工具时可能出现文件名乱码，文件本身不受影响。
• 用途请遵守键鼠助手免责声明：不得用于违反法律法规、破坏游戏公平性或规避软件安全机制的场景。

上手顺序推荐

1. 先看 Lua 宏编程文档，了解 OnEvent / while 循环两种写法和全部可用函数；
2. 下载主程序 KMA_Software_v4.50_release.zip，整目录解压后双击 键鼠助手4.exe；
3. 写脚本时可用 键鼠测试.html 确认按键是否被正确识别，需要抓协议层再上 Wireshark；
4. 要在自己的程序里控制设备，就看 kma_api.h / kma_api_c_wrapper.h，配合两个示例工程改；
5. 确认可用后再把宏烧录进硬件。