Skip to content

[Bug] Air75 V3 配置在第一层旋钮为 Play/Pause 时静默停止 #4

Description

@LeiZiKang

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)

复现步骤

  1. 在 NuPhyIO 中把第 1 层旋钮按下设置为 Play/Pause。
  2. 完全退出 NuPhyIO,保持键盘以 USB-C 有线模式连接。
  3. 启动 N Agent Bridge 0.15.0,确认系统权限已允许。
  4. 点击“连接并启用/配置当前键盘”。
  5. 观察 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.

隐私确认

  • 我已删除凭据、序列号、用户路径、聊天内容和私人抓包

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions