跳转至内容
  • 版块
  • 最新
  • 标签
  • 热门
  • 世界
  • 用户
  • 群组
皮肤
  • 浅色
  • Brite
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • 深色
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • 默认(Flatly)
  • 不使用皮肤
折叠
品牌标识

ByteOHM 社区

A

admin

@admin
administrators
取消关注 关注
关于
帖子
38
主题
34
分享
0
群组
1
粉丝
0
关注
0

帖子

最新 最佳 有争议的

  • 通用设备升级工具 v1.05(Windows)下载与使用说明
    A admin
    下载中心

    通用设备升级工具 v1.05 使用说明

    下载 通用设备升级工具 v1.05(Windows x64,9.91 MiB)

    文件名 CommonDeviceUpdater_v1.05_release.zip · 10,386,841 字节

    Windows 10 / 11,64 位。绿色免安装,解压即用。

    一个只有一页的小工具:插上设备就能看到它的状态、给它升级固件,也能给工具自己升级。界面上那几个按钮就是全部功能,没有菜单、也没有设置页。

    通用设备升级工具 v1.05 界面:标题栏与「软件版本」行显示 1005 (v1.05_release);设备未插时信息表只填这两行,底部显示「未连接设备」

    一、第一次使用

    1. 解压整个文件夹,双击 common_device_updater.exe(只把 exe 单独拿出来用不了)。
    2. USB 插上设备,等 1~2 秒,上半张表自动填好。
    3. 看窗口底部:显示「设备已连接」(前面一个绿点)就说明认到了。

    系统要求:Windows 10 / 11,64 位。不需要安装,不需要管理员权限,也不需要另外装任何运行库。

    这份包配的是 RS232 / RS485 串口键盘。其他产品会单独发一份,别混用。

    二、界面怎么看

    行 含义
    软件版本 工具自己现在的版本
    固件版本 设备里固件的版本号
    设备 ID 这台设备的编号,报给技术支持时报这个
    设备类型 设备型号
    运行模式 「应用」= 正常可用;「引导程序」= 停在升级模式,拔插一次重新上电就会回到「应用」
    授权状态 「已授权」绿字可用;「未授权」红字需要激活

    三、给设备升级固件

    1. 设备插好,确认底部显示「设备已连接」。
    2. 点「检查固件更新」。
    3. 有新版本会弹窗问你要不要升(会显示设备当前版本和服务器上的版本),点「是」。
    4. 等进度走到 100%,设备会自动重启,几秒后重新出现在表里。

    要注意的:

    • 全程别拔线。中途拔了会提示「设备已断开,升级已中止」,重新插上、确认运行模式回到「应用」,再点一次就行。
    • 已经是最新版会直接告诉你,不会重复升级。
    • 万一升级中断、设备停在「引导程序」:拔插一次重新上电,再点一次「检查固件更新」。

    四、升级工具本身

    点「检查软件更新」,不需要连接设备。有新版本会自动下载,然后窗口消失几秒、再自己打开——这是它在替换自己,不是崩溃。

    升级不会动你的设置,下次打开照旧用。

    五、激活设备

    授权状态是「未授权」时要激活:

    1. 把激活码填进输入框(16 位,带不带 - 都行)。
    2. 保持「自动激活」勾选,插上设备,工具会自动完成激活。
    3. 也可以随时手动点「激活设备」。

    几点提醒:

    • 已经激活过的设备会提示「无需重复激活」。
    • 激活码不会保存,关掉软件再开要重新填一次;想省事就一直勾着「自动激活」。
    • 设备停在「引导程序」时不能激活,先重新上电回到「应用」。
    • 刚插上的头一两秒还没读到设备编号,这时点激活会提示等一下再点。

    六、出问题先看这张表

    现象 怎么办
    双击没反应,或提示缺文件 是不是只拿出了 exe。整个文件夹解压出来再试
    一直显示「未连接设备」 换一根数据线、换一个 USB 口;确认设备本身已通电
    提示「设备长时间没有回执」 拔插重新上电后重试;反复出现请联系技术支持
    运行模式显示「引导程序」 上次升级中断了。拔插一次重新上电
    升级走到 100% 后设备没反应 等几秒;仍不行就拔插上电,看固件版本号是否已经变了
    查询版本失败 / 连不上服务器 检查电脑能不能正常上网,公司网络是不是限制了外网访问
    软件自更新提示「找不到升级程序」 同一个文件夹里少了一个文件,重新解压完整包
    激活提示「码无效」 激活码抄错、或已过期/用尽,请联系提供激活码的人

    七、需要帮助

    在下面留言,写清这四项:设备类型、固件版本、软件版本,以及报错原文(截图更好)。


  • RS232 串口键盘:让只有串口的设备直接「打字」进电脑
    A admin
    博客

    电子秤只有一个 DB9 口,检测仪只会往串口吐 ASCII,老 PLC 的日志只能在串口助手的窗口里滚动。可这些数据最后都要落到 Excel 的一列、网页的一个输入框、ERP 的单号栏里——那些地方只认键盘。

    这块小板子补的就是这一段:串口来什么字符,电脑上就打出什么字符,光标停在哪就打到哪。它替代的是 CH9329 这类固定协议的串口转 HID 芯片,区别在于协议、节奏、字符映射都可以按现场调。

    RS232 串口键盘的接线与供电

    一、它是什么

    项 说明
    输入 RS232(TXD / RXD / GND),默认 9600 8N1、无流控
    输出 USB HID 键盘,插上即用、免驱
    主控 CH32X033F8P6
    供电 USB 5V,或端子 +12V 脚接 5~30V,二选一
    形态 板载 USB-A 公头,直接插在电脑的 USB 口上;也可以配一条延长线放到桌面
    固件 支持 USB 在线升级,不用拆壳、不用接调试排针

    对外只有两个口:一头是 4 针端子(接设备),一头是 USB-A 公头(插电脑)。中间是电平转换和一颗单片机,信号路径很短:设备的 RS232 → 电平转换 → 单片机 → USB 键盘 → 电脑。

    二、几个用起来才发现的差别

    1. 一个字符都不丢

    设备发数据是一口气灌过来的,电脑那头却只能一个字一个字地敲,中间的落差必须有人接住。这板子把落差全接在自己身上:先把数据收下来排队,再按电脑能接受的速度一个个送出去。

    实测:一次性灌 456 个字符,屏幕上就是 456 个,一个不少;连续输出时速度稳定,中间没有掉字。

    2. 大小写不会被 CapsLock 带翻

    物理键盘上 CapsLock 亮着按 A 出的是 a。本设备会读主机下发的键盘灯状态,CapsLock 开着时就对字母键取反 Shift——不管 CapsLock 什么状态,设备发 ABC,屏幕上就是 ABC。只动 a–z,!@#$ 这类符号键不受影响。

    3. 一个字符 2 ms

    USB 键盘每 1 ms 被电脑问一次「有没有键按下」。一个字符必须占两次回答——按下、松手,否则电脑会以为这个键一直没松开——所以上限就是 2 ms/字符,约 500 字符/秒。

    这个节奏不是靠延时凑出来的:上一帧被取走,下一帧才发。真机抓包实测 1.998 ms/字符(456 个字符用了 910.9 ms),已经贴着理论极限。

    4. 能把睡着的电脑叫醒

    PC 睡下之后串口又来数据,设备会主动驱动一次 resume 把 PC 叫醒,醒来那段字照常打完。用在没人值守的工位、夜间自动出单的产线上很实用。

    前提只有一个:Windows 设备管理器里勾上「允许此设备唤醒计算机」。设备本身不睡——数据源是串口,一停就丢字节。

    5. 一颗灯看懂串口

    板上那颗灯就是个信号灯,接在串口线上,不归程序管:

    现象 含义
    灭 串口线上没有数据,这是默认状态
    不规律地闪 设备正在往串口发数据

    插上 USB、但对面没发数据的时候,它也是灭的——所以这颗灯不能用来看「USB 通没通」。它的用处是接线和排障:让设备发一行,灯闪了说明信号确实进到板子上了;灯不闪,问题就在接线或者波特率那头。

    6. 能在线升级

    现场要改波特率、改键位,发个新固件过来,插一次 USB 就能刷,不用拆壳、不用接调试排针。升级途中断过电也不要紧,重新上电还能再刷一次。

    三、接线与供电

    端子是 4 针,认信号名比认脚号靠谱(不同批次的端子脚序可能不同,以板上丝印为准)。接线只有一条规矩:收发交叉——本板收的那根,接设备发的那根;本板发的那根,接设备收的那根。

    端子丝印 接设备的 方向 说明
    RXD 设备的 TXD 设备 → 板 设备往外发数据的那根,必接
    TXD 设备的 RXD 板 → 设备 板子回发 ACK / 日志时才接,可选
    GND 设备的 GND — 两边共地,必接
    +12V 电源正极 供电 5~30V

    最少三根线就能跑:RXD、GND,加一路供电。

    设备那头是 DB9 的话:3 脚是它的 TXD(接本板 RXD),2 脚是它的 RXD(接本板 TXD),5 脚是 GND。

    供电有两种接法

    • 只插 USB:电脑的 5V 直接给板子供电,适合桌面调试、临时接一台机器。
    • 只接端子 +12V:用设备自带的那路 5~30V 供电,USB 只走数据。适合设备本身有电源、不想再多插一根线的现场。
    • 两路同时接也没问题,板上做了隔离,不会互相倒灌。

    一个要提醒的点:板上是线性稳压,输入电压越高,它自己发热越大。12V 输入时耗散约 0.2 W,摸上去微温;如果长期接 24V 以上,装壳前先摸一下稳压器的温度。整板 3.3V 侧电流约 25 mA,对设备那路电源的带载要求不高。

    四、第一次用,五步

    1. 接线:设备 TXD → 端子 RXD,GND → GND,再给一路供电。(要回发 ACK 才把设备 RXD 接到端子 TXD。)
    2. 插 USB:设备管理器里多出一个键盘设备;随便敲两下能出字,说明枚举成功。
    3. 把光标放好:打开记事本,或者点进 Excel 的单元格、网页的输入框。
    4. 让设备发一行:电子秤按「打印」,仪器手动触发,或者拿 USB-TTL 从另一台电脑发一句 Hello。指示灯会跟着闪几下,屏幕上应当逐字出现 Hello,行尾自动回车。
    5. 验一下大小写(可选但值得):打开 CapsLock 再发一次 Hello,仍然应该是 Hello 而不是 hELLO。

    五、能打出哪些字符

    类别 说明
    英文、数字、标点 可打印的 ASCII 字符全部支持,包括空格和所有符号
    控制字符 制表符、退格、回车、换行、Esc、Del 都支持
    换行 收到「回车 + 换行」只回车一次,不会多空一行
    打不出 中文、emoji、图片、二进制数据

    也就是说:ASCII 文本一个字符不漏;中文、图片这类内容本来就不是键盘能表达的东西。如果对端发的不是文本,而是「每个字节对应一个按键」的自定义协议,也能按你的字节表出键,这种要单独对一下表。

    六、参数速查

    参数 默认值 备注
    串口 9600 / 8N1 / 无流控 必须与设备侧一致;其它波特率可另配
    行尾判定 收到回车换行,或停顿 20 ms 设备不发换行时靠停顿切行
    缓冲 可吸收约 4 秒的连续数据 9600 bps 的速度下
    输出速度 约 2 ms/字符(约 500 字符/秒) 上限由 USB 键盘的节奏决定
    设备身份 标准 HID 键盘,产品名 STREAM_KEYBOARD_R1 免驱,不用装任何东西
    固件版本 v1.02 可在线升级

    七、出问题先看这张表

    现象 先查什么
    一个字都不出 让设备发一行,看指示灯闪不闪:不闪,查接线(RXD 有没有接到设备 TXD、有没有共地)和波特率;闪了,查 USB 有没有被认成键盘、光标在不在输入框里
    出乱码 对端不是 9600 8N1;或对端在发二进制,而这是文本模式
    偶尔丢字 对端是不是在满速连着灌数据
    字母大小写全反 主机的 CapsLock 指示和屏幕上的状态是否一致
    少打或多打回车 对端的行尾是单回车、单换行,还是回车加换行
    打字被截断、黏在一起 对端字符之间停顿太久,一行被切成了两段
    指示灯一直不亮 串口线上确实没信号:设备没在发,或收发没交叉、没共地

    八、能按需定制

    项 说明
    波特率 默认 9600,其它速率可另配
    键盘布局 目标系统是德语、法语、西班牙语等布局时,字符表要跟着换
    自定义协议 对端发「每字节一个键」的二进制协议,而不是文本
    线束与接口 端子插头、线长、DB9 转接,按现场做

    用下来最省事的地方其实是「不需要装任何东西」:不管目标是记事本、Excel、浏览器里的表单,还是车间那套只能键盘录入的老 ERP,设备只管打字,宿主软件完全不用改。

    有接线对不上的、或者想要某种特殊映射的,在下面留言。


  • KVM 切换器 v1.04 资源汇总与使用指南
    A admin
    KVM 切换器

    KVM 切换器的上位机与使用指南都集中在这一帖:下载、连接、激活、切换快捷键、升级固件,按顺序往下看就能跑通。
    更细的排错条目在附件里的完整指南中,本页也保留了高频问题。

    下载清单

    # 分类 文件名 平台 大小
    1 上位机 KVM_Software_v1.04_release.zip Windows 10 及以上,64 位 21.89 MiB
    2 说明文档 KVM_Switch_Guide_v1.03.md 全平台通用 8.38 KiB

    上位机

    KVM_Software_v1.04_release.zip

    KVM 切换器的 Windows 完整发布包,解压即用、无需安装。包含主程序 KVM配置工具.exe、自带更新器 updater.exe 和 Qt 6 运行库。

    • 适用系统:Windows 10 及以上,64 位
    • 对应版本:v1.04(程序里「软件版本」显示 1004;本版起内置服务器地址换成 https://us.byteohm.com,老版本升级到本版后自动生效)
    • 免驱:设备是标准 HID 复合设备,插上就能被识别,不需要装任何驱动
    • 程序为单实例,重复双击不会开出第二个窗口

    下载 KVM_Software_v1.04_release.zip(21.89 MiB)

    注意事项

    • 整目录解压后再运行,不要把 KVM配置工具.exe 单独拖出来 —— 它和同目录的 Qt 运行库必须在一起,否则一启动就报缺 DLL。
    • 首次运行 Windows SmartScreen 可能拦截,点「更多信息 → 仍要运行」。程序没有做代码签名,这是正常的。
    • 若提示缺 VCRUNTIME140.dll,到微软官网装 VC++ 2015–2022 x64 运行库。

    说明文档

    KVM_Switch_Guide_v1.03.md

    上位机的完整使用指南(Markdown),涵盖界面每一处的含义、激活与升级的完整流程、快捷键配置规则和排错清单。建议先扫一遍再动手。

    下载 KVM_Switch_Guide_v1.03.md(8.38 KiB)

    可用的编辑器:Typora、VS Code 或任意 Markdown 阅读器直接打开。

    使用指南

    一、这个工具能做什么

    上位机通过 USB 和 KVM 切换器通信,一共四件事:

    功能 在哪里 说明
    看设备信息 「设备信息」卡片 软件版本、固件版本、设备标识(CUID)、授权状态
    配主机切换快捷键 「主机切换配置」卡片 键盘组合键、鼠标按键/滚轮,写进设备后掉电不丢
    激活设备 底部「激活」按钮 按本机 CUID 向服务端申请证书并烧进设备
    升级固件 / 软件 底部两个升级按钮 固件走「置升级标识 → 设备重启进 bootloader → 分页烧录」;软件是换整个程序包

    设备在两路 USB 上行之间切换,切过去之后键盘鼠标(以及挂在 KVM 下游的设备)就跟到另一台主机上。
    上位机只负责配置与升级,切换动作本身由设备完成,电脑上不需要常驻任何程序。

    二、第一次连接

    1. 整目录解压,双击 KVM配置工具.exe;
    2. 把 KVM 切换器切到当前这台电脑 —— 设备只在它当前接入的那台主机上枚举,切到另一台时这边看不到它;
    3. 窗口只有一屏(固定 620×400,不支持拉伸),「设备信息」卡片里应当依次出现:
    • 软件版本:上位机自身版本,v1.04 显示 1004;
    • 固件版本:从设备读到的固件版本,未连接或还没应答时是 —;显示 Bootloader 表示设备停在升级模式;
    • 设备标识:这台设备的唯一 ID(CUID),点右侧复制图标或右键数值即可复制;
    • 授权状态(标题行右侧胶囊):已授权 / 未授权 / —(还没读到,不会误报成未授权)。

    三格全是 — 时:先确认设备没被切到另一台电脑,再换个 USB 口重插一次。

    三、激活设备

    新设备第一次用,胶囊显示 未授权,底部会出现「激活」按钮(已授权的设备不显示这个按钮)。

    1. 确认设备已连接、已经能读到设备标识;
    2. 点「激活」,状态栏提示「正在申请激活证书…」;
    3. 成功后提示「激活成功」,胶囊转绿显示 已授权。
    • 「激活失败:Device is not authorized」= 这台设备的 CUID 还没登记在授权台账里,把设备标识发出来补录后重试;
    • 激活证书存在设备里,换电脑、重装系统都不用重新激活。

    四、配置主机切换快捷键

    「主机切换配置」卡片里有两行:Keyboard(键盘)和 Mouse(鼠标)。点行里的按钮,在弹出的「快捷键设置」里按键即可;只配一个、两个都配都可以。

    类型 可以设成什么
    键盘 单键或组合键(如 Ctrl+Alt+1)
    鼠标 左键 / 右键 / 中键 / 侧键(X1、X2),或滚轮向上 / 向下
    • 点 Burn(烧录) → 把界面上的两条快捷键写进设备,提示「烧录成功」;
    • 点 Load(加载) → 反过来,把设备里当前生效的快捷键读回界面。

    建议先 Load 看一眼出厂值再改,改完烧录,然后直接按一下验证。

    两条规则:

    • 设备对切换做了防抖:两次切换间隔不到 1.5 秒的按键会被忽略,连按不会疯狂来回切;
    • 快捷键在设备侧识别,两台主机上都生效,不依赖任何软件。

    五、升级固件与软件

    在线升级固件(推荐)

    点「在线升级固件」→ 程序查服务端版本(没有更新会提示「固件已是最新版本」)→ 有更新则弹窗显示当前/最新版本 → 下载并校验 SHA-256 → 让设备写升级标识 → 设备自动重启进 bootloader 并以升级模式重连 → 分页烧录 → 提示「固件升级成功」。

    • 全程不要拔线;中途失败再点一次「在线升级固件」即可重试,不用重装软件;
    • 升级期间整排按钮会变灰,防止并发下发协议;进度长时间不动时 60 秒后按钮自动放开。

    在线升级软件

    点「在线升级软件」,确认后下载新包并校验,然后拉起 updater.exe 覆盖安装、自动重启主程序。软件升级不需要连接设备。

    离线升级固件(维护入口)

    在页面空白处连续点击 10 次,底部会多出「离线升级固件」按钮,选本地 .bin 后走与在线升级相同的烧录流程。
    它不做版本比较,选了就烧,请确认文件名与版本 —— 平时隐藏就是为了避免误触。

    卡在 Bootloader 怎么办

    固件版本显示 Bootloader、授权状态 —,说明设备停在升级模式没回到应用态:直接点「在线升级固件」走完流程,或拔插一次 USB 让设备重新上电。反复失败就换 USB 口、换线,避开 Hub。

    常见问题

    提示「应用运行中」
    程序是单实例的,托盘里可能还留着上次的进程。右键托盘图标退出,或到任务管理器结束 KVM配置工具.exe 后重开。

    烧录成功但按键没反应
    先用 Load 确认设备里存的确实是这组键;确认按的时候设备在当前主机上;两次按之间隔 1.5 秒以上。

    升级提示「设备未以升级模式重新连接」
    设备升级时会先断开再以 bootloader 枚举。一直等不到多半是通道变了(设备跑到另一台主机上)或线接触不良,重新插拔后重试。

    窗口拉不大
    按 620×400 固定排版,不支持拉伸,属于设计如此。

    换了电脑要不要重新激活
    不用。证书在设备里,跟电脑无关。

    反馈

    在本帖下回复即可,附上这四项定位最快:

    1. 「软件版本」和「固件版本」两个数字;
    2. 设备标识(点复制图标粘贴过来);
    3. Windows 版本;
    4. 具体报错文案或截图。

    上手顺序

    1. 下载上位机,整目录解压,双击 KVM配置工具.exe;
    2. 把设备切到这台电脑,确认「设备信息」三项都读到了;
    3. 未授权就点「激活」;
    4. Load 看一眼出厂快捷键,改成自己顺手的组合,Burn 烧进去,按一下验证;
    5. 想要新固件就点「在线升级固件」,想换新版软件就点「在线升级软件」。

  • 键盘采样:让盒子认识你那把键盘
    A admin
    键鼠助手5.0 设备固件 键盘采样

    盒子夹在电脑和键盘之间:电脑看到的是盒子,你的按键要先经过盒子转一手才能到电脑。这一手能不能转对,取决于盒子知不知道你这把键盘的报文长什么样。

    多数键盘用标准格式,盒子自带的那套就够。但另一类键盘不一样:全键无冲用位图、把修饰键和键码拆成两个 report、自己加了 report ID、或者把功能键丢在另一个用途页里。碰上这类键盘,默认格式对不上,键就转不过去。

    键盘采样就是给这类键盘用的:采一次,盒子以后按你这把键盘的格式来。

    能解决什么问题

    出现下面这些症状,先试采样:

    症状 具体表现
    某些键完全不认 按了电脑没反应,别的键都正常
    按住不放变成连击 按住 Shift 走出来一串 Shift,按住方向键光标乱跳
    组合键只过去一半 Ctrl+C 到电脑只剩 C,Ctrl+Shift+Esc 只出一个键
    功能键、多媒体键失效 主键区正常,上面一排或者侧键不通
    换了键盘就出问题 上一把键盘好好的,换这一把就不对

    如果整把键盘都不工作、设备根本识别不到,那不是采样的范围,见《设备识别、固件更新与恢复》。

    做完之后是什么效果

    • 盒子换成你这把键盘的身份:VID/PID、报文格式都跟着它走,电脑那边认到的就是这把键盘。
    • 状态行显示 Mode: 透传 表示生效了。显示「固定」说明连的还是盒子自己的身份,采样没起作用。
    • 宏不用改。 脚本里的 KeyTap("a") 还是 KeyTap("a"),变的是这一下按键最终以什么格式发出去,采完不用回去改脚本。
    • 可以存下来复用。 采样结果能导出成 .kmps,换机器、恢复出厂之后导回去,不用重采。
    • 采样只读键盘自报的身份信息,不记录你按过的任何键。

    操作前先确认

    条件 说明
    设备要支持 仅新设备具备这个能力,老设备点了不会有回应
    设备已激活 未激活的设备不执行采样,直接回错误码 -8
    键盘插在盒子上 采样时盒子要能枚举到它,插在电脑上采不到
    用键鼠透传程序 采样按钮在键鼠透传里,不在键鼠助手主程序里;两个程序装在同一目录

    之前手填过 VID/PID(见《USB 协议自定义》)的,采样之后以采样结果为准,手填的那两个值会被覆盖。

    操作步骤

    1. 打开键鼠透传。 与键鼠助手同目录的另一个程序。
    2. 按压按键。保持按压状态把键鼠透传设备插入电脑。
    3. 连接设备。 第一次连不要勾「仅连接」——此时盒子还是它自己的身份,全枚举就能找到。
    4. 点底部的「KM 采样」。 按钮变成「采样已发出」,等回包。
    5. 看结果。 成功时会提示 采样设备: VID xxxx / PID xxxx,同时这对 ID 自动填进连接条的 VID/PID 框,并自动勾上「仅连接」——设备重启后已经换了身份,不点名就找不到了。(部分设备不会填入VID/PID,可以忽略这个,不影响纯硬件宏使用,只是无法通过软件API调用键鼠事件)。如果没有弹出VID/PID框,也不需要上位机调用,如果想再试连接,重复第2步。如果需要上位机调用,可以换个其它的键鼠设备尝试一下,一般支持板载宏的键鼠都支持,但是并不代表不支持板载宏的键鼠就不支持,只是概率会小很多。
    6. 手动点一次「连接」。 采样成功后设备会重启,此时链路是断的。
    7. 确认模式。 连接条状态行显示 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 与字符串描述符》;
    • 版本信息、固件更新与恢复:见《设备识别、固件更新与恢复》。

  • 键鼠助手 Lua 宏脚本合集 · 目录
    A admin
    键鼠助手5.0 新手指引 脚本教学

    这个版块里目前有 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,插小键盘或只用鼠标的话可能按不到。

    遇到问题先看第二栏。 按下触发键,状态栏第二栏变绿说明宏在跑,问题在输出端;不变绿说明触发没进来。这一条能把排查范围砍掉一半。


  • 连招与技能循环的时间轴写法
    A admin
    键鼠助手5.0 单机游戏 连招时序

    连招的本质是一条时间轴:每个动作在什么时刻按下、间隔多久。宏做这件事的能力恰好够用——它能精确控制时间,但完全不知道技能有没有放出去。

    适用范围:仅单机 / 离线 / 自带训练场。不适用于任何联机对战模式。

    最小版本:顺序 + 间隔

    -- 三段连招
    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;
    • 目标在不在范围;
    • 有没有被打断;
    • 蓝量够不够。

    它只会在设定的时刻按下设定的键。所以这类脚本的正确用法是:站好位置、确保资源充足、然后把时间轴跑一遍。跑的过程中出任何意外,它都会继续往下按——这就是必须有人看着的原因。

    想做到「按情况调整」需要读游戏状态,那不是这套硬件的活。


  • 重复采集与刷素材的循环宏
    A admin
    键鼠助手5.0 单机游戏 循环结构

    单机游戏里最值得交给宏的是「节拍固定、路线固定」的重复劳动:走一段、交互、等动画、再走。这篇讲怎么写稳。

    适用范围:仅单机 / 离线 / 自带训练场。不适用于任何联机对战模式。

    分解成四段

    任何一个采集循环都能拆成:

    移动 → 交互 → 等待 → 回到起点
    

    关键是每一段的时长都必须能从游戏里量出来,不能靠估。

    • 移动:按住 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()
    

    三处细节:

    1. KeyUp("w") 之后那 120ms 不能省。角色停下来有减速过程,移动中按 E 可能不触发交互。
    2. 末尾 ReleaseAllKeys() 是兜底。万一中途按了终止键,w 会一直按着,角色会一直走。
    3. 每段移动都加抖动。固定周期的输入节奏太规律,某些游戏的风控会把完全等间隔的操作标记成异常(单机游戏也可能有在线反作弊组件)。抖动幅度不用大,±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();中断键随手能按到

    别做的事

    • 不要指望宏处理「意外」。掉线、加载、随机事件、怪物打断——它一个都处理不了。这就是为什么这类脚本必须有人看着。
    • 不要用它绕过游戏的付费或进度设计。刷素材和刷货币是两件事,前者是省时间,后者可能违反游戏规则甚至用户协议。
    • 不要在联机模式下开。单机游戏常常带联机功能,模式切错了性质就变了。

  • 单机游戏宏的边界:能做什么、不能做什么
    A admin
    键鼠助手5.0 单机游戏 内容边界

    先说结论:单机、离线、自带训练场的场景可以做,联机对战的一律不做。 这条线不是道德姿态,是两件不同的事。

    为什么单机和联机是两回事

    单机游戏里用宏,影响的是你自己的游戏体验。它和「开修改器」「用控制台刷材料」是同一类行为——加快你本来就要做的重复劳动,没有第二个玩家因此受损。很多单机游戏本身就内置了宏、脚本、自动化模组支持。

    联机对战里用宏,影响的是同一局其他玩家的胜负。而且硬件盒子的输入由独立 HID 设备发出,反作弊读不到进程,它绕过的正是公平竞技赖以成立的那道检测。

    同样是「按下键自动执行一串动作」,一件事只涉及你自己,一件事涉及不知道你存在的人。所以边界画在这里。

    能做到什么

    硬件盒子只做输出,不看屏幕、不读内存。所以它能做的是**「固定的动作序列」**:

    能做 例子
    固定路线的移动 按住 W 前进 1.2 秒,松开,按 E,等 0.9 秒,循环
    重复采集 / 刷素材 同一套动作重复 50 次,中间加随机抖动
    菜单导航 打开背包 → 切到第三页 → 选中 → 确认
    技能循环 按固定顺序和固定间隔施放技能
    训练场连招练习 把一套连招的时间轴固定下来,反复练手感
    挂机式重复劳动 挖矿、钓鱼、跑商这类节拍固定的动作

    做不到什么

    做不到 为什么
    看到敌人自动开枪 需要读画面或读内存,硬件没有这个通道
    血量低了自动喝药 同上,判断不了血量
    捡起指定物品 判断不了地上是什么
    见招拆招 需要根据对方动作实时决策
    自动寻路到指定坐标 只能按固定路线走,走歪了它不知道

    任何声称「能看画面」的宏,要么是假的,要么跑在电脑上(读内存 / 截图分析),不是这套硬件。 别被这类说法带跑——买了硬件发现做不了,是你自己的损失。

    适用范围声明怎么写

    发单机游戏相关的脚本时,正文开头加上这一段,说清楚边界:

    **适用范围**:仅单机 / 离线 / 自带训练场,不适用于任何联机对战模式。
    **依赖**:固定路线或固定节拍。游戏更新导致地图、技能改动后可能需要重新调整。
    **风险**:使用前请确认该游戏对自动化的态度;部分单机游戏也有反作弊,联机功能开启时请关闭宏。
    

    第三行不是客套。现在很多单机游戏带在线模式(联机合作、排行榜、赛季),一旦在联机状态触发这类宏,性质就变了。玩之前先确认自己处在什么模式。

    一个现实提醒

    单机游戏宏的寿命通常比想象中短:

    • 地图改了路线就废;
    • 技能数值改了节奏就废;
    • 动画时长调了,等待时间就不对。

    所以写这类脚本的正确姿势是:把「时间」和「次数」全部提到开头当变量,游戏更新了只改顶部几行,不用重写逻辑。

    -- ===== 可调参数 =====
    local ROUNDS    = 30      -- 循环次数
    local WALK_MS   = 1200    -- 每段前进时长
    local COLLECT_MS = 900    -- 采集等待
    local JITTER_MS = 60      -- 随机抖动幅度
    -- ====================
    

    最后

    想拿联机游戏的方案来改?不用问了,这类脚本不发、不写、不讨论——包括改名、缩写、谐音、代号的形式。这条没有例外。

    单机方向的具体写法,看这两篇:

    • 《重复采集与刷素材的循环宏》
    • 《连招与技能循环的时间轴写法》

  • 常见报错与处理
    A admin
    键鼠助手5.0 疑难解答 报错处理

    按出现阶段分四类:编译期、运行期、设备连接、软件崩溃。每类给现象、原因、处理。

    一、编译期

    编译只查语法,所以这一类的报错都指向「写法不合法」。

    报错大意 原因 处理
    意外符号 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 协议自定义》
    无线设备完全收不到输入 接收器没配对 见《无线接收器重绑与格式化》

    四、软件崩溃

    文档里点名的场景只有一个:自动加载宏 + 宏数量过多,表现为启动时崩溃或加载极慢。

    处置流程(照文档原文的顺序):

    1. 拔掉设备;
    2. 打开软件,把「自动加载宏」取消勾选;
    3. 插入设备;
    4. 点击烧录;
    5. 清空所有绑定的宏。

    这套流程能恢复到干净状态。恢复后如果还崩,就不是宏数量的问题了,看下一节。

    五、报错信息怎么贴

    发帖求助时,不要只截一张报错图。需要三样:

    1. 报错原文(可以复制文字,比截图好);
    2. 出错的那一段脚本,不是全部;
    3. 出错时代码在第几行(编译器一般会给行号)。

    如果报错是「运行时才出现」(编译能过、运行崩),加上:触发方式、场景、目标软件、以及能不能用最小脚本复现。

    最小复现脚本是排查里最有价值的东西——把问题从 200 行缩到 3 行,往往自己就看出原因了。

    一个通用的降错顺序

    写新脚本时按这个顺序推进,比写完一起调要快:

    1. 先写一行,编译 + 运行,确认环境通;
    2. 加第一段动作,跑,确认这一段对;
    3. 套循环,次数设成 2,跑;
    4. 次数改大,跑;
    5. 加条件,跑;
    6. 最后才烧进硬件。

    每一步都只改一个变量。这样出问题时,原因一定是「刚改的那一处」。


  • 编译通过但设备不动作:排查清单
    A admin
    键鼠助手5.0 疑难解答 故障排查

    「编译没报错,脚本在软件里也能跑,烧进去按了没反应。」

    这是最多的一类问题,而且几乎都不是代码问题。按下面五条顺序查,基本能定位。

    第 0 步:先看状态栏第二栏

    按一下触发键,看第二栏有没有变绿。

    • 变绿 → 宏在跑。问题在「输出打到了哪里」或「动作本身不对」,跳到第 6 条;
    • 不变绿 → 触发没进来。继续第 1 条。

    这一步能砍掉一半的排查范围,别跳过。

    第 1 条:设备类型选错了

    宏绑定页的「设备类型」选的是插在盒子上的那个设备,不是你手上按的那个。

    • 盒子插的是鼠标,这里选「键盘」→ 不生效;
    • 盒子插的是键盘,这里选「鼠标」→ 不生效。

    判断依据:触发键属于哪个设备。用鼠标侧键触发,就选鼠标;用键盘某个键触发,就选键盘。

    第 2 条:触发键选错了

    • 键盘支持全部 HID Usage 键。弹出列表后可以直接敲键盘快速选中——想绑哪个键就按一下它;
    • 鼠标只支持五键(左、右、中、侧后、侧前)。

    常见的错:想绑「侧键」,结果绑成了「中键」;想绑 F5,结果绑成了 num5(小键盘和主键盘不是同一个键)。

    第 3 条:触发类型不适合这个脚本

    脚本类型 该选
    一次性动作(输入文本、执行快捷键序列) 按下触发
    持续动作(连发、按住循环) 按下触发松开中断
    松开才执行的动作 松开触发

    最典型的错:连发脚本 while true do ... end 绑了「按下触发」。这时脚本会一直跑下去,松手也不停(只能按终止键),用户会以为「卡住了」。反过来,一次性脚本绑了「按下触发松开中断」,手指一松就中断,动作只做了一半——也会被描述成「不动作」。

    第 4 条:场景不对

    10 个场景互相独立。你在场景 1 配的宏,切到场景 3 之后完全不生效。

    看当前是哪个场景,以及场景切换快捷键有没有被误触。这是「昨天能用今天不能用」的最高频原因。

    第 5 条:到底烧录成功了没

    三种常见情况:

    1. 只编译没烧录。改完脚本 → 编译 → 就以为生效了。必须点宏绑定页的烧录,硬件里跑的是烧进去的那一版;
    2. 烧录时设备没连好。状态栏第一栏是红的,烧录不会成功;
    3. 烧的是另一个场景的配置。烧录是对当前场景生效的。

    判断方法:改脚本里一个明显的参数(比如把连点次数从 10 改成 3),重新编译 + 烧录,看行为有没有变。没变说明烧录这一步没成功。

    第 6 条:状态栏绿了但没效果

    说明宏在执行,但按键没打到该去的地方,或者动作本身不是你想要的。

    现象 原因
    按键没反应,鼠标也没动 目标窗口没有焦点。宏只发按键,不切窗口
    文字进去了,但全是数字 / 乱码 TypeText 的小键盘被 NumLock 关掉了,或输入法在中文状态
    按键变成了别的功能 目标软件改过快捷键;或者用了小键盘键而软件只认主键盘键
    动作做了一半就停 延时给少了,后续动作被前一步的未完成状态吞掉
    触发了两次 触发键被宏自己按到了(自我触发),换一个不冲突的键

    第 7 条:终止键的问题

    默认终止键是 ESC。如果你插的是小键盘或者只用鼠标,ESC 可能根本按不到——脚本跑起来之后停不下来,表现是「一直动」。

    去 偏好 → 宏中止按键,换一个手边有的键。写 while true 循环之前,这一步必须做。

    还没解决

    按这个顺序再试一遍:

    1. 重启软件,重新插设备。排除状态问题;
    2. 换一个最简单的脚本(就一行 KeyTap("a"))烧进去试。能用 → 问题在原脚本;不能用 → 问题在设备或绑定;
    3. 关闭自动加载宏,清空所有绑定,从头加一个宏。排除历史配置污染(见《设备识别、固件更新与恢复》);
    4. 换一个 USB 口直插,不经 Hub。

    到这里还不行,去发帖,把这五项写全:

    软件版本 / 固件版本:
    设备类型:键盘 or 鼠标
    触发键 + 触发类型:
    场景编号:
    脚本原文 + 编译输出:
    现象:第二栏变绿吗?目标窗口是什么软件?
    

    这五项写全,问题基本一眼能看出来。只写「不能用」的帖子,谁也帮不上。


  • 无线接收器重绑与格式化
    A admin
    键鼠助手5.0 硬件固件 无线配对

    无线版有两个和有线版不一样的入口:重新绑定接收器和格式化接收器固件。前者是日常维护,后者是危险操作。这篇把两者分清。

    重新绑定接收器:什么时候用

    两个场景:

    1. 接收器换了新的(丢了、坏了、补发了),新接收器和设备之间没有配对记录;
    2. 接收器的绑定信息被清除了(比如误操作、异常断电、固件被重刷)。

    现象是:设备能开机,但电脑上完全收不到输入——因为接收器不认识这台设备。

    操作:偏好 → 无线配对 → 重新绑定接收器。按提示把设备和接收器靠近,等配对完成。

    这一步是可逆的、安全的。配错了再配一次就行,不会损坏任何东西。

    格式化接收器固件:这不是随时能做的

    这个入口是为「需要给接收器烧录新固件」准备的——正常使用完全用不到。

    文档里的原话需要完整读一遍:

    需要烧录新的接收器固件时点击此项;如果烧录的固件有问题导致接收器变砖时,需要使用专用的烧录器才可能会恢复,如果之前烧录时选择的不是 PB11 则无法恢复。

    拆开看,这句话里有三个信息:

    1. 它是给接收器换固件用的,不是修复工具;
    2. 烧坏了会变砖,软件层面救不回来,需要专用烧录器,而且只是「可能」恢复;
    3. 前提条件是有条件的——如果烧录时选的引脚不是 PB11,无法恢复。

    第 3 条是最要命的:它不是「变砖后还能救」,而是「只有当初选对了引脚的那一批才有救」。

    所以,动它之前

    如果你不是明确要烧接收器固件(比如官方给了新固件包并说明了流程),不要点这个按钮。

    真要动,按这个顺序准备:

    1. 确认固件包是为这个接收器型号做的。型号对不上,刷进去就是变砖;
    2. 确认引脚选择。文档只提到 PB11 是可恢复的那一档,其他引脚刷坏了没有救;
    3. 保证供电稳定。刷写过程中断电是变砖的最主要原因,不要用快没电的笔记本、不要插在会松动的 Hub 上;
    4. 不要同时在跑别的宏或烧录。刷写期间设备被别的操作打断,结果不可预期;
    5. 刷完立刻验证:能不能连上、按键有没有反应。

    如果这五条里有任何一条你没法确认,就先别刷。

    变砖了怎么办

    现象:接收器插上后系统毫无反应,或者设备管理器里出现未知设备。

    处理顺序:

    1. 换 USB 口、换线,先排除接触问题(这一步能解决相当一部分「以为变砖」);
    2. 在另一台电脑上试一次,排除本机驱动问题;
    3. 都不行,联系支持,说明:接收器型号、刷的是哪个固件、当时选的哪个引脚、卡在哪一步。这四项决定还有没有救;
    4. 如果当初选的不是 PB11,按文档说法是无法恢复,只能换接收器。

    和有线的区别

    项 有线 无线
    配对 不需要 需要,接收器与设备一一对应
    换接收器 不涉及 必须重新绑定
    刷固件风险 设备端固件,风险较低 接收器变砖可能不可恢复
    排查第一步 换线换口 换线换口 + 确认配对

    日常维护建议

    • 配对信息不要随便清。它不是「重置一下更干净」的东西,清了就得重配;
    • 接收器单独存放。丢了接收器等于设备不能用,而重新配一个接收器比想象中麻烦;
    • 不要为了「试试看」点格式化。这个按钮的代价不对称:点对了没收益,点错了可能报废一台设备。

  • USB 协议自定义:VID/PID 与字符串描述符
    A admin
    键鼠助手5.0 硬件固件 USB

    设备在系统里是怎么被认出来的?靠四个 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 五项。改了之后如果出问题,还能改回来。

    如果改完之后软件彻底找不到设备、连改回来的入口都进不去——这时候需要按「清空所有绑定的宏」那套流程重置(见《设备识别、固件更新与恢复》),或者重新烧录固件。

    一个稳妥的改法

    不要一次改五项。按这个顺序:

    1. 先只改 Product 字符串(纯展示,风险最低)。改完拔插,看设备管理器里的名字变了没。确认这套流程能走通。
    2. 再改 Manufacture。
    3. 最后才考虑动 Vid/Pid——这两个才是有真实后果的。

    改 Vid/Pid 时不要选这几类值:

    • 系统关键设备的 ID(键盘、鼠标、存储控制器,比如 0x046D 罗技、0x045E 微软的常见值);
    • 你机器上已有的其他设备的 ID(会撞);
    • 0x0000 这类明显非法的值。

    只改 Serial 的一个用途

    多台设备插同一台机器时,操作系统通过 Serial 区分实例。如果两个设备的 Vid/Pid 相同、Serial 也相同,系统会认为是同一台设备反复插拔,配置可能互相覆盖。

    给每台设备一个不同的 Serial 就解决了。这是这五项里唯一「改了几乎不会有副作用」的一项(前提是别和其他设备重复)。

    什么时候不用管它

    绝大多数用户不需要动这一页。

    如果你的设备在系统里正常识别、软件正常连接、宏正常烧录,那就保持默认。这不是一个「优化项」,是一个「出问题时才用的开关」。 改它的收益很小,代价是可能把一台好设备弄成需要重置的状态。

    排查:改完不认了

    1. 拔掉设备,等 5 秒,插回;
    2. 看设备管理器里有没有新出现的未知设备 / 带感叹号的设备;
    3. 如果有,说明 ID 生效了但驱动没匹配上——把 Vid/Pid 改回原值;
    4. 如果软件连「关于」页都读不到设备信息,走重置流程:拔设备 → 开软件 → 关闭自动加载宏 → 插设备 → 烧录 → 清空绑定;
    5. 以上都不行,联系支持时把原始 ID 和改成的 ID 一起报上去,这比描述现象有用得多。

  • 设备识别、固件更新与恢复
    A admin
    键鼠助手5.0 硬件固件 固件更新

    设备出问题时,第一件该做的事是把版本信息记下来。这篇讲怎么查、怎么更新、以及出事了怎么救回来。

    先看关于页

    关于页有三样东西:

    项 用途
    软件版本 求助帖必须写
    固件版本 与软件版本可能不同步,升级时要分别看
    设备标识号 右键可复制,是这台设备的唯一标识

    设备标识号一定要先复制存下来。 后面所有需要「证明这是同一台设备」的场合(保修、找客服、恢复配置)都用得上,而它只在这一页显示。

    状态栏三个灯的意义

    栏位 含义
    第一栏 连接状态。红 = 没连上,绿 = 已连接
    第二栏 运行状态。红 = 当前没在跑宏,绿 = 宏正在执行
    第三栏 实时消息

    排查「宏不动作」时,第二栏是最直接的判据:按了触发键,第二栏有没有变绿。

    • 变绿但没效果 → 宏在跑,但按键打到了别的地方(焦点问题)或者动作本身不合预期;
    • 不变绿 → 触发根本没进来(触发键 / 触发类型 / 场景 / 设备类型的问题)。

    这一条能把问题范围砍掉一半。

    检查更新

    关于 → 检查更新,会去服务器看有没有新的软件或固件。

    升级前建议:

    1. 先做一次配置导出(偏好 → 配置 → 导出)。它会把 config 目录打包备份,出问题能导回来;
    2. 记下当前版本号;
    3. 升级完成后重新插一次设备。

    导出这一步不要省。 导入会覆盖当前配置,所以顺序是「先导出再动」,不是「动坏了再导出」。

    自动加载宏:省事但会出事

    偏好里有个「自动加载宏」:软件启动时自动把宏读进来。日常用很方便,但宏数量多了会卡。

    文档里明确写了处理办法,照做即可:

    1. 拔掉设备;
    2. 进偏好,把「自动加载宏」取消勾选;
    3. 插回设备;
    4. 点烧录;
    5. 清空所有绑定的宏。

    这样能恢复到「设备里没有宏」的干净状态。之后再一项项加回去,加到卡为止就知道是数量问题。

    什么时候该关掉它:宏列表很长(几十个以上)、软件启动明显变慢、或者一插设备就崩溃。日常用不到自动加载的话,关着更稳。

    烧录失败怎么看

    烧录是「把配置写进硬件」这一步。它失败时通常表现为:状态栏没有成功提示、重新插拔后宏还在旧状态。

    按这个顺序查:

    1. 设备连接是否正常(第一栏是不是绿的);
    2. 是不是还在上一个宏的编辑状态——先编译通过再烧录;
    3. 换一个 USB 口 / 换一根线。供电不足和数据线劣质是烧录失败的高频原因,尤其经过 Hub 的时候;
    4. 拔掉 Hub,直插。文档提到支持 2.0 USB 集线器同时插键盘和鼠标,但烧录阶段直插更稳;
    5. 还不行就按上一节的「清空所有绑定的宏」走一遍,从空状态重新加。

    关于固件回退

    需要说清楚:设备端固件没有官方文档化的回退流程。

    手上有旧版软件安装包时,装回旧版是可行的(卸载当前版本再装旧的)。但固件不是——固件是烧进设备的,降级需要对应版本的固件包和对应的烧录方式,这一步文档没有覆盖。

    所以对固件的原则是:没有明确需要,不要动。 升级前确认当前版本能用、配置已导出,升级后立刻验证基本功能(连点、按键)是否正常,别等做完一整套宏才发现设备不对。

    一张排查顺序表

    现象 先看这里
    第一栏是红的 线、口、Hub。换线换口先试
    第一栏绿、第二栏不绿 触发键 / 触发类型 / 场景 / 设备类型
    第二栏绿但没效果 焦点在不在目标窗口;输入法状态
    烧录后行为没变 是否真的烧录成功;是否改完只编译没烧录
    一插就崩溃 关掉「自动加载宏」,清空绑定后重来

  • 块编辑器的操作细节
    A admin
    键鼠助手5.0 图形化 块编辑器

    入门那篇讲了怎么拼出一个宏。这篇是操作层面的清单:移动、复制、撤销、缩放、条件追加——都是实际用起来才发现「原来还能这样」的东西。

    移动

    直接拖动块。

    • 拖到别的块之间 = 改变顺序;
    • 拖进容器块的嘴里 = 移进循环 / 条件内部;
    • 拖动过程中按 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 文本,编译、验证、保存、烧录都走同一条链路。

    从图形切回文本时,看到的就是即将运行的文本。块编辑器会做一次规范化排版(缩进、括号、空白),语义不变但换行位置可能与你手写的不同——这是正常现象,不是内容被改动了。

    反过来,从文本切到图形时,如果遇到暂不支持的写法会拒绝切换并指出行号,脚本内容不受影响。


  • 图形化块编程入门
    A admin
    键鼠助手5.0 图形化 块编辑器

    不想写代码也能做宏。图形模式把脚本拆成一块一块,拖着拼起来就行,拼完照样编译、烧录。

    先讲清一件事:图形模式和文本模式是同一份脚本的两种看法。 不是两套东西,也不是「简单版」和「专业版」。你在图形里拖一个块,文本里就多一行;你在文本里改一行,切回图形看到的就是改过的样子。随时可以来回切。

    怎么切过去

    宏编辑页工具栏最右端是编辑形态开关:

    • 左段 </> → 文本模式
    • 右段(叠块图标)→ 图形模式

    点一下右段就切。软件会记住你上次用的形态,下次打开同一个宏自动恢复。

    工具栏左侧的编译和验证两个按钮对两种模式都管用,切到图形模式后不用回文本模式就能检查。

    如果当前脚本里有图形模式暂时不支持的写法,切换会被拒绝——脚本内容不会改动,下方输出窗口会说明是哪一行无法转换成语句块。这种情况继续用文本模式编辑就行,不影响使用。

    界面

    区域 图形模式下的内容
    左栏 宏目录,和文本模式相同,选要编辑的宏
    中栏 块画布。整段宏就是一条从上往下咬合的块链
    右栏 块目录,按功能分组,可搜索

    容器块(条件、循环、子程序)带一个「嘴部」,子语句落在嘴里——也就是缩进在它内部。

    右栏共 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

    后续版本新增的命令如果还没归类,会出现在最后的「其他命令」组里,不会找不到。

    三种放入方式

    1. 拖拽:从右栏拖到画布,落点出现插入线,松手插入到那个位置。拖到容器块的「嘴里」就是放进循环 / 条件内部。
    2. 单击:插入到当前选中块的后面;画布上没有选中块时追加到末尾。
    3. 返回值函数:IsKeyDown、GetUpTime、math.* 这些不是独立语句,放入后会自动生成一个 result = 函数(...) 的赋值块,光标停在括号里。把左边的变量名改成你要的即可。

    改块上的内容

    元素 操作
    白色字段 单击进入编辑,回车确认,Esc 取消
    带下拉箭头的字段 单击弹出候选(存储类型、循环步长、运算符等)
    块尾的 + / x 增加一个参数槽 / 去掉最后一个。键盘、鼠标、Log 最多 16 个参数
    数组下标小开关 打开后可以填序号,操作数组元素

    值块不能单独成句

    「条件与运算」和「数学」两组是值块:它们本身不产生动作,只产生一个值。所以不能直接放在语句链上,必须拖进条件槽或数值槽里。

    比如「条件且」拖到已经写好的条件上,会用「且」把两个条件连起来——这就是加第二个条件的做法。想给整个条件取反,用「条件非」。

    条件槽里的胶囊块可以直接单击中间的运算符切换:

    • 比较块:等于 / 不等于 / 小于 / 小于等于 / 大于 / 大于等于
    • 四则块:加 / 减 / 乘 / 除以 / 整除 / 取余

    想整段换成手写表达式:在条件上右键 →「编辑这段表达式…」。

    完整例子:连点 10 次、每次间隔 50ms

    1. 从右栏拖入「计数循环」,块面默认是 i = 1 到 10,保持不动;
    2. 从「鼠标与坐标」组把「MouseClick」拖进循环的嘴里;
    3. 单击块上的按钮参数,改成 1(左键);
    4. 再从「延时与输出」组拖一个「Delay」进嘴里,填 50;
    5. 点工具栏编译检查语法,再点验证试跑。

    切回文本模式,看到的就是:

    for i = 1, 10 do
        MouseClick(1)
        Delay(50)
    end
    

    加个条件:按住才连点

    想让它「按住某个键时才继续」,需要条件分支 + 值块:

    1. 拖入「当型循环」,默认条件是 true;
    2. 从「键盘」组拖「IsKeyDown」到画布,它生成 result = IsKeyDown(...)——删掉这一句,改用另一种方式:直接把「条件与运算」里的比较块拖到循环的条件槽里;
    3. 比较块左边的槽填 IsKeyDown("lshift")(右键「编辑这段表达式」可以直接写),运算符选「等于」,右边填 true;
    4. 循环嘴里放 MouseClick 和 Delay。

    对应的文本:

    while IsKeyDown("lshift") == true do
        MouseClick(1)
        Delay(50)
    end
    

    这种写法不需要 ESC 兜底,条件不成立自己就退出了——比 while true 安全。

    什么时候该切回文本

    • 脚本里出现图形模式不支持的写法(切换会被拒绝,会告诉你哪一行);
    • 需要精调表达式(右键「编辑这段表达式」也能写,但长的还是文本模式舒服);
    • 从别处拷来的脚本想先看一眼再改。

    两边改的是同一份东西,不存在「图形模式下写的不算数」这种问题。


  • 调试三件套:编译、验证、Log
    A admin
    键鼠助手5.0 脚本教学 调试方法

    宏编辑器里只有三个调试手段:编译、运行(验证)、Log。用好这三个,大部分问题不用猜。

    编译:只查语法,不执行

    工具栏第一个按钮。它做的事就一件:把脚本解析成语法树,看能不能过。

    • 过了 → 不代表逻辑对,只代表写得出合法语句;
    • 没过 → 输出窗口会指向出错的行。

    编译阶段能发现的:括号不配对、end 少了、for 后面漏 do、用了不存在的函数名、字符串引号没闭合。

    编译阶段发现不了的:变量算错、延时给少了、按键绑定错了、目标程序没响应。

    常见报错与含义:

    报错大意 大概率原因
    意外的 end / 缺少 end 容器块(if / while / for / function)嵌套没闭合
    意外的符号 xxx 用了不支持的语法,比如 elseif 写成了 else if
    未知函数 xxx 函数名拼错,或者这个能力本设备不支持
    字符串未闭合 引号少了一半,或者字符串里有引号没转义

    验证:真执行,但是在电脑上

    工具栏第二个按钮(运行Lua脚本)。它会真的执行:鼠标会动,键会按。

    用途是验证流程对不对,但有三件事必须清楚:

    1. 它在电脑上跑,不是盒子。软件侧是解释执行,硬件侧是编译成字节码后在设备上跑。链路不同,时序表现可能不一样。
    2. 执行前把光标放到安全位置。它是真的在点,点在什么地方就是什么地方。
    3. 验证通过 ≠ 硬件可用。这是最常见的误判来源:软件里跑得好好的,烧进去不动。

    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),或者中途触发了别的宏。也可能是目标程序弹了模态窗口把输入吞了。

    同样的脚本,今天能跑明天不能。 检查场景是不是被切走了;或者绑定的触发键被别的软件占用了。

    改了脚本但行为没变。 改完要重新编译、重新烧录。只编译不烧录,硬件里跑的还是旧版本——这是最高频的「明明改了却没生效」。

  • 登录

  • 没有帐号? 注册

  • 登录或注册以进行搜索。
Powered by NodeBB Contributors
  • 第一个帖子
    最后一个帖子
0
  • 版块
  • 最新
  • 标签
  • 热门
  • 世界
  • 用户
  • 群组