N Agent Bridge 0.15.0 Development

0.15.0 Development

中文

• 设置 → 通用新增“界面语言”，支持中文与 English 即时切换并自动保存。
• 新安装会跟随 macOS 首选语言；非中文系统默认显示 English。
• 侧栏、首次设置、概览、按键、灯光、设置、菜单栏和运行提示均已完成双语覆盖。
• 修复英文界面中“支持的 NuPhy 键盘”仍显示中文的问题。
• 保持 Air75 V3 官方固件 1.0.16.6 的 F13–F24、旋钮、0xEE 会话、D6/D8 灯光与权限逻辑不变。
• 当前仅支持 NuPhy Air75 V3 ANSI（固件 1.0.16.6）。

English

• Added Settings → General → Interface Language with instant Chinese/English switching and automatic saving.
• Fresh installs follow the macOS preferred language; non-Chinese systems default to English.
• Added English coverage for the sidebar, onboarding, Overview, Keys, Lighting, Settings, menu-bar controls, and runtime messages.
• Fixed the remaining Chinese “Supported NuPhy Keyboard” placeholders in the English interface.
• Preserved the verified Air75 V3 firmware 1.0.16.6 behavior for F13–F24, knob control, the 0xEE session, D6/D8 lighting, and macOS permissions.
• Current support: NuPhy Air75 V3 ANSI with firmware 1.0.16.6 only.

Install / 安装

This free Development build uses a stable local signature but is not Apple-notarized. If macOS blocks the first launch, use System Settings → Privacy & Security → Open Anyway. Do not disable Gatekeeper. Then allow Input Monitoring and Accessibility once.

免费 Development 版本使用固定本地签名，但未经过 Apple 公证。首次启动若被拦截，请到“系统设置 → 隐私与安全性 → 仍要打开”，不要关闭 Gatekeeper；随后允许一次“输入监控”和“辅助功能”。

SHA-256: 154540aac81c1bc7f7a1ebb0924cc7a1a22d1aaff48517e960eaa9b686b5592e

N Agent Bridge 0.14.2 Development

Air75 V3 1.0.16.6 键位兼容修复

• 兼容官方固件中第 8 层旋钮按下 p60 为未分配值 0x0000 的已确认键位表变体。
• 配置时只把这一处规范化为专用事件 0x0048，再写入 F13–F24 并完整回读。
• 第 1–7 层空值、其他位置和未知值仍会安全停止写入；完整备份、ACK、逐字节验证与失败恢复均保留。
• 保留 0.14.1 的橙色确认灯误判修复。
• Universal macOS App：arm64 + x86_64。

首次安装请把 App 拖入“应用程序”，授予输入监控与辅助功能，退出 NuPhyIO，再使用 USB-C 点击“连接并启用”。

SHA-256: 9e5cf34158d0259521778292e23330902f9cd11c2c1fc506d898744703428ed6

Development 包使用固定自签名证书，未经过 Apple 公证。首次打开可能需要到“系统设置 → 隐私与安全性”选择“仍要打开”。

N Agent Bridge 0.14.1 Development

0.14.1 更新内容

• 修复没有批准信息时 Agent 键误亮橙灯的问题。
• 只扫描 Codex 当前可见窗口，不再读取隐藏或已经关闭的确认卡片。
• 只有同一张确认卡片同时出现允许/批准与拒绝/暂不选项时才显示橙灯。
• 用户完成、拒绝或关闭确认后立即清除橙色状态。
• 修复“不允许 / Disallow”被误识别为“允许 / Allow”的边界情况。
• 继续支持 NuPhy Air75 V3 ANSI 官方固件 1.0.16.6。
• Universal macOS App：Apple Silicon 与 Intel 均可使用。

安装

1. 下载并打开 NAgentBridge-0.14.1-Development.dmg。
2. 把 N Agent Bridge 拖入“应用程序”。
3. 首次运行在“系统设置 → 隐私与安全性”允许输入监控和辅助功能。
4. 使用数据 USB-C 线连接 Air75 V3，点击“连接并启用”。

