为编程 Agent 制作实体遥控器

用实体按键批准工作、导航选项、切换会话或模型、控制语音，并在屏幕上显示 Agent 状态、文本和用量。

从 Nexting 开始查看公开源码

你能构建什么

从一个真实有用的硬件动作开始。Agent 凭证和会话逻辑留在可信 Host，设备只实现小而可测试的 BLE 契约。

批准或拒绝一次性请求用 approval/1 把符合条件的 Claude Code、Codex、Grok 与 Cursor 请求映射到两个实体按键。由 Nexting App 提供 Host

显示 Agent 实时状态用 status/1 显示思考中、工作中、等待输入、完成和错误。现在可用

描述自定义硬件通过 Device Info 0.2 向 iOS 与 Android 提供名称、编号、按键、旋钮、屏幕、震动和电量。现在可用

做完整 DIY 控制台navigation/1、keys/1、rotary/1、voice/1、text/1、usage/1 与 config/1 已进入公共 SDK。SDK 0.4 可用

选择开发路线

做硬件时，从设备 SDK 和 Wire 协议开始。官方 Nexting App 已经提供 Host；这条 SDK 路径不要求你开发 App 或 Host。所有路线仍使用同一组 Wire 向量。

你要构建	从这里开始	验证方式
实体设备	设备固件 · C99	C 测试 + 真板
其他语言实现	Wire 协议 + reference/js	标准向量

运行第一次审批

蓝牙验证必须使用真机。模拟器和 CI 能证明契约与构建，不能证明无线行为。

取得源码

Nexting Devices 位于现有 Nexting 仓库中。

git clone https://github.com/Nexting-ai/nexting.git
cd nexting/devices

构建参考固件

在配置好的 west workspace 中构建受支持的开发板。

west build -p always -b nrf52840dk/nrf52840 /path/to/nexting/devices/firmware/zephyr -- -DEXTRA_CONF_FILE=debug-test-device.conf

烧录开发板
DK 使用板载调试器；XIAO nRF52840 可把 UF2 复制到 bootloader 磁盘。
sh
west flash
连接可信 Host
查看 Device Info、显式授权配件，然后触发一条符合条件的 Claude Code、Codex、Grok 或 Cursor 审批并从硬件回答。

显示 Agent 状态

status/1把受限且易失的状态传给设备声明的一到八个槽位。断开连接会清空全部槽位，LED 或屏幕不会保留过期任务。

状态	适合表达
thinking / working	当前 Agent 正在运行
needs_input	提醒用户查看 Host 或审批按键
complete	当前任务已经完成
error	Host 需要处理错误

可用性边界

级别	含义
现在可用	approval/1、status/1、navigation/1、keys/1、rotary/1、voice/1、text/1、usage/1、config/1，以及 Device Info 0.2 和公开的设备端 C99 SDK。
需要真实硬件	BLE 配对、重连、电量、按键投递和开发板声明仍需在真机与对应开发板上验证。
需要 Host 适配器	fork、send、fast、会话与模型等产品动作由可信 Host 映射；开源 SDK 只传通用物理事件。

voice/1 只发送按住/松开控制，音频由官方 Nexting App 的麦克风采集。App Store 2.4 暂未注册第三方开发者设备；当前硬件验证请使用公开协议与固件检查。

公开源码

规范、向量、C99 设备 SDK、JavaScript 参考实现与 Zephyr 固件统一发布在 Nexting-ai/nexting/devices。私有 App、Agent、账号、云端、量产固件、签名、制造代码和私有应用集成代码不会被导出。官方 Nexting App 是受支持的 Host；硬件开发者不需要构建 Host。

公开源码树text

devices/SPEC.md             Wire 主版本 1 的规范契约
devices/protocol/vectors/ 全部 Profile 与 Device Info 共用向量
devices/sdk/c/            portable C99 设备 SDK
devices/reference/js/     可执行协议参考
devices/firmware/zephyr/  参考开发板
devices/docs/             指南、迁移、证据与安全