跳转至内容
  • 键鼠助手 Lua 宏脚本合集 · 目录

    已固定 键鼠助手5.0 新手指引 脚本教学
    1
    0 赞同
    1 帖子
    32 浏览
    A
    这个版块里目前有 23 篇宏脚本相关的帖子。版本更新后这个目录会同步维护,按下面的顺序读最省时间。 第一次用,从这里开始 写在前面:这些脚本怎么用、什么不该做 — 这套东西擅长什么、什么不做,先看这篇 从零到烧录:五步做出第一个宏 — 编辑 → 编译 → 运行 → 绑定 → 烧录 → 验证 脚本基础 不读懂这几篇,后面所有脚本都只能照抄不能改。 Lua 语法速查:这套脚本到底是不是 Lua — 与标准 Lua 的六处差异,数组下标从 0 开始是最大的坑 内置函数与 HID 键码对照表 — 15 条命令 + 9 个函数 + 全部键码,可查表 延时精度与宏时长预算 — 「误差小于 1ms」到底意味着什么,宏实际耗时怎么算 调试三件套:编译、验证、Log — 报错怎么读、软件验证与真机的差异 图形化编程 不想写代码也能做宏,和文本模式是同一份脚本的两种看法。 图形化块编程入门 — 8 组块、三种放入方式、一个完整例子 块编辑器的操作细节 — 多选、复制、撤销、条件分支追加、缩放 按场景用 一键输入常用长文本:TypeText 的两种模式 — 地址、模板、编号;GBK 与 Unicode 的区别 把一串重复操作压成一次按键 — 组合键序列,以及延时该给多少 Photoshop 高频操作宏:图层、笔刷、定位 — 笔刷归零到固定档位、坐标定位 剪辑软件的时间轴宏:Pr 与剪映 — 切一刀 + 波纹删除,批量粗剪 可控频率连点器:从死循环到带抖动 — 频率到底怎么算,MouseClick 的 20ms 天花板 按住连发与三种触发方式的组合 — 选错触发方式是「宏不生效」的高频原因 单机游戏 仅限单机 / 离线 / 自带训练场,不涉及任何联机对战。 单机游戏宏的边界:能做什么、不能做什么 — 先看这篇,边界在这里 重复采集与刷素材的循环宏 — 四段式循环、参数化、分批执行 连招与技能循环的时间轴写法 — 时间轴、抖动、长按型技能的处理 设备与排错 编译通过但设备不动作:排查清单 — 按五条顺序查,能解决大部分问题 常见报错与处理 — 编译期、运行期、连接、崩溃四类 设备识别、固件更新与恢复 — 版本信息、自动加载宏的坑、烧录失败排查 USB 协议自定义:VID/PID 与字符串描述符 — 改 ID 的用途与风险 键盘采样:让盒子认识你那把键盘 — 把键盘描述符采进盒子,之后以它的身份出现 无线接收器重绑与格式化 — 重绑是安全的,格式化不是 几个通用提醒 改完脚本要重新烧录。 只点「编译」不烧录,硬件里跑的还是旧版本——这是最高频的「明明改了却没生效」。 软件里跑通不等于硬件里一致。 软件侧解释执行,硬件侧是字节码在盒子上跑。 while true 之前先配好终止键。 默认是 ESC,插小键盘或只用鼠标的话可能按不到。 遇到问题先看第二栏。 按下触发键,状态栏第二栏变绿说明宏在跑,问题在输出端;不变绿说明触发没进来。这一条能把排查范围砍掉一半。
  • 调试三件套:编译、验证、Log

    键鼠助手5.0 脚本教学 调试方法
    1
    0 赞同
    1 帖子
    4 浏览
    A
    宏编辑器里只有三个调试手段:编译、运行(验证)、Log。用好这三个,大部分问题不用猜。 编译:只查语法,不执行 工具栏第一个按钮。它做的事就一件:把脚本解析成语法树,看能不能过。 过了 → 不代表逻辑对,只代表写得出合法语句; 没过 → 输出窗口会指向出错的行。 编译阶段能发现的:括号不配对、end 少了、for 后面漏 do、用了不存在的函数名、字符串引号没闭合。 编译阶段发现不了的:变量算错、延时给少了、按键绑定错了、目标程序没响应。 常见报错与含义: 报错大意 大概率原因 意外的 end / 缺少 end 容器块(if / while / for / function)嵌套没闭合 意外的符号 xxx 用了不支持的语法,比如 elseif 写成了 else if 未知函数 xxx 函数名拼错,或者这个能力本设备不支持 字符串未闭合 引号少了一半,或者字符串里有引号没转义 验证:真执行,但是在电脑上 工具栏第二个按钮(运行Lua脚本)。它会真的执行:鼠标会动,键会按。 用途是验证流程对不对,但有三件事必须清楚: 它在电脑上跑,不是盒子。软件侧是解释执行,硬件侧是编译成字节码后在设备上跑。链路不同,时序表现可能不一样。 执行前把光标放到安全位置。它是真的在点,点在什么地方就是什么地方。 验证通过 ≠ 硬件可用。这是最常见的误判来源:软件里跑得好好的,烧进去不动。 Log:唯一能看到内部状态的东西 Log("count=%d", count) Log("name=%s", name) Log("hello", 1, "world") -- 没有格式符时按空格分隔 规则:首个参数含 %d / %s / %f 等格式符时按 printf 走,否则按空格分隔打印。两种模式别混用: Log("count=%d and", count, "more") -- 容易错位,别这么写 类型要对应:%d 对整数、%s 对字符串、%g 对浮点。cost / 100 是浮点,用 %d 会打出奇怪的值。 输出在编辑器下方的输出窗口 / 状态栏第三栏,软件验证时可见。 一套实际的定位流程 脚本「有动作但结果不对」时,按这个顺序切: 第一步:缩小到最小可复现脚本。 把出问题的那一段单独剪出来,前面加上必要的初始状态,跑一遍。能复现,问题就在这段里。 第二步:二分注释。 一段 20 行的脚本,把后 10 行注释掉(--),跑。看前半段是不是对的。对 → 问题在后半段;不对 → 问题在前半段。重复三次就能锁定到 2–3 行。 第三步:在关键位置插 Log 看状态。 local count = 0 while count < 5 do Log("loop start count=%d", count) MouseClick(1) Delay(50) count = count + 1 Log("loop end count=%d", count) end 如果 Log 打出来的次数不对,问题在循环条件;如果次数对但动作不对,问题在循环体。 第四步:区分「代码问题」和「环境问题」。 在脚本里加一行固定的动作,比如开头先 KeyTap("a"): 如果连这个固定动作都没执行 → 代码根本没跑起来(触发方式、场景、烧录); 如果这个动作执行了,后面的没有 → 代码问题或者延时不够。 几个反复出现的坑 Log 打不出东西。 先确认是在软件里验证,不是在硬件上跑。硬件端没有输出窗口。 脚本执行到一半停了。 检查是不是按了终止键(默认 ESC),或者中途触发了别的宏。也可能是目标程序弹了模态窗口把输入吞了。 同样的脚本,今天能跑明天不能。 检查场景是不是被切走了;或者绑定的触发键被别的软件占用了。 改了脚本但行为没变。 改完要重新编译、重新烧录。只编译不烧录,硬件里跑的还是旧版本——这是最高频的「明明改了却没生效」。
  • 延时精度与宏时长预算

    键鼠助手5.0 脚本教学 延时精度
    1
    0 赞同
    1 帖子
    9 浏览
    A
    「延时误差小于 1ms」这句话经常被误读成「这个宏的时间是精确的」。这两件事差得远。这篇把时间到底花在哪算清楚。 单次精度不等于整体精度 Delay(50) 的真实含义是:这一条延时指令执行 50ms,单次误差小于 1ms。 但一个宏的时间里还有别的东西: 宏总时长 = Σ Delay 值 + Σ 命令固有耗时(KeyTap / MouseClick 内部各含一条 Delay(20)) + Σ 单次误差(每条 <1ms,会累积) + 通讯与调度开销(设备端执行,微秒级,可忽略) 「命令固有耗时」这个说法容易让人以为是额外开销,其实它就是一条 Delay:KeyTap(k) 展开为 KeyDown(k) → Delay(20) → KeyUp(k),那 20ms 是写死在里面的延时;MouseClick 同理。所以它能被算进 Σ Delay 值,只是这条延时不是你写的、也改不了。要别的间隔就别用 KeyTap,自己写成三段式。 一段 100 次的连点,每次 MouseClick + Delay(30): 项 计算 结果 Delay 总和 100 × 30 3000ms 点击固有 100 × 20 2000ms 累积误差 200 条指令 × <1ms 最多 200ms 总计 约 5.2 秒 你以为写的是 3 秒,实际 5.2 秒。差的 2.2 秒全在 MouseClick 里——那 20ms 是写死在命令里的,改不了。 什么时候累积误差会咬人 单条 <1ms 听起来没问题,但它是每条指令的误差,不是整个脚本的。 10 条指令:最多 10ms,感觉不出来; 200 条指令:最多 200ms,在「按键要跟手」的场景里已经能被察觉; 2000 条指令(比如 TypeText 输入长文本):误差可以到秒级。 所以:长宏不要指望靠精确延时对齐外部事件。真要同步,靠目标软件的反馈(比如等窗口出现再继续),而不是靠算时间。 预算表:给多少算够 按「目标软件多久能处理完上一个动作」来给,不按按键响应给: 场景 建议 说明 同软件内连按 30–60ms 界面一帧(16ms)加余量 跨软件切窗口 200–300ms 窗口激活 + 重绘 等待弹窗出现 300–500ms 窗口渲染不可控 复制 / 粘贴 100–150ms 剪贴板异步 打开文件 / 导出 800ms 起 磁盘 IO 网页加载完再输入 1500ms 起 网络不可控 宁可多给。 多给 50ms 人感觉不出来;少给 20ms 就可能把动作打到上一个状态上,产生难以回退的结果(比如删错内容)。 用 GetUpTime() 实测 不要猜,量一下: 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,平均 %.1f ms/次", cost, cost / 100) Log 的 %d 对 64 位整数有效;cost / 100 是浮点除法,用 %.1f 保留一位小数。 在软件里点「运行Lua脚本」,输出窗口会打出真实数字。如果实测比预算多出一大截,说明中间某条命令比你以为的慢——通常是目标程序在忙。 硬件端与软件端的差异 GetUpTime() 在两个环境里含义不同: 编辑器里验证时:从本次校验开始计时; 烧录后在硬件上跑:从设备开机起计时。 所以脚本里如果直接用 GetUpTime() 的绝对值做判断(比如「超过 5000 就停」),在硬件上会立刻成立——因为设备可能已经开机好几分钟了。只能用它算差值,不能用来算绝对值。 手感调优的经验 调到「手感对」通常不是把延时压到最小,而是找到那个「不丢动作的最小值」: 先给足(比如全部 150ms),确认动作全部正确; 每次减 20ms,跑 10 遍,看有没有丢; 出现丢动作就回退一档,定为最终值; 换个机器或换个软件版本重测——同一套延时在不同机器上结论会变。 最后一条很重要:宏的时间参数和机器性能绑定。给别人分享脚本时,把延时写成开头的变量,注明「在我的机器上这个值够用,你的机器可能需要加」。
  • 内置函数与 HID 键码对照表

    键鼠助手5.0 脚本教学 函数表
    1
    0 赞同
    1 帖子
    5 浏览
    A
    这套脚本的全部能力就是下面两张表:15 条命令 + 9 个函数。没有别的。想确认某个操作能不能做,先在这两张表里找;找不到就是做不到,网上的教程再花哨也没用。 一、键鼠命令 命令 参数 说明 KeyDown(key, ...) HID Usage 整型或按键名,最多 16 个 按下按键。多个参数表示同时按下,可组成组合键 KeyUp(key, ...) 同上 松开按键 KeyTap(key, ...) 同上 点击按键 = KeyDown + Delay(20) + KeyUp,参数逐个串行 ReleaseAllKeys() 无 释放所有键盘按键 MouseDown(button) 1 左 / 2 右 / 3 中 / 4 侧后 / 5 侧前 按下鼠标键 MouseUp(button) 同上 松开鼠标键 MouseClick(button) 同上 点击,按下与松开间隔 20ms MoveMouse(x, y) 整型坐标 移到屏幕绝对坐标,配合 ScreenSize 使用 MoveMouseBy(x, y) 整型增量 相对当前位置移动 ScrollMouse(click) -128 ~ 127 滚轮,正数向上、负数向下 TouchScreen(is_touched, x, y) 0/1, x, y 触摸屏按下 / 松开,坐标配合 ScreenSize KeyTap 和 MouseClick 里的 20ms 不是隐藏参数,就是它们内部那条 Delay(20): KeyTap(k) = KeyDown(k) → Delay(20) → KeyUp(k),MouseClick(b) = MouseDown(b) → Delay(20) → MouseUp(b)。 所以想要别的间隔,别去调这两个命令,直接用三段式写,Delay 填多少就是多少。 另外 KeyTap 多个参数是逐个按下-松开,不是同时按下。 二、延时与其他 命令 参数 说明 Delay(ms) 整型,毫秒 延时,误差小于 1ms Log(arg, ...) 任意类型,最多 16 个 首个参数含 %d/%s/%f 时按 printf 格式化,否则空格分隔输出 ScreenSize(w, h) 整型宽高 声明脚本参照分辨率,默认 1920×1080 TypeText(text, mode) 字符串;gbk / unicode 输入文本,编译期展开为按键序列 三、状态查询与数学 函数 参数 返回 IsKeyDown(key) HID Usage 或键名 该键当前是否按下 IsMouseDown(button) 1–5 该鼠标键当前是否按下 IsLockKeyOn(key) "capslock" / "numlock" / "scrolllock" 锁定键是否亮着 GetUpTime() 无 运行时长(毫秒,64 位)。设备端为开机以来,编辑器里为本次校验以来 math.type(v) 任意 "integer" 或 "float" math.tointeger(v) 浮点 恰为整数时转成整数,否则返回 0(不是 nil) math.round(v) 整数或浮点 四舍五入,.5 远离零取整 math.abs(v) 整数或浮点 绝对值,保持子类型 math.random(m, n) 整型 [m, n] 闭区间随机整数 四、组合键:两种写法 KeyDown 支持多参数,可以一次按下多个键: -- 写法 A:分开按 KeyDown("lctrl") KeyDown("lshift") KeyTap("n") KeyUp("lshift") KeyUp("lctrl") -- 写法 B:一次按下(等价,更短) KeyDown("lctrl", "lshift") KeyTap("n") KeyUp("lctrl", "lshift") 两种都行。写法 B 的参数顺序不影响结果,松开时顺序也不影响。但按下的与松开的键必须对得上——按了三个只松两个,剩下的会一直粘着,表现是「Ctrl 卡住了」。脚本末尾加 ReleaseAllKeys() 可以兜底。 五、HID 键码 键名直接写字符串就可以,不需要记码值。需要写码值的场合(比如用变量传参),用下面这套规律。 字母与数字:连续编码 范围 键码 换算式 字母 a–z 0x04 – 0x1D 0x04 + (字母序号),a=0,z=25 数字 1–9 0x1E – 0x26 0x1E + (数字 - 1) 数字 0 0x27 — 例:c = 0x04 + 2 = 0x06 = 6;5 = 0x1E + 4 = 0x22;w = 0x04 + 22 = 0x1A = 26。 常用特殊键 键名 码 键名 码 enter 0x28 escape 0x29 backspace 0x2A tab 0x2B spacebar 0x2C minus 0x2D equals 0x2E lbracket 0x2F rbracket 0x30 backslash 0x31 semicolon 0x33 quote 0x34 tilde 0x35 comma 0x36 period 0x37 slash 0x38 capslock 0x39 appkey 0x65 修饰键 键名 码 说明 lctrl 0xE0 左 Ctrl lshift 0xE1 左 Shift lalt 0xE2 左 Alt lgui 0xE3 左 Win / Command rctrl 0xE4 右 Ctrl rshift 0xE5 右 Shift ralt 0xE6 右 Alt 功能键与编辑键 键名 码 键名 码 f1–f12 0x3A – 0x45 printscreen 0x46 scrolllock 0x47 pause 0x48 insert 0x49 home 0x4A pageup 0x4B delete 0x4C end 0x4D pagedown 0x4E right 0x4F left 0x50 down 0x51 up 0x52 F1–F12 是连续的,f1 = 0x3A 起依次加一。 小键盘 键名 码 键名 码 numlock 0x53 numslash 0x54 numasterisk 0x55 numminus 0x56 numplus 0x57 numenter 0x58 num1–num9 0x59 – 0x61 num0 0x62 numperiod 0x63 六、几个容易记错的地方 equals 是 = 那个键,就是主键盘区 + 的位置(不按 Shift)。想按 + 要 KeyDown("lshift") 配 equals。 tilde 是 ` 那个键(数字 1 左边),不是 ~。 spacebar 不是 space。 appkey 的文档说明写的是「Left Ctrl」,这是文档笔误,码值 0x65 实际是菜单键。不确定就避开不用。 小键盘和主键盘的数字不是同一个键。num5 和 5 在程序看来完全不同——某些软件只认其中一个。
  • Lua 语法速查:这套脚本到底是不是 Lua

    已固定 键鼠助手5.0 脚本教学 Lua
    1
    0 赞同
    1 帖子
    14 浏览
    A
    先给结论:不是标准 Lua。 键鼠助手里的「Lua」是一个封闭的小语言——解析器只实现了一个子集,能用的命令和函数是两张写死的表(15 条命令 + 9 个函数)。它的语法长得像 Lua,是因为设计时刻意对齐了 Lua 5.3 的书写习惯;但内核、类型系统、标准库都不在。 这意味着:别拿网上任何一篇「Lua 入门教程」直接往里套。 这篇把「像什么」和「哪里不一样」分开写清楚,写完的脚本至少不会卡在编译上。 一、两套方言并存 解析器同时认两种写法: 方言 写法 用不用 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 老脚本兼容用,新脚本别写 两套不能混着嵌套。看到别人的脚本里出现 EndIf,那是老资产,不是你语法错。 二、数据类型 类型 字面量 说明 integer 10、0x04、0b0100 十六进制和二进制都认,0b0100 等于 4 float 2.5、1e3 1e3 是浮点 1000,不是整数 string "a" 文档里只出现过双引号写法 boolean true / false array Array(n)、StringArray(n, len) 容量在声明时定死 nil — 见下面第 3 条差异,行为需要实测 字符串变量 StringVar(n) 固定容量的字符串 数值遵循 Lua 5.3 的整数 / 浮点双类型规则,别的地方不一定这么讲究: local half = 7 / 2 -- 3.5,/ 永远是浮点除法 local whole = 7 // 2 -- 3,向下整除 local down = -7 // 2 -- -4,注意是向下取整,不是向零 local mod = -7 % 3 -- 2,floor 取模 local rem = 7 % 3 -- 1 -7 // 2 得 -4 而不是 -3,这是最容易算错的一行。 三、与标准 Lua 的六处差异 这六条是实际写脚本时会被绊住的地方,按踩坑概率排序。 1. 数组下标从 0 开始 标准 Lua 的数组从 1 开始,这里从 0 开始。 local nums = Array(5) nums[0] = 1 -- 第一个元素 nums[1] = 2 -- 第二个 nums[2] = nums[0] + nums[1] -- 3 把从网上抄来的 for i = 1, 10 套在长度 10 的数组上,会多读一个不存在的槽位。写循环时先想清楚边界是 0..n-1 还是 1..n。 2. 没有通用 table 标准 Lua 的 {} 构造器、#t 取长度、pairs / ipairs 遍历、table.insert 这些,文档里一条都没有,按不可用处理。 能用的容器只有三种: local nums = Array(5) -- 整数数组,5 个槽 local name = StringVar(16) -- 单个字符串变量 local names = StringArray(4, 16) -- 4 个字符串,每个 16 容量是写死的,运行时不会自动扩容。循环里往 Array(5) 写第 6 个元素,结果不可预期——按越界处理。 3. math.tointeger 失败返回 0,不是 nil 文档在数据类型表里列了 nil,但在 math.tointeger 的说明里又写「无 nil 类型,转换失败返回 0」。 local i1 = math.tointeger(7.0) -- 7 local i2 = math.tointeger(1.5) -- 0(不是 nil) 两处说法不一致,写代码时按「返回 0」处理更安全:转换失败和真的等于 0 无法区分,所以别把 math.tointeger 的返回值当判断依据。确定要判整数时用 math.type(v),它返回 "integer" 或 "float"。 4. 没有字符串库 string.format、string.sub、string.find、#s 取长度,文档里都没有。字符串能做的只有拼接: local text = "键鼠" .. "助手" .. " v1.0" 需要拼接数字时注意整数会变成十进制字面,小数部分按浮点规则;要控制格式,只能靠 Log 的 printf 风格参数输出到日志里看: Log("count=%d name=%s ratio=%g", 3, "键鼠助手", 1000 * 1.5) 但 Log 是输出,不返回字符串——不能拿它拼出格式化后的文本再 TypeText 出去。需要「输入格式化文本」时,只能把定值写死或分段 TypeText。 5. 0b 二进制字面量 0b0100 = 4。标准 Lua 5.3 不支持这个写法。写键码时用 0b 更直观,但换算成十进制或十六进制也一样,看个人习惯。 6. math.random 只有双参形式 local rnd = math.random(50, 100) -- [50, 100] 闭区间随机整数 文档只给了这一种形式,没有无参和单参版本。要模拟 0/1 就用 math.random(0, 1)。 四、控制语句 local count = 0 while count < 5 do count = count + 1 if count == 1 then -- 第一次 elseif count == 3 then -- 第三次 else -- 其它 end end for i = 1, 3 do if i == 2 then -- 跳过处理 end end function add(a, b) return a + b end local sum = add(2, 3) 注释用 --,只支持单行。 break 只能跳出最内层循环;嵌套循环要跳两层,得自己加标志变量逐层判断。 五、踩坑速查 现象 大概率原因 编译报 end 相关错误 容器块没闭合;for 后面漏 do,while 后面漏 do 数组读出来是 0 或者乱值 下标从 1 开始写了,或者越界 math.tointeger 结果不对 转换失败返回 0,被当成有效值用了 想 string.format 拼文本却编译不过 没有字符串库,改用 .. 拼接 循环次数比预期多一轮 0..n-1 与 1..n 混用 Log 输出看不懂 首个参数含 %d/%s/%f 时按 printf 走,不含则按空格分隔;两种模式混用容易错位 六、不确定的行为怎么确认 这套语言的文档只覆盖了「已实现且稳定」的部分,边界行为(比如 nil 到底能不能赋值、字符串容量超了会怎样)没有成文说明。 确认方法只有一条,但很有效: local v = math.type(nil) Log("type=%s", v) 编译 → 运行 → 看输出窗口。编译器通过 + 运行输出符合预期,才算确认;只有编译通过不算。 实测出新结论欢迎发到版块里,这类帖子比任何教程都有用——文档没写的地方就是靠这样一条条补出来的。