一句话结论
NuPhyIO(nuphy.io,当前为 NuPhyIO 2.0 并可切换 1.0)与 VIA(NuPhy Console / usevia.app)均依赖 WebHID,必须使用桌面端 Chrome 或 Microsoft Edge,并把键盘拨至有线模式后通过 USB-C 数据线直连电脑——蓝牙与 2.4G 无线模式下无法识别。
1. 按型号确认应该打开 NuPhyIO 还是 VIA
选错网页驱动不仅认不出设备,在双版本型号上还可能下错固件。请先对照下表:
| 配置生态 | 适用型号 | 官方入口 |
|---|---|---|
| NuPhyIO 2.0(网页 / 客户端) | Air60 HE、Air75 HE、Air75 V3、Air100 V3、Node75(LP/HP)、Node100(LP/HP) | www.nuphy.io/zh-CN |
| QMK / VIA(网页改键) | Air60 V2、Air75 V2、Air96 V2 | nuphy.com/pages/console 或 usevia.app |
| 双版本独立(务必核对!) | Kick75、Halo75 V2、Halo96 V2 各分 NuPhyIO(IO)版与 QMK/VIA 版 | 按所购版本对应入口,不可交叉混用 |
2. WebHID 浏览器无法识别键盘的 5 步排查
- 使用支持 WebHID 的浏览器:必须使用桌面端 Chrome 或 Microsoft Edge;Safari 与 Firefox 不支持 WebHID。
- 切换至有线模式并用数据线直连:将键盘物理开关拨至 Wired(有线),使用支持数据传输的 USB-C 线直接连接电脑主板接口,避开仅充电线与无源扩展坞。
- 排查端口冲突:同一时间只打开一个配置标签页,并暂时退出可能占用 HID 设备权限的其他外设软件或本地 NuPhyIO 桌面客户端。
- NuPhyIO 1.0 与 2.0 切换:若较早批次的 NuPhyIO 键盘在 2.0 界面异常,可使用页面顶部或入口提供的 NuPhyIO 1.0 切换或官方固件更新页面下载 Windows/macOS 客户端。
- 第三方品牌辨别:Weikav Nut75 使用 Weikav 自家网页驱动,不能通过 NuPhyIO 或 NuPhy Node75 流程识别。
NuPhyIO 与 VIA 常见问题
为什么在蓝牙或 2.4G 模式下打不开 NuPhyIO 或 VIA?
浏览器 WebHID 协议只能访问通过 USB 数据线直连电脑的外设。配置按键、灯光或固件前,必须将键盘切到有线模式并用 USB-C 数据线直连电脑。
Mac 上的 Safari 浏览器可以使用 NuPhyIO 吗?
不可以。Safari 和 Firefox 默认不支持 WebHID API,请在 macOS 或 Windows 上使用 Google Chrome 或 Microsoft Edge。
Halo75 V2 或 Kick75 不确定自己是 IO 版还是 VIA 版怎么办?
可先检查外包装标签是否带有 IO 字样;也可以在有线直连下分别用 Chrome 打开 nuphy.io 与 VIA 测试识别情况,认出后再去对应的官方说明书和固件页。
NuPhyIO 2.0 与 1.0 有什么区别?
nuphy.io 目前默认运行 NuPhyIO 2.0,同时保留了 NuPhyIO 1.0 切换入口,并在固件更新页提供 Windows 与 macOS 本地客户端包以备兼容需求。