跳转至内容
  • 常见报错与处理

    键鼠助手5.0 疑难解答 报错处理
    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,跑; 次数改大,跑; 加条件,跑; 最后才烧进硬件。 每一步都只改一个变量。这样出问题时,原因一定是「刚改的那一处」。
  • 编译通过但设备不动作:排查清单

    已固定 键鼠助手5.0 疑难解答 故障排查
    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 鼠标 触发键 + 触发类型: 场景编号: 脚本原文 + 编译输出: 现象:第二栏变绿吗?目标窗口是什么软件? 这五项写全,问题基本一眼能看出来。只写「不能用」的帖子,谁也帮不上。