跳转至内容

世界

本论坛之外的主题。此处表达的观点和意见可能不代表本论坛及其成员的立场。

海量内容尽在指尖 …

不妨将此视为您专属的全球发现信息流。它汇集了来自互联网各处及其他社区的有趣讨论,一应俱全。

虽然您可以浏览当前的热门内容,但使用该信息流的最佳方式是将其个性化。通过注册账号,您可以关注特定的创作者和主题,从而过滤掉无关信息,只查看对您真正重要的内容。

准备好开始了吗?注册一个账号,即可关注他人、在收到回复时获得通知,并收藏您喜欢的内容。

注册 登录
  • A

    连点是宏的入门项目,也是最容易被写错的一个。这篇把「频率到底怎么算」讲清楚,剩下的写法都是它的变体。

    先搞清一件事:MouseClick 自己就占 20ms

    文档里写着 MouseClick 是「按下与松开间隔 20 毫秒」。这句话的准确含义是它内部就是三条子命令:

    MouseClick(1)  ==  MouseDown(1) → Delay(20) → MouseUp(1)
    

    那 20ms 不是额外开销,是一条写死在命令里、你改不了的 Delay。这意味着:

    实际周期 = 20ms(点击本身) + Delay 的值
    实际频率 = 1000 / 实际周期
    

    所以 MouseClick(1) 后面跟 Delay(50),得到的是 14 次/秒,不是 20 次/秒。想要 20Hz,Delay 要写 30。

    想要频率 Delay 该写 实际周期
    10 次/秒 80 100ms
    20 次/秒 30 50ms
    30 次/秒 13 33ms
    50 次/秒 0 20ms(MouseClick 的上限)

    MouseClick 的天花板是 50 次/秒,因为那 20ms 是写死在命令里的。要更快只能绕过它,用 MouseDown + MouseUp 自己拼(见最后一节)。

    写法一:固定次数

    最简单,次数写死:

    local CLICK_COUNT = 100
    local INTERVAL_MS = 30          -- 约 20 次/秒
    
    for i = 1, CLICK_COUNT do
        MouseClick(1)
        Delay(INTERVAL_MS)
    end
    

    适合「点一百下就停」的场景。缺点是次数不能临时改,改一次要重新烧录。

    写法二:带上限的 while

    点数由变量控制,同时留一个硬上限防跑飞:

    local MAX_COUNT = 500
    local INTERVAL_MS = 30
    local count = 0
    
    while count < MAX_COUNT do
        MouseClick(1)
        Delay(INTERVAL_MS)
        count = count + 1
    end
    

    MAX_COUNT 是一道保险。写 while true 而忘了上限,又没配中断键,脚本会一直点下去直到你拔设备——这种事故在这类设备上一律靠「触发方式」兜底,下面就讲。

    写法三:按住连发(靠触发方式中断)

    连发不需要在脚本里判断「什么时候停」,交给触发方式:选用按下触发松开中断,按住执行、松手立即停。脚本本身可以写成无限循环:

    -- 按住左键连点,松手由「按下触发松开中断」停止
    while true do
        MouseClick(1)
        Delay(30)
    end
    

    ⚠️ 这段必须绑「按下触发松开中断」或「按下触发(ESC 中断)」。 如果绑成「按下触发」且没配终止键,它会一直点下去。

    同理,要用鼠标左键本身做触发键,就不能再让脚本点左键——那样会自我触发。连发类宏一般绑在侧键上。

    加抖动的意义

    固定间隔的点击是「机器节奏」,某些程序(比如需要人工操作确认的界面)会对完全规律的输入做过滤。给间隔加一点随机偏移,节奏更像人:

    local BASE_MS = 30
    local JITTER_MS = 4           -- 实际间隔在 26–34ms 之间
    
    while true do
        MouseClick(1)
        Delay(BASE_MS + math.random(-JITTER_MS, JITTER_MS))
    end
    

    math.random(m, n) 是闭区间,能取到两端。JITTER_MS 不要给太大——抖动过大会让整体频率明显变慢(随机值均值仍为中心,但最大值那一侧拉长了周期)。

    要突破 50 次/秒

    MouseClick 的 20ms 是硬上限。要更快,拆成按下、松开两步自己控制间隔:

    -- 约 500 次/秒;实际受设备回报率限制(最高 1K)
    while true do
        MouseDown(1)
        Delay(1)
        MouseUp(1)
        Delay(1)
    end
    

    注意两点:

    1. 回报率是天花板。设备最高支持 1K(1000Hz),即最小间隔 1ms。写 Delay(0) 也不会比这更快。
    2. 很多程序接不住这么快的点击。GUI 程序一般一次点击要 16ms 以上才处理得完,超出的会被合并或丢弃。频率高不等于有效点击多,实际调的时候以「目标程序真的响应了」为准。

    一个实用的调试办法

    不确定实际频率是多少时,让脚本自己报数:

    local start = GetUpTime()
    local count = 0
    
    while count < 100 do
        MouseClick(1)
        Delay(30)
        count = count + 1
    end
    
    local cost = GetUpTime() - start
    Log("100 次实际耗时 %d ms,平均 %d ms/次", cost, cost // 100)
    

    在软件里点「运行Lua脚本」,输出窗口会打出真实数字。这是唯一能确认「你以为的频率」和「实际频率」是否一致的方法,比拿秒表数强。


  • A

    剪辑里最机械的一段是「切、删、移、再看一遍」。一个三分钟的片子切两百刀,每刀都是同样三个动作。这段可以交给宏。

    Premiere:切一刀 + 波纹删除

    Pr 里最常用的一对操作是「添加编辑」和「波纹删除」——前者在播放头位置切开素材,后者删掉前一段并让后面的素材自动前移。

    -- 在播放头位置切一刀,然后删掉前一段
    KeyDown("lctrl")
    KeyTap("k")               -- 添加编辑
    KeyUp("lctrl")
    Delay(180)                -- 切点渲染,给足
    
    KeyDown("lshift")
    KeyTap("delete")          -- 波纹删除
    KeyUp("lshift")
    Delay(180)
    

    延时为什么给到 180ms:Pr 的「添加编辑」会重绘时间轴上的切点,切点没渲染完就发删除,可能删到整段素材而不是前一段。这类「改结构」的操作,延时按渲染时间给,不按按键响应时间给。

    批量:连切 N 刀

    配合「方向键逐帧 + 切」可以做成一个重复动作。下面这段每次前进 15 帧切一刀,连续 20 次:

    local STEP_FRAMES = 15
    local CUT_COUNT = 20
    
    for i = 1, CUT_COUNT do
        for f = 1, STEP_FRAMES do
            KeyTap("right")
            Delay(12)
        end
        KeyDown("lctrl")
        KeyTap("k")
        KeyUp("lctrl")
        Delay(160)
    end
    

    逐帧用方向键,Delay(12) 就够——时间轴的光标移动是本地操作,不涉及渲染。但 Ctrl+K 之后要等 160ms。

    先拿 3 刀试。 刀具节奏和素材长度必须匹配,切多了要撤销几十次,比手动还慢。

    剪映:分割 + 删除

    剪映专业版的快捷键与 Pr 不完全一致,常用的两个是 Ctrl+B 分割、Delete 删除:

    KeyDown("lctrl")
    KeyTap("b")               -- 分割
    KeyUp("lctrl")
    Delay(150)
    
    KeyTap("delete")
    Delay(120)
    

    剪映在低配机器上响应比 Pr 慢,延时建议整体上浮 50–100ms。判断标准很简单:在你自己机器上,动作不丢就是够,偶尔丢一次就是不够。

    时间轴缩放:让切点落在可点位置

    时间轴缩得太开,一刀要看半天;缩得太紧,切点对不准。Pr 里 + / - 缩放时间轴:

    -- 缩放到能看见整段,再放大两档精修
    KeyDown("backslash")      -- \ 缩放到序列全长(Pr 默认)
    KeyUp("backslash")
    Delay(200)
    
    KeyTap("equals")          -- + 放大
    KeyTap("equals")
    Delay(120)
    

    = 键在多数键盘上就是 + 的位置(不按 Shift)。脚本里写 equals,HID 码 0x2E。

    一条完整的「粗剪一个片段」

    -- 粗剪:前进 2 秒 → 切 → 波纹删 → 重复 10 次
    -- 前提:播放头已停在要开始的帧上;出问题按 Ctrl+Z 逐次撤回
    
    for i = 1, 10 do
        -- 前进 2 秒(25fps 约 50 帧)
        for f = 1, 50 do
            KeyTap("right")
            Delay(10)
        end
    
        KeyDown("lctrl")
        KeyTap("k")
        KeyUp("lctrl")
        Delay(160)
    
        KeyDown("lshift")
        KeyTap("delete")
        KeyUp("lshift")
        Delay(160)
    end
    
    ReleaseAllKeys()
    

    几个必须注意的点

    1. 撤销是唯一的兜底。 批量删除是不可逆的(Pr 的撤销栈有深度限制)。跑之前先存盘,跑的时候盯着,出问题立刻 Ctrl+Z。宏里没法「判断删对没删对」——它看不见时间轴。

    2. 焦点必须在时间轴上。 这些快捷键(尤其 Delete)在项目面板、效果面板里的含义完全不同。触发前先点一下时间轴区域,或者把「点击时间轴」写进宏的第一步。

    3. 别用宏做需要判断的剪辑。 「把每段静音部分剪掉」这种需要看波形的活,宏做不了。它能做的是「按固定间隔切固定刀数」,仅此而已。

    4. 帧率要算进去。 上面用「方向键次数」表示时间,是因为一格 = 一帧。25fps 下 50 格 = 2 秒,60fps 下 50 格只有 0.83 秒。换项目帧率了,步进次数要跟着改。


  • A

    修图和绘图里真正磨时间的不是「画」,是画之前那一串准备动作:切图层、调笔刷、复位色板、回到 100%、点回画布某个位置。这些动作顺序固定,正好是宏的活。

    把笔刷调到固定大小

    笔刷大小是相对的——[ 缩小、] 放大,每次一个档位,但你不知道当前在哪一档。想要每次都得到同一个大小,办法是先归零再步进:

    -- 先把笔刷压到最小,再放大 5 档
    for i = 1, 40 do
        KeyTap("lbracket")      -- [ 缩小
        Delay(8)
    end
    
    for i = 1, 5 do
        KeyTap("rbracket")      -- ] 放大
        Delay(8)
    end
    

    多按几下缩到最小是安全的,到底之后继续按不会有副作用。这样「5 档」就是一个确定的尺寸,不依赖触发前的状态。

    复位色板与切换前景背景

    D 把前景 / 背景复位成黑 / 白,X 交换两者。这两个键在修图里按得极多:

    -- 回到黑前景 + 白背景
    KeyTap("d")
    Delay(30)
    

    把它做成一个宏,绑在顺手的位置,比每次去按键盘省事——尤其你一只手正握着笔的时候。

    图层的常规三连

    -- 复制当前层 → 新建组 → 把副本放进组里
    KeyDown("lctrl")
    KeyTap("j")               -- 复制图层
    KeyUp("lctrl")
    Delay(150)
    
    KeyDown("lctrl")
    KeyDown("lshift")
    KeyTap("n")               -- 新建图层
    KeyUp("lshift")
    KeyUp("lctrl")
    Delay(400)                -- 会弹对话框,等它出来
    

    注意最后那个 Delay(400):Ctrl+Shift+N 在 Photoshop 里会弹新建图层对话框,对话框没出来就继续发按键,后面的动作会打到画布上。凡是会弹窗的操作,延时都要按「等窗口渲染」给。

    如果只是想跳过对话框,用 Ctrl+Shift+Alt+N(无对话框新建图层),延时可以降到 100ms 以内。

    坐标定位:把点击落到画布上的固定位置

    ScreenSize(1920, 1080)    -- 声明脚本参照的分辨率
    MoveMouse(960, 540)       -- 移到屏幕正中
    Delay(50)
    MouseClick(1)
    

    ScreenSize 声明的是脚本的设计分辨率。实际屏幕不是这个尺寸时,坐标会按比例换算:

    实际位置 x = 设计 x × 实际宽 / 设计宽
    实际位置 y = 设计 y × 实际高 / 设计宽
    

    注意 y 那一行用的是设计宽做分母——这是文档里写明的换算公式,不是笔误。分辨率比例和 16:9 差得远时(比如 16:10 的屏),y 会偏。这种情况直接把 ScreenSize 改成实际分辨率更省事。

    Mac 上的一个坑:系统会丢弃与上一次完全相同的移动事件。连续两次 MoveMouse 到同一个点,第二次不生效。解决办法是加一点微抖:

    MoveMouse(960, 540)
    MoveMouseBy(1, 0)
    MoveMouseBy(-1, 0)
    Delay(50)
    MouseClick(1)
    

    来回 1 像素,视觉上看不出来,但事件不再重复。

    一条完整的准备序列

    把上面几段拼起来,就是「开始画之前」的一键准备:

    -- 画前准备:复位色板、笔刷归零到 5 档、回到 100% 视图、点回画布中心
    KeyTap("d")
    Delay(40)
    
    for i = 1, 40 do
        KeyTap("lbracket")
        Delay(8)
    end
    for i = 1, 5 do
        KeyTap("rbracket")
        Delay(8)
    end
    
    KeyDown("lctrl")
    KeyTap("1")               -- 100% 视图
    KeyUp("lctrl")
    Delay(200)
    
    ScreenSize(1920, 1080)
    MoveMouse(960, 540)
    MoveMouseBy(1, 0)
    MoveMouseBy(-1, 0)
    Delay(50)
    

    几个提醒

    • Photoshop 的快捷键可以用自定义工作区改掉。如果你改过,脚本里的键位要跟着改,否则就是「在别人的电脑上能用、在我这儿乱按」。
    • 弹窗类操作(新建、导出、保存为 Web)延时必须给足,宁可多给 200ms。
    • 涉及 Ctrl+Z 的兜底:图层类操作一旦串了,撤销是最快的恢复手段,脚本注释里写清楚。

  • A

    快捷键序列是宏最本分的用法:一个动作要按四次组合键、还得按固定顺序,那就把它压成一次。

    基本结构:按住、敲、松开

    宏里的组合键不能写成 Ctrl+C 这种字符串,要拆成三步:

    KeyDown("lctrl")
    KeyTap("c")
    KeyUp("lctrl")
    

    KeyTap 本身没有独立的底层动作,它就是三条子命令的组合:

    写法 实际执行
    KeyTap("c") KeyDown("c") → Delay(20) → KeyUp("c")

    所以上面三行等于「按住 Ctrl,敲一下 C,松开 Ctrl」——那 20ms 的按下-松开正好夹在 KeyDown 与 KeyUp 之间,Ctrl 全程没被松开过。这也是组合键必须写成三段式的原因:真正让两个键同时处于按下状态的是 KeyDown 和 KeyUp 的位置,不是 KeyTap。

    一个容易想错的地方:KeyTap 传多个参数是逐个串行点击,不是同时按下。

    KeyTap("a", "b")   -- a 按下 → 20ms → a 松开 → b 按下 → 20ms → b 松开
    

    两个键从不同时按住,总耗时 40ms 起,键越多叠得越多。要两个键同时按住,用 KeyDown("a", "b");KeyTap 的多参数只在「连续敲几个键」时才有意义。

    修饰键必须先按下、后松开,中间夹目标键。写成 KeyTap("c") 然后 KeyTap("lctrl") 是无效的——那是先打了 c 再按了一下 Ctrl。

    一个真实例子:整列搬到另一张表

    Excel 里常见的动作序列:选中当前列 → 复制 → 切到另一个表 → 定位 → 粘贴。

    -- 选中整列(Ctrl + 空格),复制
    KeyDown("lctrl")
    KeyTap("spacebar")
    KeyUp("lctrl")
    Delay(60)
    
    KeyDown("lctrl")
    KeyTap("c")
    KeyUp("lctrl")
    Delay(120)             -- 复制到剪贴板需要时间,别省
    
    -- 切换到下一个工作表
    KeyDown("lctrl")
    KeyTap("pagedown")
    KeyUp("lctrl")
    Delay(250)             -- 切表比一般操作慢,给足
    
    -- 跳到 A1 并粘贴
    KeyDown("lctrl")
    KeyTap("home")
    KeyUp("lctrl")
    Delay(60)
    
    KeyDown("lctrl")
    KeyTap("v")
    KeyUp("lctrl")
    

    延时怎么给

    这张表是按「目标软件的响应速度」排的,不是按理论值:

    动作 建议延时 原因
    普通快捷键 60–80ms 界面刷新一帧就够
    复制 / 剪切 100–150ms 剪贴板写入是异步的
    切换工作表 / 标签页 200–300ms 整页重绘
    打开对话框 300–500ms 等窗口出来再输入
    保存 / 导出 800ms 以上 磁盘 IO,不可控

    原则:给接收方的耗时永远比你估计的长。宁多给 50ms(人感觉不出来),也不要少给导致动作串到上一个状态上。

    ReleaseAllKeys 什么时候用

    它释放所有键盘按键。用在这些场合:

    1. 宏结束前兜底。万一中间某步异常退出,修饰键会一直处于按下状态,用户感觉到的是「Ctrl 粘住了」。脚本末尾加一行 ReleaseAllKeys() 可以避免。
    2. 两种操作模式之间切换。前一段是「按住 Shift 连续点」,后一段是纯点击,中间清一次状态比较干净。
    -- 末尾兜底
    ReleaseAllKeys()
    

    它不需要参数,也不会有副作用——没有按下的键,调用它什么也不做。

    配合场景切换用

    一套宏通常不止一个用途:白天办公、晚上别的用途。10 个场景就是为这个准备的。

    • 每个场景可以配自己的切换快捷键,纯硬件切换(不经过电脑软件);
    • 场景互相独立,同一个键在不同场景可以绑不同的宏;
    • 偏好页里可以给场景命名,只存在本地,方便自己认。

    所以「办公宏」和「其他宏」不用挤在一个剧本里靠 if 判断,直接分场景更干净。

    三个容易忽略的细节

    1. 目标窗口必须先获得焦点。 宏只发按键,不切窗口。如果触发时焦点在别的程序上,这一串按键就全打到别的程序里了。要么手动先点一下,要么把「点击目标窗口」写进宏的第一步(MouseClick 到窗口标题栏)。

    2. 中文输入法会吃掉字母键。 输入法处于中文状态时,KeyTap("c") 可能变成候选词输入。涉及字母键的序列,在脚本开头把输入法切到英文,或者要求使用者在触发前切好。

    3. 撤销是最好的兜底。 序列里某一步没生效,后面的动作会作用在错误状态上,可能产生难以回退的后果(比如批量删除了内容)。在开头的注释里写清「出问题按 Ctrl+Z 撤回」,比任何代码都实用。


  • A

    地址、邮箱、公司抬头、客服模板句、报税编号——这些内容每次都要一个字一个字敲,是办公场景里最典型的浪费。TypeText 就是干这个的。

    基本写法

    -- 把常改的部分提到最前面
    local ADDRESS = "北京市海淀区中关村大街 1 号 A 座 1201"
    
    TypeText(ADDRESS)
    

    编译期它会被展开成一串按键动作——TypeText 不是运行时逐个字符打出来的,而是编译时就把文本编码成 Alt + 小键盘(或 Option + HEX)序列。这一点决定了它的适用范围,后面细说。

    Windows:默认 GBK,用 Alt + 小键盘

    TypeText("你好")                -- 等价于 mode="gbk"
    TypeText("你好😀", "unicode")   -- Emoji 走 Unicode 码点
    
    • GBK 覆盖常用汉字,编码短、按键次数少;
    • Emoji、生僻字、日文假名之外的特殊符号,GBK 编不了,必须显式给 "unicode"。

    前提条件,三条缺一不可:

    1. 小键盘可用。Alt + 小键盘数字是靠 num0–num9 打的,笔记本没有独立小键盘、NumLock 关着的,全部打不出来;
    2. 输入法处于英文 / 直连状态。中文输入法开着的时候,Alt + 数字可能被输入法截走;
    3. 目标程序接受 Alt 组合键。极少数程序把 Alt 当菜单键,会在输入过程中弹出菜单栏。

    macOS:默认 Unicode,用 Option + HEX

    TypeText("你好")   -- 等价于 mode="unicode",展开为 Option + HEX
    

    用之前必须先在 系统设置 → 键盘 → 输入法 / 输入源 里启用并切换到 Unicode Hex Input。

    macOS 不支持 mode="gbk"——GBK 机内码输入属于 Windows 输入体系,在 Mac 上没有对应机制。

    长度:这是最容易踩的坑

    因为编译期展开,文本长度直接换算成按键次数。一个汉字在 GBK 下是 2 字节,每个字节展开成「Alt + 4 位数字 + 松开」,大约 6 次按键动作。

    粗算一下:

    文本长度 大致按键动作数 实际耗时
    10 个汉字 约 120 次 1–2 秒
    50 个汉字(一段地址) 约 600 次 6–10 秒
    500 个汉字(一篇文章) 约 6000 次 一分钟以上,且极易被目标程序截断

    所以:

    • 适合:地址、邮箱、模板句、编号、十几到几十个字的内容;
    • 不适合:整段落、整篇文章。真要批量输入正文,用系统的输入法自定义短语或者剪贴板,不要用 TypeText。

    超过 100 字就该重新想方案了。

    一个实用的组合:替换而不是追加

    输入前先全选,能保证结果是替换而不是拼在后面:

    local TEMPLATE = "您好,您反馈的问题我们已收到,会在 24 小时内处理。"
    
    KeyDown("lctrl")
    KeyTap("a")
    KeyUp("lctrl")
    Delay(80)              -- 等目标程序完成全选
    TypeText(TEMPLATE)
    

    Delay(80) 这一步不要省。全选是异步的,紧接着就输入,前面几个字符可能打进旧选区。

    现场排查

    现象 原因
    打出来是一串数字,不是文字 小键盘 NumLock 关着,或输入法处于中文状态
    只有前几个字进去,后面丢了 目标程序有输入长度或速率限制,把 TypeText 拆成几段、中间加 Delay
    弹出了程序菜单 目标程序把 Alt 当菜单键,换用剪贴板方案
    Emoji 变成问号或方块 没给 "unicode",GBK 编不出来
    Mac 上完全没反应 没切到 Unicode Hex Input 输入源

    什么时候不该用它

    如果目标是「把一段固定内容填进某个字段」,还有一个更省事的思路:能不能让目标软件自己读取? 比如表格的自动填充、Word 的自动图文集、输入法的自定义短语。这些方案不占宏时长,也不受输入法状态影响。

    宏的价值在于跨软件、跨界面、目标程序没有现成功能时的那一下。能用软件自带功能解决的,优先用自带功能。


  • A

    第一个宏不要做复杂的东西。这篇用最基础的「连点 10 次、每次隔 50 毫秒」走完全流程,五个步骤每一步都能看到结果,走完你就知道这套东西是怎么转的了。

    第 0 步:先确认手上有什么

    打开 → 关于,记下两个东西:

    • 软件版本 / 固件版本——以后所有求助帖都要写这个;
    • 设备标识号(右键可复制)。

    插上盒子,状态栏第一栏应该是已连接。如果是红的,先解决连接,别往下走。

    第 1 步:写

    主界面 → 宏编辑。默认三栏,某栏不见了就贴着窗口边缘往外拖。

    • 左栏是宏目录,右键可以新建文件夹 / 新建宏 / 重命名;
    • 中栏是编辑器,脚本写这里;
    • 右栏是函数说明,输入关键字就能查。

    先在左栏右键新建一个宏,命名 learn-click10,然后在中间写:

    -- 连点 10 次,每次间隔 50 毫秒
    for i = 1, 10 do
        MouseClick(1)
        Delay(50)
    end
    

    MouseClick(1) 的 1 是左键(1 左 / 2 右 / 3 中 / 4 侧后 / 5 侧前),Delay 单位是毫秒。

    这时脚本还不能跑,得先让编译器看一眼。

    第 2 步:编译

    点工具栏第一个按钮(编译)。

    • 下方输出窗口没报错 = 语法通过;
    • 报错了会指到行,照着改。常见的是 end 少一个、for 后面漏了 do。

    编译只查语法,它不执行任何东西。

    第 3 步:在软件里跑一遍

    点工具栏第二个按钮(运行Lua脚本)。

    鼠标会开始动——注意提前把光标放到安全位置,这一步是真的在点。10 次点完脚本自己结束。

    一个必须记住的前提:软件里跑通,不代表硬件里一致。软件侧是把脚本解释执行,硬件侧是编译成字节码后在盒子上跑,速度更快,链路不同。验证阶段的意义是「流程对不对」,手感对不对要烧录后才知道。

    第 4 步:绑定

    切到 宏绑定 页。三个下拉决定这个宏什么时候响:

    下拉 选什么 说明
    设备类型 键盘 / 鼠标 选的是插在盒子上的那个设备,不是你手上按的那个
    触发按键 键盘可绑全部 HID Usage 键,鼠标支持五键 弹出列表后可以直接敲键盘快速选中
    触发类型 按下触发 / 松开触发 / 按下触发松开中断 决定「什么时候开始」和「什么时候停」

    左边列表是当前场景(共 10 个场景,可各自配切换快捷键)。点列表左下角添加,选中刚写的 learn-click10 加进来,然后配上面三个下拉。

    这里有一个最容易踩的坑:设备类型必须和实际插的设备一致。插的是鼠标却把快捷键配成键盘组合键,切换不生效——不是坏了,是它压根没收到。

    第 5 步:烧录与验证

    点宏绑定列表上的第二个按钮(烧录)。这一步把配置写进硬件,之后即使不装软件、不插电脑到原机,盒子插上就能用。

    验证:

    1. 把设备插到盒子上(不要直插电脑);
    2. 按你绑定的那个键;
    3. 状态栏第二栏变绿 = 宏在执行,红 = 没跑。

    跑起来了,第一个宏就成了。想改参数,回来改脚本 → 编译 → 重新烧录,三步。

    五个容易卡住的地方

    1. 停不下来。 默认终止键是 ESC。如果你插的是小键盘或鼠标,ESC 可能按不到——去 偏好 → 宏中止按键,配一个手边有的键。这一步建议在第一次烧录前就做。

    2. 烧完没反应。 按顺序查:设备类型对不对 → 触发键对不对 → 触发类型对不对 → 场景对不对(10 个场景互相独立,你可能在别的场景里)→ 烧录到底成没成功。

    3. 一插设备软件就卡死 / 加载超时。 这是「自动加载宏」把大量宏一次性读进来造成的。处理办法:拔掉设备 → 进偏好把自动加载宏取消勾选 → 插回设备 → 烧录 → 清空所有绑定的宏。恢复后再一项项加回去。

    4. 宏执行时按键没反应。 不用慌,这是设计如此:宏按键无冲,宏在跑的时候你仍然可以正常打字,不需要等它结束。

    5. 手感忽快忽慢。 单次 Delay 误差小于 1ms,但宏的整体节奏还受目标软件响应速度影响。给接收方留出处理时间,比把延时调精确更有效——具体见《延时精度与宏时长预算》。

    下一步


  • A

    这一系列帖子讲的是在硬件里跑的 Lua 宏脚本——脚本由键鼠助手编译成字节码烧进盒子,之后脱机执行,盒子插上就生效,不需要开着电脑上的软件。

    动笔之前先说清楚边界,省得你照着写完一篇再发现方向不对。

    这套东西擅长什么

    一句话:把「一串固定的键盘鼠标动作」压成一次按键。

    它只做输出,不看屏幕、不读内存、不判断游戏状态。所以它适合的场景有个共同特征——下一步该按什么,你事先就知道:

    • 输入一段固定的长文本(地址、模板、代码片段);
    • 重复点同一个位置(软件界面里的批量操作);
    • 一串有固定顺序的快捷键(软件里的组合操作);
    • 按固定节奏连续点击(点住不放的场景)。

    反过来,凡是需要「看到什么再决定按什么」的,它做不到。比如「血量低于 30% 自动喝药」「看到敌人自动开枪」——这类需要读取游戏状态,硬件盒子没有这个能力,任何声称能做到的脚本都是在骗你。

    什么不做

    面向联机对战游戏的一切脚本。 包括后坐力补偿、自动连发、快速切枪、自动瞄准、连跳。这条没有例外。

    两个原因:

    1. 硬件盒子的输入由独立 HID 设备发出,反作弊读不到进程——它绕过的正是公平竞技赖以成立的那道检测。同局其他玩家不知道自己面对的不是人。
    2. 这类脚本的寿命以补丁周期计。参数依赖当版本的武器后坐力、灵敏度、FOV、DPI、倍镜倍率,任一变化就失效。写出来三个月就废。

    单机、离线、游戏自带训练场的场景可以讨论,那是另一回事——没有第三方玩家受影响。这类脚本会明确标注适用范围,见《单机游戏宏的边界:能做什么、不能做什么》。

    发脚本的格式

    标题写清楚做什么,不要写「求助」「大佬看看」:

    ✅ 一键输入收货地址(含 Unicode 模式说明)
    ✅ 按住左键连发 15 次/秒,松开停止
    ❌ 求助!!急!!
    

    正文至少包含四样:

    项 说明
    用途 一句话说清这个宏触发后会发生什么
    版本 软硬件版本(关于页可查,如 5.13 / 固件 x.x)
    触发方式 绑在哪个键、哪种触发类型(按下 / 松开 / 按下触发松开中断)
    脚本 用 lua 代码块,参数写成变量放开头,别散在正文各处

    模板:

    **用途**:在地址栏输入公司收货地址
    **版本**:键鼠助手 5.13
    **触发**:鼠标侧后键,按下触发
    **前提**:Windows,默认 GBK 模式
    
    ```lua
    -- 地址文本,改这里就行
    local ADDRESS = "北京市海淀区……"
    TypeText(ADDRESS)
    ```
    

    提问的格式

    三样缺一样都很难帮上:

    1. 你想让它做什么;
    2. 它实际做了什么(现象,不是「不行」);
    3. 脚本原文 + 编译输出窗口的原文。

    编译能过但硬件不动作,多半不在代码里——先看《编译通过但设备不动作:排查清单》,那五条能解决大部分。

    一个必须记住的前提

    Delay 的误差小于 1ms,但那是单次延时的精度。一个宏里叠二十次延时,累积误差和软件响应时间才是实际手感。

    另外:软件里跑通不等于硬件里一致。软件侧是解释执行,硬件侧是字节码在盒子上跑,链路不同。写完先点「运行Lua脚本」验证流程,最终以烧录后的实测为准。


  • ?
    此主題已被删除!

    没有把键盘插入键鼠助手,程序根本不会走到主要逻辑中,键盘灯判断完全无效
  • A

    「加个图形化编程页麻烦吗?」

    这是 10 月 20 日中午我收到的一句话。当时的回答是:不麻烦,但得先看清手里有什么——因为图形化编辑器最容易做成的样子,是画得挺好看、生成出来的脚本跑不了。

    两天之后,它长这样:块可以拖、可以拼、能撤销、能复制粘贴、能按 Ctrl 滚轮缩放,切回文本模式看到的就是块生成的规范化脚本,编译、校验、保存、烧录全部复用原来的链路。

    键鼠助手 5.0 的图形化编程界面:左侧宏目录,右侧块画布

    成品:左边是宏目录,右边是块画布。中间那段 当 … 执行 是容器块,条件由值块拼成(count 小于 3 且 鼠标是否按下 1),下面跟着延时、赋值、移动、点击,最后一段是自定义函数 on_timer1 的定义块。

    这篇文章记录这两天的实际过程:做了哪些决定、踩了哪些坑、时间花在哪。文末有一张按开发日志回填的时间账。


    一、先别写代码,先盘点

    动手之前先回答一个问题:这个「Lua 宏」到底是不是 Lua。

    盘完的结论是——不是。它是一个封闭的小 DSL,解析器同时支持两套方言:

    • Lua 风格(对外文档化的语法):local x = v、if..then..elseif..else..end、while..do..end、for i=a,b,step..do..end、function f(p)..end、do..end、return、break、-- 注释;
    • 遗留 BASIC 风格(老脚本兼容):If/Then/EndIf、While/Wend、For/Next、Sub/End Sub、Dim、Goto、Rem、Call、Exit Sub。

    内置能力面是两张静态表:15 条命令 + 9 个函数,每条都带分类、参数模式、参数种类、参数个数上下限、说明文本。

    这个盘点值钱的地方在于它直接给出了方案:块调色板不用手写,可以从命令表派生;而唯一的缺口是 AST → 文本生成器(unparser),得新写。

    盘点还顺手圈出一条红线:内置函数的编号是编译器按命令表声明顺序写进字节码的 uint16 操作数,只能在表末尾追加,不能插入或删除。所以图形化这一层绝不能碰编译链路,它只能是「块树 → 文本 → 原有 parser/compiler」的上面一层。

    一个决定性的判断:图形化只是入口,不是新引擎。这个边界守住了,后面所有工作都只在一个 UI 模块里发生,设备端字节码、VM、函数编号零改动。

    二、第二条决断:不塞 Web 引擎

    做块编辑器最省事的路是塞一个 Web 引擎进去,跑现成的 Blockly。这条路被否掉了,理由很实际:

    • 安装包会凭空涨几十兆,启动慢一截;
    • 多一个运行时的版本问题(Qt WebEngine 的 Chromium 更新、显卡驱动兼容);
    • 复制粘贴、字体渲染、高分屏缩放全部隔着两层,和原生控件的行为对不齐。

    于是决定:原生 Qt 自绘,视觉和几何照 Blockly 移植。代价是每一根连接齿、每一段圆角都要自己算;收益是这套东西完全可控——后来做缩放时,「所有几何都在逻辑坐标里」这件事能成立,正是因为画布是我自己的。

    三、布局和绘制必须分开

    一开始是很朴素的一层:一个函数量尺寸、一个函数画。很快就撞墙了——插入线要落点、命中测试要知道点到哪个参数、内嵌的编辑框要贴到某个字段上,这些全都要「尺寸从哪来」。

    所以最终分成三层:

    层 职责 为什么不合并
    block_render_info 纯几何与文案,算出一棵布局树 命中测试、插入线、内嵌控件几何全都复用它,不能只有绘制时才存在
    block_drawer 只按布局树画,不改任何状态 绘制无副作用,缩放时才能只换一个变换矩阵
    block_render_constants 齿高、圆角、行高、内衬这些形状常量 改一版视觉只动一处

    撞墙的具体形态是「凹凸连接件不吻合」:上一版齿的曲率半径和缺口对不上,块叠起来有一条白缝。最后是对着参考实现的源码逐段校正几何参数才解决——这也是第一天晚上 20:25 那条日志的由来。

    右侧的块目录直接复用了同一套绘制代码,所以「面板里长什么样」和「拖进画布后长什么样」不会有第二份实现:

    右侧块目录:每个条目就是一个缩小的块,带参数名与说明

    块目录的条目不是截图,也不是另画的示意图——它调用的是画布那套 block_render_info + block_drawer,只是画在一个小画布上。

    四、真相只能有一个

    命令表原本只有一个 displayName,那是文本模式里真实可键入的调用名,不能改。但块面上要显示中文名,右侧目录也要中文名。

    一开始的写法是在块的渲染里硬编码一套中文。这套东西立刻就脱轨了:同一个命令,块面上叫「按下按键」,目录里叫「按下」,诊断里又叫「按键按下」。改一处,另两处不知道。

    改成:命令表上加一个 chineseName,块面、目录、提示共用;文本模式继续用 displayName。一处声明,三处消费。

    同样的思路后来用在表达式上,而且更极端:

    • 槽里的文本是唯一真相,AST 是它的一次投影,槽文本变了才重建;
    • 拖一个值块进来,是替换子树,不是往字符串里追加。

    第二条是血的教训。最早为了省事,「把函数拖进条件槽」实现成往槽的文本里拼字符串,结果 a + 1 拖两次变成 a + 1 + 1,而且撤销回去再看,表达式树已经和文本对不上了。结构化之后这类问题整类消失:拖拽只发生在树的两颗子树之间,文本只是它的输出。

    五、剪贴板:不要用文本当中间格式

    Ctrl+C / Ctrl+V 的第一版想法很自然:把选中的块生成脚本文本,粘贴时再解析回来。这条路走不通,因为文本层丢了信息:

    • 「可选参数槽未启用」和「槽里是空的」在文本里长得一样;
    • if 分支的启用状态、被折叠的分支,文本表达不了;
    • 往返一次,块的类型信息(哪一段是用户子程序调用、哪一段是自定义函数)就退化成函数名。

    于是剪贴板走的是「整棵块树序列化」:自定义 MIME 类型 application/x-kma-blocks,内容是 JSON,带格式版本号。同时副带一份等价脚本文本——这样粘到记事本里也讲得清,从纯文本粘回来时走 parser 兜底,至少不会丢得莫名其妙。

    一个可以复用的结论:块的复制粘贴不要走「块 → 文本 → 块」。文本是给人看的产物,不是传输格式。

    六、那圈看不见的选中框

    多选本身不难:按住 Ctrl 点一下切换选中,选中集合是个保序去重的数组,主选中恒等于第一个(粘贴位置、调色板新块都跟着它)。真正的坑在「看不见」。

    选中框最初用的是主题的高亮色。逻辑上完全正确——主题换肤自动跟随。但在浅色主题下,那个高亮是淡蓝的 1px 细线,压在蓝色的块体上,肉眼几乎无法分辨。用户反馈是「按了 Ctrl 点,不知道有没有选中」。

    最后改成固定配色:外圈琥珀 3px,内圈深棕 1px 做内衬,深浅主题下都压得住。教训是主题色不等于可见色,选中这种强反馈的视觉不要交给定主题去决定。

    七、缩放:所有几何只能有一套坐标系

    这是整个两天里最值得写的一段。

    缩放最直觉的做法是「把所有尺寸都乘一下系数」。这么做会在三个地方同时崩:命中测试、拖拽落点、内嵌编辑框的位置。因为一旦有两套坐标,任何一处忘了换算,就是「看着点在 A 上、选中了 B」。

    所以定了一条规矩:布局、命中、拖拽,全部在逻辑坐标里算;缩放只作用在两个入口——绘制的 QPainter::scale(),和把鼠标位置换算成逻辑坐标的那一个函数。这条规矩守住之后,缩放本身变得很简单。

    真正难的是那些「看起来该跟着缩,但其实不能缩」的东西:

    • 布局宽度取视口宽度,且与缩放无关。这条是「真缩放」和「只改字号」的分界线。如果布局宽度写成「视口宽 ÷ zoom」,那缩放只是在改字号,块永远不会横向溢出,也就永远不需要横向滚动;
    • 内嵌的输入框和下拉框是子控件,不缩放。所以既要按缩放换算它们的位置和尺寸,又要按缩放调字号,两处都得乘;
    • 滚动条的单位是逻辑像素。滚到一半改变缩放时,要先记住「当前视口顶端的逻辑坐标」,重排之后按这个锚点恢复,否则内容会突然跳走。

    滚轮以光标为锚点缩放,也是同一个套路:算出光标下的逻辑点,缩放后反解出新的滚动偏移,让那个点停在原地。

    再加两条写进代码注释的自我约束:

    • 布局逻辑宽度有下限(560),窗口极窄时不至于把块挤成一条竖线;
    • 缩放范围 40%~300%,一格 1.15 倍。连续滚动是乘方关系,所以是平滑的,一格一档也不会跳。

    八、两个让我半夜还在查的 bug

    1. 300% 缩回 100% 直接崩:0xC00000FD

    现象是必崩:放大到 300% 再缩回 100%,进程退出码 0xC00000FD——栈溢出。

    原因很朴素:refreshLayout() 末尾调了 resize(),而 resize() 会同步回调 resizeEvent,回调里又调 refreshLayout()。放大时内容尺寸单调增长,递归很快就耗尽了栈。

    修法是加一个重入闸(refreshing_),进入布局就先置位、退出再复位,回调进来直接返回。

    值得说的是为什么它没被测出来:早期的截图测试窗口尺寸是固定的,缩放也只在同一个尺寸内做,递归深度刚好没到阈值。是「在真实窗口里来回缩」这个动作把它逼出来的,不是断言。

    2. 一个测试程序完全没有输出

    另一个更折磨人:新写的缩放测试程序一启动就死,连 main 第一行的 printf 都没有。

    排查绕了很久,最后是靠「第一行都没打印」这个线索反推的——不是逻辑崩,是进程在第一次输出之前就没了。罪魁是这一行:

    std::setvbuf(stdout, nullptr, _IOLBF, 0);
    

    想把 stdout 改成行缓冲,size 传了 0。这在 MSVC 的 CRT 里会直接把进程打死。给一个真实缓冲区就好了。

    记录下来是因为这条非常有欺骗性:现象是「程序什么都不做就退出」,看起来像链接错了、像静态初始化崩了、像 Qt 插件找不到,唯独不像一行日志相关的调用。

    九、回归测试搬回仓库

    这套东西的正确性没法靠眼睛看——块的几何、命中、嵌入、撤销,随便改一行都可能悄悄坏掉。之前这些验证散在构建目录下的临时程序里,改一次代码要手工找一遍入口。

    这次把它们收进仓库,做成一件可重复的事:

    • 一份用例清单是唯一真相(类型 | 可执行文件 | 模式 | 最少断言数 | 参数形式 | 说明),两个平台的脚本共读同一份;
    • 三种类型:断言型(12 个,判定依据)、冒烟型(7 个,只要求不崩)、截图型(8 个,默认不跑,出图人工比对);
    • 最少断言数是必需的防御:模式名写错会走到默认分支静默返回 0,看起来「通过」,其实是没跑;
    • 两个平台各一个脚本,退出码统一:0 全通过 / 1 有用例失败 / 2 环境或构建失败。失败不中断,最后统一汇总。

    跑通的结果是 19 通过 / 0 失败 / 8 跳过,截图模式 8/8 出了 18 张图。

    跨平台脚本这部分,坑比功能代码还多:

    坑 表现 处置
    批处理文件存成 UTF-8 中文 Windows 上按系统代码页逐行解析,行边界错乱,报「xxx 不是内部或外部命令」 存成 ANSI/GBK
    用 for /f 读 UTF-8 清单 中文重配对把分隔符吞掉,整行被静默跳过(用例凭空少三条) 先按 UTF-8 读、只取纯 ASCII 列,生成工作清单
    用 find 计数 PATH 里装了 GNU find,/c 被当成 C 盘递归扫描,CPU 打满 计数交给专用脚本
    shell 里 kill -0 判存活 僵尸进程仍然返回成功,每条用例都等满超时 改判进程状态里的 Z

    十、148 处硬编码文案

    最后一件收尾的事:英文界面下,块编辑器整片是中文。因为绘制层是命名空间里的自由函数,没有 QObject,拿不到 tr(),所以文案全是硬编码字面量。

    处置分两步:

    1. 造一个只有 tr() 的壳类(Q_DECLARE_TR_FUNCTIONS),上下文固定,调用点统一写 BlockText::tr(...)。148 处字面量批量替换,只换函数名,跨行拼接的参数原样保留;替换前先确认这些字面量没有一处参与比较、持久化或生成脚本——否则翻译会让脚本跟着变语言。
    2. 重扫翻译文件、补齐译文、重新生成 .qm。结果是两边各 478 条、0 条未完成。

    顺带发现两件事值得写下来:

    • 旧翻译文件严重滞后,中文界面此前有一部分实际显示的是英文(表格列名、设备类型这些)。这次一并补上;
    • 提取工具必须一次给全量源目录。只对单个目录跑,工具会把其余 478 条判成「已废弃」直接删掉——我被清空过两次,靠备份才恢复。这是那种「操作成功、结果正确、数据没了」的典型。

    十一、时间账

    下面这张表是按开发日志的推进节点回填的,不是秒表计时,误差大概在半小时量级。所谓「一轮」= 一次完整的改→编→验证→截图确认。

    日期 时段 内容 轮数
    10-20 12:35 起约 45 分钟 盘点 DSL、定边界、确认唯一缺口 —
    10-20 下午约 4.5 小时 块模型 / 文档 / 画布 / 页面 + AST 转文本 1
    10-20 傍晚约 2.5 小时 视觉移植:C 形嘴部、齿形吻合、块上直改 3
    10-20 晚间约 2.5 小时 渲染层按参考源码逐段校正、拖动、撤销重做 3
    10-21 上午约 2 小时 表达式结构化:值块、且/或/非、取负、拖放替换 5
    10-21 中午约 3.5 小时 对齐、分隔条、右栏分类、形态开关、值块选中 5
    10-21 下午约 2.5 小时 定位、右键分流、死按钮、图标定稿 4
    10-21 晚间约 3.5 小时 剪贴板、多选、缩放 3
    10-21 21:00–22:30 回归整合 + 两个平台的一键脚本 1
    10-21 22:30–23:10 文案翻译收尾 1
    合计 两个工作日,净投入约 24 小时 约 25 轮

    产出的体量:33 个文件、+10617 / −539 行。其中纯功能代码大概占七成,剩下是测试、翻译资源和文档。

    如果把时间按性质拆开,比例大概是这样:

    类别 占比 具体是什么
    写功能 ~55% 模型、布局、绘制、交互、表达式
    排障 ~20% 栈溢出、隐式共享深拷贝、坐标没换算
    构建与验证 ~15% 编译、跑回归、看截图、来回缩
    测试与文案 ~10% 用例、脚本、翻译

    十二、回头看

    真正花时间的从来不是「把块画出来」。画块是第一天的下午就完成的事。

    耗时间的是三件事:

    1. 坐标系。只要有两套坐标,就一定会有一处忘了换算。把它压到一套,缩放从「到处乘以系数」变成了两个入口的改动。
    2. 真相只有一个。块的文案、槽的文本、剪贴板的格式,每一处都有「省事的双份实现」诱惑,而每一处双份最后都脱轨了。
    3. 验证要能重复。改一行就可能悄悄坏掉的模块,靠眼睛看是靠不住的;把验证做成一条命令,才有勇气去动第二十五轮。

    至于「两天」这个数字——它更像两天 × 大约十二小时,中间还有不少时间花在等编译和重跑回归上。真要说有什么经验,是那条最初的红线救了整件事:图形化只是入口,不碰编译链路。守住这条线,才敢在两天里迭代二十五轮。


    本文涉及客户名称、内部路径、内网地址与版本标识的细节已做脱敏处理。


  • ?

    kma_1k_v5.12.bin这个文件怎么用


    更新之后键鼠插上去有效了,谢谢
  • ?

    之前:编译了一个死循环宏,并运行。

    目前:软件无法打开,双击点开之后没有窗口弹出来,右下角任务栏有图标出现,但是鼠标移上去图标就消失了。

    已尝试:

    ①重装

    ②重启

    ③在另外一台电脑可以正常使用


    用户反馈: 宏执行死循环卡住,删掉目录 C:\Users[替换为你的用户名]\AppData\Local\MindFinger 就好了; 也可以尝试从任务管理器强制退出键鼠助手,再重新打开.
  • A

    这篇说明 5.20 版本新增的内置函数 GetUpTime():宏脚本里第一个「读时间」的接口。
    它没有参数,返回设备开机以来经过的毫秒数,用来计量耗时、给动作做绝对时间对齐。

    相关: 键鼠助手 5.0 资源汇总:主程序 / 文档 / 配套工具下载

    一句话用法

    local t = GetUpTime()   -- 单位毫秒,整型;返回值一般只用来算差值
    

    接口说明

    函数 参数 返回值 说明
    GetUpTime() 无 整型 设备开机以来经过的毫秒数

    几点需要说清楚:

    • 不是「当前时间」:它是「开机以来的时长」,设备上电时从 0 开始,不表示几点几分,也不是时间戳。它的用途是算差值。
    • 单位是毫秒,返回值是整型:脚本里 math.type(GetUpTime()) 得到 integer,可以直接参与加减乘除与比较。
    • 分辨率 1 毫秒:设备内部按更细的步长计数,换算成毫秒时向下取整,所以相邻两次调用可能返回同一个值。
    • 不会溢出:毫秒计数是 64 位整数,连续开机到溢出需要以「亿年」计,正常使用无需关心。
    • 大小写不敏感:GetUpTime() 与 getuptime() 是同一个函数,和 IsKeyDown / iskeydown 的规则一致。
    • 它是「读时钟」,不是「等待」:调用本身几乎不耗时、不会阻塞宏;要等一段时间请用 Delay(毫秒)。

    在电脑上先调好再上机:两种环境的时间原点不同

    同一个 GetUpTime(),在两个地方跑,时间原点不一样:

    运行环境 时间原点 典型用途
    编辑器 →「脚本校验」 本次校验开始的时刻 在电脑上先确认脚本的节奏与耗时
    设备(真机) 设备本次上电的时刻 真实的宏执行计时

    所以不要跨环境比较绝对数值(电脑上的 1200 和真机上的 1200 不是一个起点),只比较同一个环境内的差值。

    用法一:测量一段宏的耗时

    取两次时间戳相减,就能知道中间这段动作真实花了多久 —— 排查「宏为什么比预期慢」时很有用。

    local t0 = GetUpTime()
    
    KeyTap("a")
    Delay(300)
    KeyTap("b")
    
    Log("这一段耗时 %d ms", GetUpTime() - t0)
    

    Log 的首个参数带 %d 时按 printf 格式化,数字会原样打印出来,便于对照。

    用法二:用绝对时间对齐,避免 Delay 累积误差

    连续多次 Delay(500) 时,每一步自身的执行耗时会让整体越走越慢,误差逐次累加。
    改用「目标时刻」判断,就能把每轮的落点重新拉回时间轴上:

    -- 执行 4 轮,每轮之间间隔 500ms,落点分别对齐到 500 / 1000 / 1500 / 2000ms
    local t0 = GetUpTime()
    for i = 1, 4 do
        KeyTap("f")
        local target = i * 500
        while GetUpTime() - t0 < target do
            Delay(10)   -- 小步让出,别用空转等待
        end
    end
    

    要点:等待循环里一定要有 Delay(小值),不要把 while 写成不带 Delay 的紧凑空转。

    用法三:把宏做成固定的节拍

    需要「每 1 秒做一件事、共 5 次」这类节奏时,用时间戳做判断比用 Delay 堆叠更稳:

    local last = GetUpTime()
    local count = 0
    while count < 5 do
        local now = GetUpTime()
        if now - last >= 1000 then
            last = last + 1000      -- 以理论落点累加,不丢节拍
            KeyTap("space")
            count = count + 1
        end
        Delay(10)
    end
    

    last = last + 1000(而不是 last = now)能让误差不累积:即使某轮判定晚了一点,下一轮的落点仍然回到原来的时间轴上。

    版本要求与兼容性

    组合 结果
    5.20 软件 + 配套固件 正常使用
    5.20 之前的软件 编译不通过:GetUpTime 会被当成未定义的函数
    5.20 软件 + 更早的固件 宏在设备上执行到该函数时会失败中断(不会静默返回 0)

    所以升级软件时,请把固件一并升到配套版本。软件与固件的版本对应关系,参考资源汇总帖里的说明。

    还是有问题?

    在本帖下回复,写清楚:软件版本(关于页的 Software version)+ 固件版本 + 你脚本里调用 GetUpTime() 的那几行 + 现象。


  • A

    这篇是给刚拿到键鼠助手 4.0 的朋友准备的:第一次打开软件报缺 DLL、文档和视频去哪找、
    读不出固件信息、硬件宏保存失败 —— 这几类情况基本都能在下面找到答案。装机前建议先扫一遍。

    相关: 键鼠助手 4.0 资源汇总:主程序 / 宏编程文档 / SDK 与示例工程 / 常用工具下载

    使用需知

    首次打开提示「找不到 CH375DLL64.DLL」

    第一次打开软件时,如果弹出“由于找不到CH375DLL64.DLL,无法继续执行代码。重新安装程序可能会解决”,请安装软件包中的程序 CH372_DRIVER.exe

    • CH375DLL64.DLL 是沁恒 CH372 / CH375 系列 USB 芯片的动态库,缺它就说明驱动还没装,不是软件损坏,也不用重装主程序。
    • 处理方式:运行 CH372_DRIVER.exe(以管理员身份)完成驱动安装,再重新打开主程序即可。
    • 下载:CH372_DRIVER.exe(346 KiB,资源汇总帖里的「驱动程序」一项)。
    • 这是个沁恒 CH372 / CH375 的驱动安装包:内含 CH375DLL.dll / CH375DLL64.dll 两个动态库与 CH375WDM 系列驱动文件,装完建议重启一次再打开主程序。

    先查《键鼠助手--使用指南.chm》

    《键鼠助手--使用指南.chm》(4.0的使用基本一样),有问题可以先查找一下,常见问题都可以找到答案,LUA相关接口使用请查看键鼠助手4系列视频教程。

    • 遇到功能上的疑问,先翻这本 chm,绝大多数常见问题里面都有;它是按 3.0 系列写的,但 4.0 的用法基本一致,可以直接对照。
    • Lua 接口部分不在这本 chm 里,去看「键鼠助手 4 系列视频教程」。
    • 本版块下载帖目前提供的是《键鼠助手软件宏编程文档.pdf》(Lua 函数说明,18 页),chm 尚未上传;需要的话可以补上来。

    新手开箱视频

    新手开箱视频:【键鼠助手4.0--新手使用指南及特性概要-哔哩哔哩】 https://bilibili.com/video/BV1CKqSYkEeo/

    读不出固件信息时,别强行追新版本

    当使用最新软件无法查看固件信息时,请使用与固件配套的软件版本进行固件升级,升级完后请使用与固件配套的软件。

    • 软件版本与固件版本之间有配套关系,不是越新越好 —— 新软件读不出老固件的固件信息属于版本不匹配,而非硬件故障。
    • 正确顺序:换成与该固件配套的软件版本 → 升级固件 → 升级完继续用这一配套版本的软件,不要再跳到最新版。

    硬件宏无法保存

    无法保存硬件宏时,把程序文件夹放桌面,然后使用管理员权限运行程序

    • 把整个程序文件夹挪到桌面(或任何普通用户有写权限的位置),再右键主程序选「以管理员身份运行」,然后重试保存。
    • 常见诱因是程序放在受保护目录、C:\Program Files 下被 UAC 拦写,或软件本身没被授予写入权限。

    无线版本接收器固件已开源

    无线版本键鼠助手接收器开源地址:https://github.com/magicsunflower/kma_receiver.git

    还是没解决?

    1. 先确认用的软件版本与固件是否配套(见上面「读不出固件信息」那条);
    2. 再确认是否以管理员身份运行、程序目录是否有写权限(见「硬件宏无法保存」那条);
    3. 仍不行的话在本帖下回复,说明软件版本 + 固件版本 + 系统版本 + 具体报错,方便定位。

  • A

    键鼠助手 4.0 的全部资源集中在这里:主程序(Windows v4.52)与驱动程序(缺 CH375DLL64.DLL 时装的那个)、Lua 宏编程文档、C/C++ 二次开发头文件与两个 VS2019 示例工程,
    以及调试工具和常用第三方工具。每个条目都写清了适用平台、包内内容和注意事项,按需下载即可。有任何问题欢迎在本帖下回复。

    QQ售后群:970335093

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

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

    下载清单

    # 分类 文件名 平台 大小
    1 主程序 KMA_Software_v4.52_release.zip Windows 64 位 16.83 MiB
    2 驱动程序 CH372_DRIVER.exe Windows(32 / 64 位) 346.23 KiB
    3 说明文档 键鼠助手软件宏编程文档.pdf 全平台通用 544.87 KiB
    4 二次开发 · 头文件 kma_api .h 跨平台(C++) 8.55 KiB
    5 二次开发 · 头文件 kma_api_c_wrapper.h 跨平台(纯 C 接口) 4.10 KiB
    6 二次开发 · 示例工程 kma_api_demo_vs2019.zip Windows / Visual Studio 2019 79.50 MiB
    7 二次开发 · 示例工程 kma_demo_vs2019_UI_20250919.zip Windows / Visual Studio 2019 105.99 MiB
    8 调试工具 move_algorithm.exe Windows(命令行) 178.32 KiB
    9 调试工具 键鼠测试.html 任意现代浏览器 8.23 KiB
    10 第三方工具 Wireshark-4.2.3-x64.exe Windows 64 位 82.37 MiB
    11 第三方工具 WCHISPTool_Setup (1).exe Windows 19.42 MiB
    12 第三方工具 向日葵_15.3.0.62055_x64.exe Windows 64 位 43.66 MiB
    13 第三方工具 大漠综合工具.zip Windows 8.66 MiB

    主程序

    KMA_Software_v4.52_release.zip

    键鼠助手 4.0 的 Windows 完整发布包(KMA Software v4.52,本版起内置升级服务器地址换成 https://us.byteohm.com,老版本升级到本版后自动生效),解压即用。主程序是 键鼠助手4.exe,另有 按键映射.exe 与更新器 updater.exe;包里同时带了 Qt 6 运行库、烧录用 ch375.dll,以及做二次开发要用到的 kma_api_x64_shared.dll。

    • 版本:KMA Software v4.51,Windows 64 位解压即用(不需要安装)
    • 主程序 键鼠助手4.exe:宏绑定、Lua 宏编辑、编译烧录、场景切换
    • 附带工具:按键映射.exe(按键重映射)、updater.exe(软件升级)、tools/7z.exe(7z 解压工具,普通用户无需理会)
    • 二次开发件:kma_api_x64_shared.dll(动态库;静态库与 .lib 本版不再随包附带)
    • 依赖件:Qt6Core/Gui/Widgets/Network/Svg.dll、ch375.dll(CH375 USB 通信库,烧录固件时要用),以及 platforms/、imageformats/、styles/、tls/ 等 Qt 插件子目录
    • 本版为精简发布包:不再附带 vc_redist.x64.exe、opengl32sw.dll、d3dcompiler_47.dll、translations/ 与调试版运行库,包体由 53.55 MiB 缩到 16.83 MiB

    下载 KMA_Software_v4.52_release.zip(16.83 MiB)

    注意事项

    • 解压后请整目录使用,不要只把 exe 单独拷出来 —— Qt 运行库必须与程序在同级目录,platforms/、imageformats/ 这些插件子目录也要一起保留,否则启动即报错退出。
    • 包内不再附带 vc_redist.x64.exe;若提示缺少 VCRUNTIME140.dll、MSVCP140.dll,请自行到微软官网安装 VC++ 2015–2022 x64 运行库。
    • 首次运行 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.52_release.zip,整目录解压后双击 键鼠助手4.exe;
    3. 写脚本时可用 键鼠测试.html 确认按键是否被正确识别,需要抓协议层再上 Wireshark;
    4. 要在自己的程序里控制设备,就看 kma_api.h / kma_api_c_wrapper.h,配合两个示例工程改;
    5. 确认可用后再把宏烧录进硬件。

  • A

    键鼠助手 5.0 的全部资源集中在这里:主程序(Windows / macOS)、使用文档和两个配套小工具。
    每个条目都写清了适用平台、内容和注意事项,按需下载即可。有任何问题欢迎在本帖下回复。

    QQ售后群:1106405642

    下载清单

    # 分类 文件名 平台 大小
    1 主程序 KMA_Software_v5.32_release.zip Windows 10 及以上,64 位 49.96 MiB
    2 主程序 KMA_5.20_Release.dmg macOS 62.04 MiB
    3 说明文档 键鼠助手 5.0 使用文档.md 全平台通用 26.52 KiB
    4 配套工具 键盘鼠标事件录制工具.exe Windows 176.00 KiB
    5 配套工具 鼠标定位.exe Windows 56.00 KiB

    主程序

    KMA_Software_v5.32_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.32(本版起内置升级服务器地址换成 https://us.byteohm.com,老版本升级到本版后自动生效);新增图形化块编辑器(拖块即可写宏);GetUpTime() 等 5.20 起的内置函数用法见 5.20 用法帖
    • 本版为精简发布包:不再附带调试版运行库(*d.dll)、Qt 翻译文件、.pdb 与 tools/ 打包脚本

    下载 KMA_Software_v5.32_release.zip(49.96 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(26.52 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. 测试通过后再点到键鼠助手里烧录到硬件。

  • A

    为维护清朗网络空间,保障社区健康有序,依据《中华人民共和国网络安全法》《互联网信息服务管理办法》《网络信息内容生态治理规定》等法律法规,本社区严禁发布以下内容:

    一、涉黄低俗
    色情、淫秽、低俗、性暗示信息,以及任何涉及未成年人的不良内容。

    二、危害国家安全
    反对宪法确定的基本原则;危害国家安全、荣誉和利益;煽动颠覆国家政权、分裂国家、破坏民族团结;泄露国家秘密。

    三、暴力恐怖
    宣扬恐怖主义、极端主义;煽动民族仇恨、宗教极端与暴力行为。

    四、违法犯罪
    赌博、毒品、枪支弹药、管制刀具、危险化学品等违禁品的传播与交易;传授犯罪方法。

    五、谣言与虚假信息
    编造、传播虚假信息,扰乱社会秩序或社区秩序。

    六、侵权与欺诈
    造谣诽谤、侵犯他人隐私与名誉;诈骗、传销、非法集资。

    七、违规广告导流
    未经许可的商业广告、拉群导流、刷单返利、外链推广。

    八、人身攻击
    辱骂、歧视、骚扰、恶意引战。

    处理办法
    违反以上规定的,视情节轻重给予删帖、警告、禁言、封禁账号等处理;涉嫌违法犯罪的,依法向有关部门报告并移送司法机关。

    本规范自发布之日起施行。