跳转至内容

键鼠助手5.0

31 主题 45 帖子

此版块可通过开放社交网络使用标识符 键鼠助手[email protected] 关注

  • 键鼠助手 Lua 宏脚本合集 · 目录

    已固定 新手指引 脚本教学
    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,插小键盘或只用鼠标的话可能按不到。 遇到问题先看第二栏。 按下触发键,状态栏第二栏变绿说明宏在跑,问题在输出端;不变绿说明触发没进来。这一条能把排查范围砍掉一半。
  • 编译通过但设备不动作:排查清单

    已固定 疑难解答 故障排查
    1
    0 赞同
    1 帖子
    8 浏览
    A
    「编译没报错,脚本在软件里也能跑,烧进去按了没反应。」 这是最多的一类问题,而且几乎都不是代码问题。按下面五条顺序查,基本能定位。 第 0 步:先看状态栏第二栏 按一下触发键,看第二栏有没有变绿。 变绿 → 宏在跑。问题在「输出打到了哪里」或「动作本身不对」,跳到第 6 条; 不变绿 → 触发没进来。继续第 1 条。 这一步能砍掉一半的排查范围,别跳过。 第 1 条:设备类型选错了 宏绑定页的「设备类型」选的是插在盒子上的那个设备,不是你手上按的那个。 盒子插的是鼠标,这里选「键盘」→ 不生效; 盒子插的是键盘,这里选「鼠标」→ 不生效。 判断依据:触发键属于哪个设备。用鼠标侧键触发,就选鼠标;用键盘某个键触发,就选键盘。 第 2 条:触发键选错了 键盘支持全部 HID Usage 键。弹出列表后可以直接敲键盘快速选中——想绑哪个键就按一下它; 鼠标只支持五键(左、右、中、侧后、侧前)。 常见的错:想绑「侧键」,结果绑成了「中键」;想绑 F5,结果绑成了 num5(小键盘和主键盘不是同一个键)。 第 3 条:触发类型不适合这个脚本 脚本类型 该选 一次性动作(输入文本、执行快捷键序列) 按下触发 持续动作(连发、按住循环) 按下触发松开中断 松开才执行的动作 松开触发 最典型的错:连发脚本 while true do ... end 绑了「按下触发」。这时脚本会一直跑下去,松手也不停(只能按终止键),用户会以为「卡住了」。反过来,一次性脚本绑了「按下触发松开中断」,手指一松就中断,动作只做了一半——也会被描述成「不动作」。 第 4 条:场景不对 10 个场景互相独立。你在场景 1 配的宏,切到场景 3 之后完全不生效。 看当前是哪个场景,以及场景切换快捷键有没有被误触。这是「昨天能用今天不能用」的最高频原因。 第 5 条:到底烧录成功了没 三种常见情况: 只编译没烧录。改完脚本 → 编译 → 就以为生效了。必须点宏绑定页的烧录,硬件里跑的是烧进去的那一版; 烧录时设备没连好。状态栏第一栏是红的,烧录不会成功; 烧的是另一个场景的配置。烧录是对当前场景生效的。 判断方法:改脚本里一个明显的参数(比如把连点次数从 10 改成 3),重新编译 + 烧录,看行为有没有变。没变说明烧录这一步没成功。 第 6 条:状态栏绿了但没效果 说明宏在执行,但按键没打到该去的地方,或者动作本身不是你想要的。 现象 原因 按键没反应,鼠标也没动 目标窗口没有焦点。宏只发按键,不切窗口 文字进去了,但全是数字 / 乱码 TypeText 的小键盘被 NumLock 关掉了,或输入法在中文状态 按键变成了别的功能 目标软件改过快捷键;或者用了小键盘键而软件只认主键盘键 动作做了一半就停 延时给少了,后续动作被前一步的未完成状态吞掉 触发了两次 触发键被宏自己按到了(自我触发),换一个不冲突的键 第 7 条:终止键的问题 默认终止键是 ESC。如果你插的是小键盘或者只用鼠标,ESC 可能根本按不到——脚本跑起来之后停不下来,表现是「一直动」。 去 偏好 → 宏中止按键,换一个手边有的键。写 while true 循环之前,这一步必须做。 还没解决 按这个顺序再试一遍: 重启软件,重新插设备。排除状态问题; 换一个最简单的脚本(就一行 KeyTap("a"))烧进去试。能用 → 问题在原脚本;不能用 → 问题在设备或绑定; 关闭自动加载宏,清空所有绑定,从头加一个宏。排除历史配置污染(见《设备识别、固件更新与恢复》); 换一个 USB 口直插,不经 Hub。 到这里还不行,去发帖,把这五项写全: 软件版本 / 固件版本: 设备类型:键盘 or 鼠标 触发键 + 触发类型: 场景编号: 脚本原文 + 编译输出: 现象:第二栏变绿吗?目标窗口是什么软件? 这五项写全,问题基本一眼能看出来。只写「不能用」的帖子,谁也帮不上。
  • Lua 语法速查:这套脚本到底是不是 Lua

    已固定 脚本教学 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) 编译 → 运行 → 看输出窗口。编译器通过 + 运行输出符合预期,才算确认;只有编译通过不算。 实测出新结论欢迎发到版块里,这类帖子比任何教程都有用——文档没写的地方就是靠这样一条条补出来的。
  • 键鼠助手 5.0 资源汇总:主程序 / 文档 / 配套工具下载

    已固定 已锁定 键鼠助手 Lua宏
    1
    0 赞同
    1 帖子
    172 浏览
    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) 注意事项 绿色免安装单文件,双击即用。 热键若与其他软件冲突,在系统托盘退出本工具后重开即可解除占用。 坐标以屏幕左上角为原点,填脚本前请确认脚本里用的是否同为绝对坐标。 上手顺序推荐 先看 使用文档,了解宏绑定、宏编辑和烧录的完整流程; 下载对应平台的主程序(Windows 解压即用 / macOS 拖入应用程序); 写脚本时可配合 录制工具 生成骨架、用 鼠标定位 取坐标; 测试通过后再点到键鼠助手里烧录到硬件。
  • 此主题已被删除!

    2
    0 赞同
    2 帖子
    1 浏览
  • 键盘采样:让盒子认识你那把键盘

    设备固件 键盘采样
    1
    0 赞同
    1 帖子
    49 浏览
    A
    盒子夹在电脑和键盘之间:电脑看到的是盒子,你的按键要先经过盒子转一手才能到电脑。这一手能不能转对,取决于盒子知不知道你这把键盘的报文长什么样。 多数键盘用标准格式,盒子自带的那套就够。但另一类键盘不一样:全键无冲用位图、把修饰键和键码拆成两个 report、自己加了 report ID、或者把功能键丢在另一个用途页里。碰上这类键盘,默认格式对不上,键就转不过去。 键盘采样就是给这类键盘用的:采一次,盒子以后按你这把键盘的格式来。 能解决什么问题 出现下面这些症状,先试采样: 症状 具体表现 某些键完全不认 按了电脑没反应,别的键都正常 按住不放变成连击 按住 Shift 走出来一串 Shift,按住方向键光标乱跳 组合键只过去一半 Ctrl+C 到电脑只剩 C,Ctrl+Shift+Esc 只出一个键 功能键、多媒体键失效 主键区正常,上面一排或者侧键不通 换了键盘就出问题 上一把键盘好好的,换这一把就不对 如果整把键盘都不工作、设备根本识别不到,那不是采样的范围,见《设备识别、固件更新与恢复》。 做完之后是什么效果 盒子换成你这把键盘的身份:VID/PID、报文格式都跟着它走,电脑那边认到的就是这把键盘。 状态行显示 Mode: 透传 表示生效了。显示「固定」说明连的还是盒子自己的身份,采样没起作用。 宏不用改。 脚本里的 KeyTap("a") 还是 KeyTap("a"),变的是这一下按键最终以什么格式发出去,采完不用回去改脚本。 可以存下来复用。 采样结果能导出成 .kmps,换机器、恢复出厂之后导回去,不用重采。 采样只读键盘自报的身份信息,不记录你按过的任何键。 操作前先确认 条件 说明 设备要支持 仅新设备具备这个能力,老设备点了不会有回应 设备已激活 未激活的设备不执行采样,直接回错误码 -8 键盘插在盒子上 采样时盒子要能枚举到它,插在电脑上采不到 用键鼠透传程序 采样按钮在键鼠透传里,不在键鼠助手主程序里;两个程序装在同一目录 之前手填过 VID/PID(见《USB 协议自定义》)的,采样之后以采样结果为准,手填的那两个值会被覆盖。 操作步骤 打开键鼠透传。 与键鼠助手同目录的另一个程序。 按压按键。保持按压状态把键鼠透传设备插入电脑。 连接设备。 第一次连不要勾「仅连接」——此时盒子还是它自己的身份,全枚举就能找到。 点底部的「KM 采样」。 按钮变成「采样已发出」,等回包。 看结果。 成功时会提示 采样设备: VID xxxx / PID xxxx,同时这对 ID 自动填进连接条的 VID/PID 框,并自动勾上「仅连接」——设备重启后已经换了身份,不点名就找不到了。(部分设备不会填入VID/PID,可以忽略这个,不影响纯硬件宏使用,只是无法通过软件API调用键鼠事件)。如果没有弹出VID/PID框,也不需要上位机调用,如果想再试连接,重复第2步。如果需要上位机调用,可以换个其它的键鼠设备尝试一下,一般支持板载宏的键鼠都支持,但是并不代表不支持板载宏的键鼠就不支持,只是概率会小很多。 手动点一次「连接」。 采样成功后设备会重启,此时链路是断的。 确认模式。 连接条状态行显示 Mode: 透传 才算成了。显示「固定」说明这次连的还是设备自己的身份。 采样命令发出去后 6 秒没有回应,程序会提示「设备没有回应采样命令」。常见原因:设备没激活、固件太旧不支持、链路已断。 备份与迁移 采样结果能取出来,也能写回去: 按钮 作用 导出 把设备里的采样镜像读出来,存成 .kmps 文件 导入 把 .kmps 写进设备,写完设备自动重启 两种用途:同一型号的键盘有好几把,采一次导出、其余几台导入;或者设备要升级固件、恢复出厂之前先把镜像存一份。 .kmps 里装的是某个键盘型号的 USB 身份。导入来源不明的文件,等于让盒子冒充你没见过的设备。要恢复就换回自己那份,别拿别人给的当通用备份。 遇到问题如何处理 采样失败,弹了错误码 提示格式是「采样失败(错误码 N):说明」: 码 含义 一般怎么处理 -1 没有找到兼容的 USB 设备 键盘没插在盒子上,或插了但不兼容 -2 读设备描述符失败 换线、换口再试 -3 读配置描述符失败 同上 -4 读 HID 报文描述符失败 复合设备容易卡在这步,换口重试 -5 采样数据写入设备失败 设备存储异常,重试;仍失败联系售后 -6 采样数据超出存储上限 描述符太大,多见于 report 很多的自定义键盘 -7 采样超时 键盘响应慢或中途掉了,重插再采 -8 设备未激活 先激活 -9 设备没有回传 VID/PID 固件过旧,见《设备识别、固件更新与恢复》 提示采样成功,但连不上设备 设备重启成新身份,而程序的自动重连还在用旧 VID/PID,必然连不上。这不是坏了,手动点一次「连接」。 采完个别键还是不对 按顺序核两件事:键盘是不是插在盒子上采的;连接后状态行是不是 Mode: 透传。两步都对仍有键不对,说明这把键盘的报文里有盒子没覆盖的字段——带上键盘型号和当时的错误码发帖,比只说「有个键按不出来」有用得多。 换了一把键盘,之前采的还能用吗 不能。采样绑的是那一把键盘,换一把报文格式不同的要重采。 什么时候该重新采样 换键盘、键盘换了 USB 口之后行为变了、或者升级固件后提醒重采——这几种情况重新采一次。日常换机器、重装程序不用重采,把 .kmps 导回去就行。 相关 盒子的身份是怎么被系统识别的:见《USB 协议自定义:VID/PID 与字符串描述符》; 版本信息、固件更新与恢复:见《设备识别、固件更新与恢复》。
  • 连招与技能循环的时间轴写法

    单机游戏 连招时序
    1
    0 赞同
    1 帖子
    8 浏览
    A
    连招的本质是一条时间轴:每个动作在什么时刻按下、间隔多久。宏做这件事的能力恰好够用——它能精确控制时间,但完全不知道技能有没有放出去。 适用范围:仅单机 / 离线 / 自带训练场。不适用于任何联机对战模式。 最小版本:顺序 + 间隔 -- 三段连招 KeyTap("1") Delay(180) KeyTap("2") Delay(220) KeyTap("3") Delay 的值等于**「上一个动作的动画 / 后摇时长」**,不是「你手的速度」。取值方法:在训练场放一次,数出下一个技能能接上的最早时刻,再减 20ms 作为余量——这 20ms 不是玄学,KeyTap(key) 展开就是 KeyDown → Delay(20) → KeyUp,技能键自己要先占住 20ms 的按下时间,之后才开始算你给的 Delay。 用函数封装,避免重复 连招一长,重复的 KeyTap + Delay 会写满整屏。封装一下: function cast(key, wait_ms) KeyTap(key) Delay(wait_ms) end -- 三段连招现在是这样 cast("1", 180) cast("2", 220) cast("3", 300) 想改某个技能的间隔,只改调用处那一个数字。 循环:固定节奏的技能循环 单机游戏里常见的「技能循环」是按固定顺序反复施放: local CYCLE = 6 -- 循环轮数 for i = 1, CYCLE do cast("1", 150) cast("2", 150) cast("3", 150) cast("4", 900) -- 4 是长 CD 技能,等它转好 end 关键判断:这段等待时间里,你的角色是不是什么都不做? 如果答案是「是」,那这个循环是浪费;如果能塞进普攻,就把普攻塞进去: for i = 1, CYCLE do cast("1", 150) cast("2", 150) KeyTap("q") -- 普攻 Delay(600) cast("3", 150) cast("4", 900) end 抖动:让节奏不那么机械 固定间隔在单机里主要是为了「手感不假」,在带在线组件的游戏里还有一层意义——完全等间隔的输入是自动化检测最容易识别的特征。 function castJitter(key, base_ms, jitter_ms) KeyTap(key) Delay(base_ms + math.random(-jitter_ms, jitter_ms)) end 单个技能的抖动幅度建议在基准值的 5%–10% 之间。抖太大了连招会断,抖太小没意义。 时间轴表:一次改全部 连招步骤多的时候,把参数收进数组,用循环展开: -- 下标从 0 开始(本设备数组与标准 Lua 不同) local KEYS = StringArray(6, 8) local WAITS = Array(6) KEYS[0] = "1" WAITS[0] = 180 KEYS[1] = "2" WAITS[1] = 220 KEYS[2] = "3" WAITS[2] = 300 KEYS[3] = "q" WAITS[3] = 400 KEYS[4] = "4" WAITS[4] = 800 KEYS[5] = "5" WAITS[5] = 500 for i = 0, 5 do KeyTap(KEYS[i]) Delay(WAITS[i]) end 注意 StringArray(6, 8) 的第二个参数是单个字符串的容量,KEYS[i] 里放的是键名。数组长度声明之后不会自动扩容,写第 7 个就越界。 常见问题 现象 原因 处理 第二个技能没放出来 前摇/后摇比设的短,按键被吃掉 加 40–60ms 再试 连招到第三段就断 累计误差 + 游戏帧率波动 关键节点加长延时,不要全程卡极限 技能按了但没进 CD 目标/朝向/距离不满足 宏判断不了,只能靠站位固定 循环几轮后整体错位 某个技能实际 CD 比设的长 拿「最长那个」定循环周期,其余留空 长按型技能放不出来 KeyTap 只有 20ms 改用 KeyDown + Delay + KeyUp 最后一条值得单独说。有些技能是蓄力 / 长按触发的,KeyTap 的按下时长写死为 20ms(它就是 KeyDown → Delay(20) → KeyUp),这个时间不够,所以必须拆开自己写: -- 蓄力 600ms 的技能 KeyDown("3") Delay(600) KeyUp("3") Delay(150) 别指望它「智能」 宏不知道: 技能有没有进 CD; 目标在不在范围; 有没有被打断; 蓝量够不够。 它只会在设定的时刻按下设定的键。所以这类脚本的正确用法是:站好位置、确保资源充足、然后把时间轴跑一遍。跑的过程中出任何意外,它都会继续往下按——这就是必须有人看着的原因。 想做到「按情况调整」需要读游戏状态,那不是这套硬件的活。
  • 重复采集与刷素材的循环宏

    单机游戏 循环结构
    1
    0 赞同
    1 帖子
    8 浏览
    A
    单机游戏里最值得交给宏的是「节拍固定、路线固定」的重复劳动:走一段、交互、等动画、再走。这篇讲怎么写稳。 适用范围:仅单机 / 离线 / 自带训练场。不适用于任何联机对战模式。 分解成四段 任何一个采集循环都能拆成: 移动 → 交互 → 等待 → 回到起点 关键是每一段的时长都必须能从游戏里量出来,不能靠估。 移动:按住 W 从 A 走到 B 要多久?用秒表量三次,取最短的那个(会中途卡住的话取中位数); 交互:E 按下去之后,采集动画多久结束?这段时间里按别的键会打断动画; 等待:动画结束后多久才能再次交互?早按了没反应,晚按了浪费时间; 回程:路线是闭环还是单向传送? 基础骨架 -- ===== 可调参数 ===== local ROUNDS = 30 -- 循环轮数 local WALK_MS = 1200 -- 前进时长 local INTERACT_MS = 900 -- 采集动画时长 local COOLDOWN_MS = 300 -- 动画结束到可以再次交互的间隔 local JITTER_MS = 50 -- 随机抖动幅度 -- ==================== for i = 1, ROUNDS do -- 前进 KeyDown("w") Delay(WALK_MS + math.random(-JITTER_MS, JITTER_MS)) KeyUp("w") Delay(120) -- 停稳,别在移动中就按 E -- 交互 KeyTap("e") Delay(INTERACT_MS) -- 冷却 Delay(COOLDOWN_MS) -- 回程(如果是闭环路线) KeyDown("s") Delay(WALK_MS + math.random(-JITTER_MS, JITTER_MS)) KeyUp("s") Delay(120) end ReleaseAllKeys() 三处细节: KeyUp("w") 之后那 120ms 不能省。角色停下来有减速过程,移动中按 E 可能不触发交互。 末尾 ReleaseAllKeys() 是兜底。万一中途按了终止键,w 会一直按着,角色会一直走。 每段移动都加抖动。固定周期的输入节奏太规律,某些游戏的风控会把完全等间隔的操作标记成异常(单机游戏也可能有在线反作弊组件)。抖动幅度不用大,±50ms 就够。 为什么要用变量而不是写死 游戏更新会改数值:地图拉长了、动画变快了、交互冷却调整了。参数提到开头,改一行就行: local WALK_MS = 1400 -- 上次 1200,更新后地图变长了 如果时间写死在各处,改一次要找十几个地方,还容易漏。 加一个「中断检查」 长循环最怕的是「跑歪了还在继续跑」——角色卡在墙边,宏还在按 W,半小时后发现什么都没采到。 一个简单的自保机制是分段执行:不要一次跑 200 轮,跑 20 轮停一下,让眼睛看一眼。 local BATCH = 20 local BATCHES = 5 for b = 1, BATCHES do for i = 1, BATCH do -- 一轮采集 KeyDown("w") Delay(1200) KeyUp("w") Delay(120) KeyTap("e") Delay(1200) end Delay(3000) -- 每批之间停 3 秒,方便观察 Log("batch %d done", b) end Log 在软件验证时能看到进度;烧进硬件后虽然看不到输出,但那段 Delay 仍然是「给自己看的一眼」。 常见问题 现象 原因 处理 采集没触发 移动中按了 E,或站的位置偏了 加停稳延时;检查路线是否需要修正 越跑越偏 每轮有微小误差,累积后偏离路线 减少单轮距离;或每 N 轮做一次「归位」动作 中途卡住不动 遇到障碍 / 怪物 / 加载界面 宏判断不了,只能靠人盯;缩短批次 第二次循环开始就乱了 动画时长比设的长 把 INTERACT_MS 加 20% 试 跑完后按键还按着 中途被中断,没执行到 KeyUp 末尾加 ReleaseAllKeys();中断键随手能按到 别做的事 不要指望宏处理「意外」。掉线、加载、随机事件、怪物打断——它一个都处理不了。这就是为什么这类脚本必须有人看着。 不要用它绕过游戏的付费或进度设计。刷素材和刷货币是两件事,前者是省时间,后者可能违反游戏规则甚至用户协议。 不要在联机模式下开。单机游戏常常带联机功能,模式切错了性质就变了。
  • 单机游戏宏的边界:能做什么、不能做什么

    单机游戏 内容边界
    1
    0 赞同
    1 帖子
    13 浏览
    A
    先说结论:单机、离线、自带训练场的场景可以做,联机对战的一律不做。 这条线不是道德姿态,是两件不同的事。 为什么单机和联机是两回事 单机游戏里用宏,影响的是你自己的游戏体验。它和「开修改器」「用控制台刷材料」是同一类行为——加快你本来就要做的重复劳动,没有第二个玩家因此受损。很多单机游戏本身就内置了宏、脚本、自动化模组支持。 联机对战里用宏,影响的是同一局其他玩家的胜负。而且硬件盒子的输入由独立 HID 设备发出,反作弊读不到进程,它绕过的正是公平竞技赖以成立的那道检测。 同样是「按下键自动执行一串动作」,一件事只涉及你自己,一件事涉及不知道你存在的人。所以边界画在这里。 能做到什么 硬件盒子只做输出,不看屏幕、不读内存。所以它能做的是**「固定的动作序列」**: 能做 例子 固定路线的移动 按住 W 前进 1.2 秒,松开,按 E,等 0.9 秒,循环 重复采集 / 刷素材 同一套动作重复 50 次,中间加随机抖动 菜单导航 打开背包 → 切到第三页 → 选中 → 确认 技能循环 按固定顺序和固定间隔施放技能 训练场连招练习 把一套连招的时间轴固定下来,反复练手感 挂机式重复劳动 挖矿、钓鱼、跑商这类节拍固定的动作 做不到什么 做不到 为什么 看到敌人自动开枪 需要读画面或读内存,硬件没有这个通道 血量低了自动喝药 同上,判断不了血量 捡起指定物品 判断不了地上是什么 见招拆招 需要根据对方动作实时决策 自动寻路到指定坐标 只能按固定路线走,走歪了它不知道 任何声称「能看画面」的宏,要么是假的,要么跑在电脑上(读内存 / 截图分析),不是这套硬件。 别被这类说法带跑——买了硬件发现做不了,是你自己的损失。 适用范围声明怎么写 发单机游戏相关的脚本时,正文开头加上这一段,说清楚边界: **适用范围**:仅单机 / 离线 / 自带训练场,不适用于任何联机对战模式。 **依赖**:固定路线或固定节拍。游戏更新导致地图、技能改动后可能需要重新调整。 **风险**:使用前请确认该游戏对自动化的态度;部分单机游戏也有反作弊,联机功能开启时请关闭宏。 第三行不是客套。现在很多单机游戏带在线模式(联机合作、排行榜、赛季),一旦在联机状态触发这类宏,性质就变了。玩之前先确认自己处在什么模式。 一个现实提醒 单机游戏宏的寿命通常比想象中短: 地图改了路线就废; 技能数值改了节奏就废; 动画时长调了,等待时间就不对。 所以写这类脚本的正确姿势是:把「时间」和「次数」全部提到开头当变量,游戏更新了只改顶部几行,不用重写逻辑。 -- ===== 可调参数 ===== local ROUNDS = 30 -- 循环次数 local WALK_MS = 1200 -- 每段前进时长 local COLLECT_MS = 900 -- 采集等待 local JITTER_MS = 60 -- 随机抖动幅度 -- ==================== 最后 想拿联机游戏的方案来改?不用问了,这类脚本不发、不写、不讨论——包括改名、缩写、谐音、代号的形式。这条没有例外。 单机方向的具体写法,看这两篇: 《重复采集与刷素材的循环宏》 《连招与技能循环的时间轴写法》
  • 常见报错与处理

    疑难解答 报错处理
    1
    0 赞同
    1 帖子
    5 浏览
    A
    按出现阶段分四类:编译期、运行期、设备连接、软件崩溃。每类给现象、原因、处理。 一、编译期 编译只查语法,所以这一类的报错都指向「写法不合法」。 报错大意 原因 处理 意外符号 end / 缺少 end 容器块没闭合 数一下 if/while/for/function 各开了几个、end 有几个 未知函数 xxx 函数名拼错,或这个能力不存在 对着《内置函数与 HID 键码对照表》核名字。注意大小写:KeyDown 不是 keydown 参数数量不对 传多了或传少了 Delay 只要一个数;MoveMouse 要两个 字符串未闭合 引号少了一半 中文引号和英文引号不是一回事,必须用英文 " 期待 then if 后面漏了 then if x > 1 then 期待 do while / for 后面漏了 do while x < 5 do 无法解析的表达式 用了不支持的语法 常见:else if(应为 elseif)、!=(应为 ~=)、++(不存在) 一个高频错误:把 = 和 == 搞混。 if count = 5 then -- 错,= 是赋值 if count == 5 then -- 对,== 是比较 还有 ~= 是「不等于」,不是 !=。 二、运行期 这类不报错,只是行为不对。 现象 原因 处理 循环次数比预期多一轮 / 少一轮 数组下标从 0 开始,与标准 Lua 不同 检查 for i = 1, n 到底该到 n 还是 n-1 math.tointeger 结果总是 0 转换失败返回 0(不是 nil),看起来像「值就是 0」 用 math.type() 判类型 数值算出来差 1 // 是向下取整,负数时与直觉不同 -7 // 2 是 -4,不是 -3 拼接字符串编不过 没有字符串库 只能用 ..,没有 string.format Log 输出错位 格式符与参数不匹配,或两种模式混用 首个参数有 %d/%s 就全按 printf 给 脚本跑到一半停了 按了终止键 / 触发了别的宏 / 目标程序弹了模态窗 见《编译通过但设备不动作》第 6、7 条 三、设备连接与加载 现象 原因 处理 一插设备软件就卡 / 加载超时 「自动加载宏」一次读入太多宏 拔设备 → 关自动加载 → 插回 → 烧录 → 清空所有绑定 状态栏第一栏一直是红的 线、口、Hub 换线、换口、直插 烧录后行为没变 只编译没烧录;或烧的不是当前场景 改一个明显参数重烧验证 软件里能连、系统里不认 USB ID 被改过 见《USB 协议自定义》 无线设备完全收不到输入 接收器没配对 见《无线接收器重绑与格式化》 四、软件崩溃 文档里点名的场景只有一个:自动加载宏 + 宏数量过多,表现为启动时崩溃或加载极慢。 处置流程(照文档原文的顺序): 拔掉设备; 打开软件,把「自动加载宏」取消勾选; 插入设备; 点击烧录; 清空所有绑定的宏。 这套流程能恢复到干净状态。恢复后如果还崩,就不是宏数量的问题了,看下一节。 五、报错信息怎么贴 发帖求助时,不要只截一张报错图。需要三样: 报错原文(可以复制文字,比截图好); 出错的那一段脚本,不是全部; 出错时代码在第几行(编译器一般会给行号)。 如果报错是「运行时才出现」(编译能过、运行崩),加上:触发方式、场景、目标软件、以及能不能用最小脚本复现。 最小复现脚本是排查里最有价值的东西——把问题从 200 行缩到 3 行,往往自己就看出原因了。 一个通用的降错顺序 写新脚本时按这个顺序推进,比写完一起调要快: 先写一行,编译 + 运行,确认环境通; 加第一段动作,跑,确认这一段对; 套循环,次数设成 2,跑; 次数改大,跑; 加条件,跑; 最后才烧进硬件。 每一步都只改一个变量。这样出问题时,原因一定是「刚改的那一处」。
  • 无线接收器重绑与格式化

    硬件固件 无线配对
    1
    0 赞同
    1 帖子
    4 浏览
    A
    无线版有两个和有线版不一样的入口:重新绑定接收器和格式化接收器固件。前者是日常维护,后者是危险操作。这篇把两者分清。 重新绑定接收器:什么时候用 两个场景: 接收器换了新的(丢了、坏了、补发了),新接收器和设备之间没有配对记录; 接收器的绑定信息被清除了(比如误操作、异常断电、固件被重刷)。 现象是:设备能开机,但电脑上完全收不到输入——因为接收器不认识这台设备。 操作:偏好 → 无线配对 → 重新绑定接收器。按提示把设备和接收器靠近,等配对完成。 这一步是可逆的、安全的。配错了再配一次就行,不会损坏任何东西。 格式化接收器固件:这不是随时能做的 这个入口是为「需要给接收器烧录新固件」准备的——正常使用完全用不到。 文档里的原话需要完整读一遍: 需要烧录新的接收器固件时点击此项;如果烧录的固件有问题导致接收器变砖时,需要使用专用的烧录器才可能会恢复,如果之前烧录时选择的不是 PB11 则无法恢复。 拆开看,这句话里有三个信息: 它是给接收器换固件用的,不是修复工具; 烧坏了会变砖,软件层面救不回来,需要专用烧录器,而且只是「可能」恢复; 前提条件是有条件的——如果烧录时选的引脚不是 PB11,无法恢复。 第 3 条是最要命的:它不是「变砖后还能救」,而是「只有当初选对了引脚的那一批才有救」。 所以,动它之前 如果你不是明确要烧接收器固件(比如官方给了新固件包并说明了流程),不要点这个按钮。 真要动,按这个顺序准备: 确认固件包是为这个接收器型号做的。型号对不上,刷进去就是变砖; 确认引脚选择。文档只提到 PB11 是可恢复的那一档,其他引脚刷坏了没有救; 保证供电稳定。刷写过程中断电是变砖的最主要原因,不要用快没电的笔记本、不要插在会松动的 Hub 上; 不要同时在跑别的宏或烧录。刷写期间设备被别的操作打断,结果不可预期; 刷完立刻验证:能不能连上、按键有没有反应。 如果这五条里有任何一条你没法确认,就先别刷。 变砖了怎么办 现象:接收器插上后系统毫无反应,或者设备管理器里出现未知设备。 处理顺序: 换 USB 口、换线,先排除接触问题(这一步能解决相当一部分「以为变砖」); 在另一台电脑上试一次,排除本机驱动问题; 都不行,联系支持,说明:接收器型号、刷的是哪个固件、当时选的哪个引脚、卡在哪一步。这四项决定还有没有救; 如果当初选的不是 PB11,按文档说法是无法恢复,只能换接收器。 和有线的区别 项 有线 无线 配对 不需要 需要,接收器与设备一一对应 换接收器 不涉及 必须重新绑定 刷固件风险 设备端固件,风险较低 接收器变砖可能不可恢复 排查第一步 换线换口 换线换口 + 确认配对 日常维护建议 配对信息不要随便清。它不是「重置一下更干净」的东西,清了就得重配; 接收器单独存放。丢了接收器等于设备不能用,而重新配一个接收器比想象中麻烦; 不要为了「试试看」点格式化。这个按钮的代价不对称:点对了没收益,点错了可能报废一台设备。
  • USB 协议自定义:VID/PID 与字符串描述符

    硬件固件 USB
    1
    0 赞同
    1 帖子
    11 浏览
    A
    设备在系统里是怎么被认出来的?靠四个 ID 和三个字符串。偏好里的「USB 协议配置」就是改这些的地方。 四个 ID 和三个字符串 项 含义 例子 Vid Vendor ID,厂商 ID 0x0483(ST 的厂商号) Pid Product ID,产品 ID 0x5710 Manufacture 厂商字符串,设备管理器里显示 My Devices Product 产品字符串 KMA Box Serial 序列号字符串 KM-0001 操作系统靠 Vid + Pid 决定加载哪个驱动(或者不加载)。字符串只是给人看的。 改了有什么用 1. 和真实设备区分开。 如果盒子和你的真鼠标用了同一组 Vid/Pid,系统里会出现两个同名设备,某些软件(尤其游戏和宏软件)会认错。改成不同的值就不会混。 2. 让特定软件识别成它能认的设备。 少数软件按 Vid/Pid 白名单判断「这是不是支持的硬件」。改成白名单里的值,它才认。 3. 多台设备共存时区分。 两个同样的盒子插在同一台机器上,用 Serial 区分。 改了会有什么后果 必须说在前面:这四个值是设备对外的身份,改错了会出问题,而且改了之后系统里的记录会和之前不一致。 常见后果: 后果 原因 改完系统认不出设备,软件也找不到 Vid/Pid 组合没有对应的驱动匹配,或与其他设备冲突 设备管理器里出现感叹号 / 未知设备 同上 你需要拔插好几次才认到 系统缓存了旧的设备实例 改之前能用的软件,改之后不认了 那个软件按 ID 做了白名单 操作前记下原始值。 截图或者手抄:Vid、Pid、Manufacture、Product、Serial 五项。改了之后如果出问题,还能改回来。 如果改完之后软件彻底找不到设备、连改回来的入口都进不去——这时候需要按「清空所有绑定的宏」那套流程重置(见《设备识别、固件更新与恢复》),或者重新烧录固件。 一个稳妥的改法 不要一次改五项。按这个顺序: 先只改 Product 字符串(纯展示,风险最低)。改完拔插,看设备管理器里的名字变了没。确认这套流程能走通。 再改 Manufacture。 最后才考虑动 Vid/Pid——这两个才是有真实后果的。 改 Vid/Pid 时不要选这几类值: 系统关键设备的 ID(键盘、鼠标、存储控制器,比如 0x046D 罗技、0x045E 微软的常见值); 你机器上已有的其他设备的 ID(会撞); 0x0000 这类明显非法的值。 只改 Serial 的一个用途 多台设备插同一台机器时,操作系统通过 Serial 区分实例。如果两个设备的 Vid/Pid 相同、Serial 也相同,系统会认为是同一台设备反复插拔,配置可能互相覆盖。 给每台设备一个不同的 Serial 就解决了。这是这五项里唯一「改了几乎不会有副作用」的一项(前提是别和其他设备重复)。 什么时候不用管它 绝大多数用户不需要动这一页。 如果你的设备在系统里正常识别、软件正常连接、宏正常烧录,那就保持默认。这不是一个「优化项」,是一个「出问题时才用的开关」。 改它的收益很小,代价是可能把一台好设备弄成需要重置的状态。 排查:改完不认了 拔掉设备,等 5 秒,插回; 看设备管理器里有没有新出现的未知设备 / 带感叹号的设备; 如果有,说明 ID 生效了但驱动没匹配上——把 Vid/Pid 改回原值; 如果软件连「关于」页都读不到设备信息,走重置流程:拔设备 → 开软件 → 关闭自动加载宏 → 插设备 → 烧录 → 清空绑定; 以上都不行,联系支持时把原始 ID 和改成的 ID 一起报上去,这比描述现象有用得多。
  • 设备识别、固件更新与恢复

    硬件固件 固件更新
    1
    0 赞同
    1 帖子
    14 浏览
    A
    设备出问题时,第一件该做的事是把版本信息记下来。这篇讲怎么查、怎么更新、以及出事了怎么救回来。 先看关于页 关于页有三样东西: 项 用途 软件版本 求助帖必须写 固件版本 与软件版本可能不同步,升级时要分别看 设备标识号 右键可复制,是这台设备的唯一标识 设备标识号一定要先复制存下来。 后面所有需要「证明这是同一台设备」的场合(保修、找客服、恢复配置)都用得上,而它只在这一页显示。 状态栏三个灯的意义 栏位 含义 第一栏 连接状态。红 = 没连上,绿 = 已连接 第二栏 运行状态。红 = 当前没在跑宏,绿 = 宏正在执行 第三栏 实时消息 排查「宏不动作」时,第二栏是最直接的判据:按了触发键,第二栏有没有变绿。 变绿但没效果 → 宏在跑,但按键打到了别的地方(焦点问题)或者动作本身不合预期; 不变绿 → 触发根本没进来(触发键 / 触发类型 / 场景 / 设备类型的问题)。 这一条能把问题范围砍掉一半。 检查更新 关于 → 检查更新,会去服务器看有没有新的软件或固件。 升级前建议: 先做一次配置导出(偏好 → 配置 → 导出)。它会把 config 目录打包备份,出问题能导回来; 记下当前版本号; 升级完成后重新插一次设备。 导出这一步不要省。 导入会覆盖当前配置,所以顺序是「先导出再动」,不是「动坏了再导出」。 自动加载宏:省事但会出事 偏好里有个「自动加载宏」:软件启动时自动把宏读进来。日常用很方便,但宏数量多了会卡。 文档里明确写了处理办法,照做即可: 拔掉设备; 进偏好,把「自动加载宏」取消勾选; 插回设备; 点烧录; 清空所有绑定的宏。 这样能恢复到「设备里没有宏」的干净状态。之后再一项项加回去,加到卡为止就知道是数量问题。 什么时候该关掉它:宏列表很长(几十个以上)、软件启动明显变慢、或者一插设备就崩溃。日常用不到自动加载的话,关着更稳。 烧录失败怎么看 烧录是「把配置写进硬件」这一步。它失败时通常表现为:状态栏没有成功提示、重新插拔后宏还在旧状态。 按这个顺序查: 设备连接是否正常(第一栏是不是绿的); 是不是还在上一个宏的编辑状态——先编译通过再烧录; 换一个 USB 口 / 换一根线。供电不足和数据线劣质是烧录失败的高频原因,尤其经过 Hub 的时候; 拔掉 Hub,直插。文档提到支持 2.0 USB 集线器同时插键盘和鼠标,但烧录阶段直插更稳; 还不行就按上一节的「清空所有绑定的宏」走一遍,从空状态重新加。 关于固件回退 需要说清楚:设备端固件没有官方文档化的回退流程。 手上有旧版软件安装包时,装回旧版是可行的(卸载当前版本再装旧的)。但固件不是——固件是烧进设备的,降级需要对应版本的固件包和对应的烧录方式,这一步文档没有覆盖。 所以对固件的原则是:没有明确需要,不要动。 升级前确认当前版本能用、配置已导出,升级后立刻验证基本功能(连点、按键)是否正常,别等做完一整套宏才发现设备不对。 一张排查顺序表 现象 先看这里 第一栏是红的 线、口、Hub。换线换口先试 第一栏绿、第二栏不绿 触发键 / 触发类型 / 场景 / 设备类型 第二栏绿但没效果 焦点在不在目标窗口;输入法状态 烧录后行为没变 是否真的烧录成功;是否改完只编译没烧录 一插就崩溃 关掉「自动加载宏」,清空绑定后重来
  • 块编辑器的操作细节

    图形化 块编辑器
    1
    0 赞同
    1 帖子
    3 浏览
    A
    入门那篇讲了怎么拼出一个宏。这篇是操作层面的清单:移动、复制、撤销、缩放、条件追加——都是实际用起来才发现「原来还能这样」的东西。 移动 直接拖动块。 拖到别的块之间 = 改变顺序; 拖进容器块的嘴里 = 移进循环 / 条件内部; 拖动过程中按 Esc 放弃本次移动,块会回到原位。 最后这条很实用:拖歪了不用松手再找回来,按 Esc 就复位。 多选 按住 Ctrl 单击块,逐个加选 / 减选。选中的块带琥珀色边框。 多选之后可以一次性删除(Delete)、一次性复制(Ctrl+C)。批量调结构时比一个个拖快得多。 复制粘贴 Ctrl+C / Ctrl+V 右键菜单同样有 复制的是整棵块树——含子语句与多分支条件,不是只复制眼前这一行。所以可以把一个完整的循环结构连同里面所有东西一起搬到另一个脚本里。 从别处复制来的纯文本粘贴进画布时,会尝试解析成块。解析不了的部分会以注释块或纯文本形式落地,不会丢内容。 创建副本 右键 →「创建副本」,原地复制一份插在后面。和剪贴板互不影响——你剪贴板里的东西不会被覆盖。 改一个块的参数做微调时,这个比「复制 + 粘贴」顺手。 删除 选中后按 Delete 或 Backspace。多选时一次删掉全部。 注意:选中值块时只删这一块;选中语句块时删整条(含嘴里所有子语句)。删语句块前先看清选中的颜色范围。 上移 / 下移 右键菜单,同级内调整一条语句的位置。拖拽也能做到,但在密集的块链里拖容易放错位置,用菜单更准。 条件分支的追加 在「条件分支」块上右键: 添加「否则如果」分支 / 删除最后一个「否则如果」分支 添加或删除「否则」分支(同一项在添加 / 删除之间切换) 一个 if 想加第三个分支,不用重新拼,右键加一个就行。 缩放:40% ~ 300% 右下角比例按钮:显示当前比例(如 100%),单击弹出「放大 / 缩小 / 实际大小 / 适应宽度」; Ctrl + 滚轮:以鼠标所在位置为中心缩放,缩放时光标下的块不会跑掉; Ctrl + = 放大、Ctrl + - 缩小、Ctrl + 0 回到 100%; 适应宽度:把整棵块树横向塞进窗口。代码写得宽(多层条件嵌套)时用它一屏看全。 不按 Ctrl 的滚轮就是正常的上下滚动。 撤销与重做 Ctrl+Z 撤销 Ctrl+Shift+Z 或 Ctrl+Y 重做 右键菜单顶部也有,灰色表示没有可回退的操作 能回退的包括:改参数、删块、拖错位置、加分支。所以拖歪了不用怕,撤一下就行。 定位选中 右栏顶部有个「定位选中」开关。打开后,在画布中点选一个块,右侧目录会自动滚动并高亮到对应条目。 脚本里用了十几个不同类型的块时,这个开关能帮你快速找到「这个块对应目录里的哪一项」,反过来也能从目录定位到画布上的块。不需要自动滚屏就关掉它。 快捷键一览 操作 快捷键 复制 / 粘贴选中块 Ctrl+C / Ctrl+V 删除选中块 Delete 或 Backspace 加选 / 减选 Ctrl+ 单击 撤销 / 重做 Ctrl+Z / Ctrl+Shift+Z(或 Ctrl+Y) 放大 / 缩小 / 实际大小 Ctrl+= / Ctrl+- / Ctrl+0 以光标为中心缩放 Ctrl+ 滚轮 放弃当前拖动 Esc 画布右键菜单 菜单项 说明 撤销 / 重做 与快捷键等价,空白处右键也能用 复制 / 粘贴 空白处右键时粘贴追加到末尾 缩放 ▸ 放大 / 缩小 / 实际大小 / 适应宽度 创建副本 原地复制插在后面 删除 选中值块删这一块,选中语句块删整条 上移 / 下移 同级内调顺序 添加 / 删除分支 仅「条件分支」块上有 编辑这段表达式… 条件 / 数值槽上右键,用手写表达式整段替换 这是什么? 弹出这个块的用途说明 与文本模式的关系 三种模式共用同一份脚本:图形模式里每改一次块,就同步生成等价的 Script 文本,编译、验证、保存、烧录都走同一条链路。 从图形切回文本时,看到的就是即将运行的文本。块编辑器会做一次规范化排版(缩进、括号、空白),语义不变但换行位置可能与你手写的不同——这是正常现象,不是内容被改动了。 反过来,从文本切到图形时,如果遇到暂不支持的写法会拒绝切换并指出行号,脚本内容不受影响。
  • 图形化块编程入门

    图形化 块编辑器
    1
    0 赞同
    1 帖子
    9 浏览
    A
    不想写代码也能做宏。图形模式把脚本拆成一块一块,拖着拼起来就行,拼完照样编译、烧录。 先讲清一件事:图形模式和文本模式是同一份脚本的两种看法。 不是两套东西,也不是「简单版」和「专业版」。你在图形里拖一个块,文本里就多一行;你在文本里改一行,切回图形看到的就是改过的样子。随时可以来回切。 怎么切过去 宏编辑页工具栏最右端是编辑形态开关: 左段 </> → 文本模式 右段(叠块图标)→ 图形模式 点一下右段就切。软件会记住你上次用的形态,下次打开同一个宏自动恢复。 工具栏左侧的编译和验证两个按钮对两种模式都管用,切到图形模式后不用回文本模式就能检查。 如果当前脚本里有图形模式暂时不支持的写法,切换会被拒绝——脚本内容不会改动,下方输出窗口会说明是哪一行无法转换成语句块。这种情况继续用文本模式编辑就行,不影响使用。 界面 区域 图形模式下的内容 左栏 宏目录,和文本模式相同,选要编辑的宏 中栏 块画布。整段宏就是一条从上往下咬合的块链 右栏 块目录,按功能分组,可搜索 容器块(条件、循环、子程序)带一个「嘴部」,子语句落在嘴里——也就是缩进在它内部。 右栏共 8 组: 分组 内容 控制语句 条件分支、当型循环、计数循环、跳出循环、注释 条件与运算 且、或、非、比较、四则运算 数学 math.round / math.abs / math.random / math.tointeger / math.type 变量与数据 声明变量、变量赋值、数组、字符串变量、字符串数组 子程序 定义子程序、返回 键盘 KeyDown / KeyUp / KeyTap / ReleaseAllKeys / IsKeyDown / IsLockKeyOn 鼠标与坐标 MouseDown / MouseUp / MouseClick / IsMouseDown / MoveMouse / MoveMouseBy / ScrollMouse / TouchScreen / ScreenSize 延时与输出 Delay / Log / TypeText / GetUpTime 后续版本新增的命令如果还没归类,会出现在最后的「其他命令」组里,不会找不到。 三种放入方式 拖拽:从右栏拖到画布,落点出现插入线,松手插入到那个位置。拖到容器块的「嘴里」就是放进循环 / 条件内部。 单击:插入到当前选中块的后面;画布上没有选中块时追加到末尾。 返回值函数:IsKeyDown、GetUpTime、math.* 这些不是独立语句,放入后会自动生成一个 result = 函数(...) 的赋值块,光标停在括号里。把左边的变量名改成你要的即可。 改块上的内容 元素 操作 白色字段 单击进入编辑,回车确认,Esc 取消 带下拉箭头的字段 单击弹出候选(存储类型、循环步长、运算符等) 块尾的 + / x 增加一个参数槽 / 去掉最后一个。键盘、鼠标、Log 最多 16 个参数 数组下标小开关 打开后可以填序号,操作数组元素 值块不能单独成句 「条件与运算」和「数学」两组是值块:它们本身不产生动作,只产生一个值。所以不能直接放在语句链上,必须拖进条件槽或数值槽里。 比如「条件且」拖到已经写好的条件上,会用「且」把两个条件连起来——这就是加第二个条件的做法。想给整个条件取反,用「条件非」。 条件槽里的胶囊块可以直接单击中间的运算符切换: 比较块:等于 / 不等于 / 小于 / 小于等于 / 大于 / 大于等于 四则块:加 / 减 / 乘 / 除以 / 整除 / 取余 想整段换成手写表达式:在条件上右键 →「编辑这段表达式…」。 完整例子:连点 10 次、每次间隔 50ms 从右栏拖入「计数循环」,块面默认是 i = 1 到 10,保持不动; 从「鼠标与坐标」组把「MouseClick」拖进循环的嘴里; 单击块上的按钮参数,改成 1(左键); 再从「延时与输出」组拖一个「Delay」进嘴里,填 50; 点工具栏编译检查语法,再点验证试跑。 切回文本模式,看到的就是: for i = 1, 10 do MouseClick(1) Delay(50) end 加个条件:按住才连点 想让它「按住某个键时才继续」,需要条件分支 + 值块: 拖入「当型循环」,默认条件是 true; 从「键盘」组拖「IsKeyDown」到画布,它生成 result = IsKeyDown(...)——删掉这一句,改用另一种方式:直接把「条件与运算」里的比较块拖到循环的条件槽里; 比较块左边的槽填 IsKeyDown("lshift")(右键「编辑这段表达式」可以直接写),运算符选「等于」,右边填 true; 循环嘴里放 MouseClick 和 Delay。 对应的文本: while IsKeyDown("lshift") == true do MouseClick(1) Delay(50) end 这种写法不需要 ESC 兜底,条件不成立自己就退出了——比 while true 安全。 什么时候该切回文本 脚本里出现图形模式不支持的写法(切换会被拒绝,会告诉你哪一行); 需要精调表达式(右键「编辑这段表达式」也能写,但长的还是文本模式舒服); 从别处拷来的脚本想先看一眼再改。 两边改的是同一份东西,不存在「图形模式下写的不算数」这种问题。
  • 调试三件套:编译、验证、Log

    脚本教学 调试方法
    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),或者中途触发了别的宏。也可能是目标程序弹了模态窗口把输入吞了。 同样的脚本,今天能跑明天不能。 检查场景是不是被切走了;或者绑定的触发键被别的软件占用了。 改了脚本但行为没变。 改完要重新编译、重新烧录。只编译不烧录,硬件里跑的还是旧版本——这是最高频的「明明改了却没生效」。
  • 延时精度与宏时长预算

    脚本教学 延时精度
    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 键码对照表

    脚本教学 函数表
    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 在程序看来完全不同——某些软件只认其中一个。
  • 按住连发与三种触发方式的组合

    连点定时 触发方式
    1
    0 赞同
    1 帖子
    6 浏览
    A
    同一个脚本,换一种触发方式,行为完全不同。很多人以为宏没生效,其实是触发方式选错了。这篇把三种类型和它们的组合讲清楚。 三种触发类型 类型 什么时候开始执行 什么时候停 按下触发 按键按下的瞬间 脚本跑完自然结束;中途按终止键(默认 ESC)可中断 松开触发 按键松开的瞬间 同上 按下触发松开中断 按键按下的瞬间 松开手指的那一刻立即停止;也支持终止键 关键差别只在最后一行:前两种是「跑完为止」,第三种是「按住多久跑多久」。 各自适合什么 按下触发 —— 一次性动作。输入一段地址、执行一串快捷键、点几下固定位置。按一下,跑完,结束。 松开触发 —— 需要「按下的过程本身有意义」时用。典型是游戏里的蓄力、按住拖拽:按住阶段是手工控制,松开的瞬间才需要宏补一串动作。 按下触发松开中断 —— 持续型动作。连发、按住刷、按住跑循环。这是连点场景的正确选择。 单键两个宏的两种组合 一个键可以同时绑两个宏:按下宏和松开宏。它们有两种组合方式: 组合一:【按下触发,松开触发】 按下执行宏 A(会完整跑完),松开执行宏 B。 按下 → 宏 A 开始执行 ──────→ 执行完 ↓(如果这时还按着,松开会触发 B) 松开 → 宏 B 开始执行 适合「正向 + 反向」的一对动作。比如 A 是「选中到列尾」,B 是「回到列首」——先把 A 跑完,再按一次返回。 组合二:【按下触发松开中断,松开触发】 按下执行宏 A,松开立即中断 A,然后执行宏 B。 按下 → 宏 A 开始执行 ──┐ ↓(松手) 松开 → 中断 A ───────→ 执行 B 适合「按住持续、松手收尾」。比如 A 是连发,B 是「停止后补一次单击」——松手的瞬间把连发掐掉,立刻补一个干净的单点。 实际例子:连发 + 松手补点 按下宏(连发): -- 按下宏:按住期间持续连点 while true do MouseClick(1) Delay(30) end 松开宏(补一次): -- 松开宏:松手后再点一次,保证最后一下是完整点击 Delay(10) MouseClick(1) 触发方式选 【按下触发松开中断,松开触发】。这样按住是连发,松手的瞬间连发被掐断,紧接着补一个完整点击——不会出现「松开时正好点到一半」的情况。 三个必须知道的前提 1. 触发键不能是被宏操作的键。 用左键做触发键,宏里又点左键,会自己触发自己,结果是无限递归。连发类宏一律绑侧键或键盘键。 2. 鼠标和键盘的快捷键不通用。 设备类型选的是「插在盒子上的那个设备」。插的是鼠标,配的却是键盘组合键,切换不会生效——不是坏了,是它压根没收到。 3. 终止键要配手边能按到的。 默认是 ESC。如果你插的是小键盘或者只用鼠标,ESC 可能按不到,去 偏好 → 宏中止按键 换成有的键。这一步建议在第一次烧录前就做,尤其是写 while true 的时候。 场景也是隔离的 10 个场景互相独立。同一种触发方式,在不同场景里可以是完全不同的宏。 设了场景切换快捷键之后,切换是纯硬件完成的——不经过电脑上的软件,也不需要软件在后台跑。所以「办公场景」和「晚上场景」可以各有一套绑定,切换一下整套都变。 排查「宏不动作」时,场景是一个高频原因:你以为在场景 1,其实停在场景 3。
  • 可控频率连点器:从死循环到带抖动

    连点定时 循环结构
    1
    0 赞同
    1 帖子
    8 浏览
    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 注意两点: 回报率是天花板。设备最高支持 1K(1000Hz),即最小间隔 1ms。写 Delay(0) 也不会比这更快。 很多程序接不住这么快的点击。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脚本」,输出窗口会打出真实数字。这是唯一能确认「你以为的频率」和「实际频率」是否一致的方法,比拿秒表数强。