Development 包使用项目固定自签名证书，未经过 Apple 公证。首次被 macOS 拦截时，请在“隐私与安全性”中选择“仍要打开”。

SHA-256: 83edbae8f6b88c101ab1f976314a0b4c26dc7ccc70f21d5a8aff8f9edb239fa3

N Agent Bridge 0.14.0 Development

Air75 V3 官方固件 1.0.16.6 专版

• 仅支持 NuPhy Air75 V3 ANSI。
• 修复官方 1.0.16.6 更新后 USB-C 灯光一直待响应。
• 新增 0xEE 会话握手，兼容新旧加密回复。
• F1–F12 配置为 F13–F24，D6/D8 写入均回读并可恢复。
• 删除 Kick75、Node100 等其他未支持型号。

安装前请先更新 Air75 V3 ANSI 固件到 1.0.16.6。第一次配置使用 USB-C，退出 NuPhyIO，并授予输入监控与辅助功能权限。

SHA-256: 477a34f1d9a411bd91f6f25aa27d4382aba8bdc0bd986d1f6538744d8a911e47

该包为免费 Development 测试包，未经过 Apple 公证；首次打开可能需要在“系统设置 → 隐私与安全性”点“仍要打开”。

N Agent Bridge 0.13.5 Development

面向全新 Mac 与跨机器安装的一致性修复版。

本次修复

• 键位、D5/D6 灯光与 D8 状态灯共用同一串行 HID 事务，避免首次配置或唤醒时互相抢回复。
• USB-C 重连会读取键盘真实键位；固件重置成 F1–F12 时明确要求重新配置，不再误报就绪。
• schema 14 持续精确修复旧版 F13 / F15 / Tab / F16… 异常序列，同时保留真正的自定义键。
• Air75 V3 ANSI、Kick75 IO、Node100 LP ANSI（矮轴）首次配置统一默认“指示灯”背光。
• 键位验真、灯光握手和状态灯失败后最多自动重试三次，减少“过一会才突然正常”。
• DMG 内新增中文安装说明；清除旧构建缓存、空权限文件与已移除的亮度入口。

安装

1. 下载 DMG，把 N Agent Bridge.app 拖入 Applications。
2. 当前为免费自签名测试包；首次若被阻止，请在“系统设置 → 隐私与安全性”选择“仍要打开”，不要关闭 Gatekeeper。
3. 允许“输入监控”和“辅助功能”，完整退出并重新打开应用。
4. 首次使用数据 USB-C、有线模式，并退出 NuPhyIO；点击“连接并启用/配置”，等待完整回读。
5. 完成后重新连接键盘，并用 Command-Q 重启一次 Codex Desktop。

已验证：software-only SelfTest、arm64 + x86_64 Universal、固定签名、Bundle 资源、DMG CRC/结构与只读挂载内容。

SHA-256: 71d7a873187da979d4eec3e499581221e05d9a811294da9ab9a9acf0d121956e

当前包未经过 Apple Developer ID 公证，不是 Apple 官方认可的正式站外发行版。源码归档由 GitHub 自动提供。

N Agent Bridge 0.13.4 Development

修复 Kick75 已在首页识别，但灯光页长期显示‘USB-C 待响应’且全部控件置灰。

• 连接后立即进行安全的只读 D5 灯光握手
• 概览按当前键盘型号判断配置状态
• Kick75 未配置时，配置按钮会执行完整键盘 Profile 和 Codex 初始化
• 首次配置等待覆盖固件完整重试周期
• Universal：Apple Silicon + Intel
• SHA-256：a1ef87df42aae6643e4113525dcee4cb84a039937b8ae06f18472e40a4c0b978

这是免费自签名 Development 测试包，未经过 Apple 公证。

N Agent Bridge 0.13.3 Development

修复 Air75 V3 默认 Tab 键错误亮灯：旧版曾把 Agent 3 临时绑定到 Tab，而 D8 单键颜色会保留在固件中。新版每次状态同步会清理 Air75 的历史 Tab 灯位；如果用户主动把 Agent 自定义到 Tab，Tab 仍会按任务状态正常显示。清理不会影响 Kick75 或 Node100。

