N Agent Bridge 版本
0.15.0 (57)
环境
macOS 26.6.1, Apple Silicon (arm64)
键盘
NuPhy Air75 V3 ANSI, firmware 1.0.16.6, USB-C (19F5:1028)
复现步骤
- 在 NuPhyIO 中把第 1 层旋钮按下设置为 Play/Pause。
- 完全退出 NuPhyIO,保持键盘以 USB-C 有线模式连接。
- 启动 N Agent Bridge 0.15.0,确认系统权限已允许。
- 点击“连接并启用/配置当前键盘”。
- 观察 UI 仍停留在“需要配置当前键盘”,且没有说明具体不兼容键位。
预期与实际结果
预期:App 应明确说明检测到未验证的旋钮自定义,并给出可执行恢复步骤;在安全白名单未确认前不得写入键盘。
实际:B2 成功读取完整 1568-byte 键位表,但 index 60(第 1 层 p60)返回 0x00AE(Play/Pause)。严格布局校验拒绝该值,随后错误被统一转换为 encryptedSessionData,因此用户只看到配置没有生效,无法知道需要在 NuPhyIO 中恢复 Mute。
安全状态:失败发生在任何 B3 写入或原始备份持久化之前,键位表未改变。
已脱敏的诊断信息
Firmware response: 10 00 01 AA 06 00 8B 8B
B2 length: 1568 bytes
Knob values:
L1[p60=0x00AE,p96=0x00AA,p97=0x00A9]
L2-L8[p60=0x00A8,p96=0x00AA,p97=0x00A9]
Validation error: incompatibleLayout(index: 60, value: 174)
B3 write sent: no
Proposed fix branch: https://github.com/LeiZiKang/N-Agent-Bridge/tree/fix/air75-configuration-diagnostics
The fix preserves the whitelist and surfaces an actionable error; software self-tests pass.
隐私确认
N Agent Bridge 版本
0.15.0 (57)
环境
macOS 26.6.1, Apple Silicon (arm64)
键盘
NuPhy Air75 V3 ANSI, firmware 1.0.16.6, USB-C (19F5:1028)
复现步骤
预期与实际结果
预期:App 应明确说明检测到未验证的旋钮自定义,并给出可执行恢复步骤;在安全白名单未确认前不得写入键盘。
实际:B2 成功读取完整 1568-byte 键位表,但 index 60(第 1 层 p60)返回 0x00AE(Play/Pause)。严格布局校验拒绝该值,随后错误被统一转换为 encryptedSessionData,因此用户只看到配置没有生效,无法知道需要在 NuPhyIO 中恢复 Mute。
安全状态:失败发生在任何 B3 写入或原始备份持久化之前,键位表未改变。
已脱敏的诊断信息
隐私确认