键鼠测试

使用 NXTKB Input Tester 可以在浏览器里测试键盘按键、鼠标按键、滚轮事件和触控板行为。

它适合在收到键盘后、刷写固件后、用 ZMK Studio 修改键位后，或者排查某个按键/层行为时使用。

可以测试什么

• 键盘按下和松开事件
• 当前按键状态：正在按下、曾经按过、从未按过
• 带顺序的按键历史
• 鼠标按键，包括浏览器能识别到的侧键
• 指针移动、移动速度、滚动方向、滚动速度和总滚动距离
• 触控板滚动行为，浏览器通常会把它显示为滚轮事件
• 在指针测试区通过精确模式测试相对移动

基本测试流程

1. 通过 USB 或蓝牙连接键盘。
2. 打开 input-test.nxtkb.com。
3. 保持键盘捕获开启。
4. 逐个按下实体按键，观察屏幕键盘和按键历史。
5. 切换到各个层，测试每层中发生变化的按键。
6. 进入 mouse 层，在指针测试区测试移动、按键、滚轮和触控板手势。

如果刚刚修改过键位，先在 ZMK Studio 中保存，再回到测试工具验证修改后的按键。

测试 Mouse 层和触控板

对于 Sweep Pro，可以结合触控板使用说明一起测试：

• 在右手触控板上移动，确认页面出现指针移动或滚动事件。
• 按住滚动修饰键后移动触控板，确认页面出现滚轮事件。
• 测试键位中配置的左键、右键、中键、后退和前进按键。
• 需要更清楚地观察相对移动时，可以使用指针面板里的精确模式。

测试工具不能直接把触控板识别成独立设备。浏览器通常会把触控板滚动作为普通滚轮事件上报。

浏览器限制

普通网页无法看到所有输入。

• 浏览器或系统可能会先拦截部分快捷键。
• F1、F5、F11、PrintScreen、Meta、媒体键、亮度键，以及固件层面的 Fn 行为，可能不会完整传到网页。
• 这些浏览器风险按键没有事件，不一定代表键盘硬件有问题。

对于普通字母键、层切换键、鼠标按键、滚轮事件和触控板手势，测试工具通常足够完成日常验证。

隐私和本地设置

测试工具在浏览器中运行。语言、主题、声音、音量、捕获模式等偏好会保存在本地浏览器中。临时测试状态，例如已按下按键和指针历史，会在刷新页面后重置。