安装：下载 DMG，将 N Agent Bridge.app 拖入应用程序；用 USB-C 连接 Air75 V3，打开状态灯或点击连接并启用后会自动清理。

SHA-256: 8b371286e6175a706200c761dd2c6779a238d40c6c77ea383b72b911886a6a37

这是免费 Development 测试包，使用项目固定自签名证书，未经过 Apple 公证。

N Agent Bridge 0.13.2 Development

修复朋友电脑首次配置后出现的 F13 / F15 / Tab / F16… 异常映射，升级后自动恢复连续 F13–F24，并保留真正的自定义键。首次键位配置与灯光读取现已串行执行，Air75 V3 / Node100 LP ANSI 的指示灯模式不会再因 HID 通道竞争延迟生效。

安装：下载 DMG，将 N Agent Bridge.app 拖入应用程序，首次设置使用 USB-C 并点击连接并启用。

SHA-256: 83b95375a3dbc8cc6643dff976178a9315194353b39d49cca23b9d9957faeb28

这是免费 Development 测试包，使用项目固定自签名证书，未经过 Apple 公证。

N Agent Bridge 0.13.1 Development

朋友电脑首次配置与错误蓝灯修复，并加入 Node100 LP ANSI 完整实机适配。

• USB-C 下点击‘连接并启用’会读取键盘真实配置，把物理 F1–F12 自动写成专用 F13–F24 事件并完整回读，避免同时触发 macOS 原生功能。
• Air75 V3 与 Node100 LP ANSI 首次成功配置后，普通背光自动进入‘指示灯’模式；之后不会覆盖用户手动选择的灯效。
• 修复异常中断的旧任务长期误亮蓝灯；任务仍会通过实时事件和 30 秒心跳保持状态。
• 包含 Kick75 已验证修复与 Node100 LP ANSI 的 F 区、触控条、108 键状态灯、背光、点阵灯和休眠支持。
• Universal：Apple Silicon + Intel。

首次安装或更新键盘固件后：请用 USB-C 连接键盘，允许‘输入监控’和‘辅助功能’，返回应用点击一次‘连接并启用’，再重启 Codex Desktop。

SHA-256：5971087e36852805866b8f3a2ab0a38d9e68cb0162eb7425993c82123d7bc2c4

这是免费自签名 Development 测试包，尚未 Apple 公证。源码由本标签自动提供 ZIP/TAR。

N Agent Bridge 0.12.5 Development

本次更新

• Air75 V3 保持完整支持。
• 新增 NuPhy Kick75 型号自动识别。
• Kick75 的 F1–F12、旋钮专用控制已完成实机验证。
• Kick75 支持六个 Agent 单键状态灯，并支持把 Agent 改到数字键、字母键、F 区或导航键后让灯光跟随实体位置。
• Kick75 背光、侧灯、常亮颜色、灯光保持时间、失败回读与安全恢复已完成实机验证。
• Air75 V3 与 Kick75 的键位、备份和硬件状态按型号独立保存，不会互相覆盖。
• 源码、测试、协议文档和新增型号接入说明已同步更新。

安装包

下载 NAgentBridge-0.12.5-Development.dmg，打开后把 N Agent Bridge 拖入“应用程序”。

这是免费 Development 测试包，使用固定本机签名，但没有 Apple Developer ID 公证。若 macOS 首次阻止打开，请在 Finder 中右键应用并选择“打开”，不要关闭整个 Gatekeeper。

支持架构：Apple Silicon（arm64）和 Intel（x86_64）。

校验

SHA-256: 43b019377093debeb0a3798fe1dfa8c2534c3df87c3bae6811b8f4bba63c4e75

当前完整硬件支持

• NuPhy Air75 V3
• NuPhy Kick75

Air65 V3、Air100 V3、Node75、Node100 已具备安全识别 Profile，但硬件写入功能仍需逐型号实机验证后开放。