Nexting Devices · 快速开始

从 Nexting 开始

先理解设备、Host 与 Agent 的连接方式,再选择与你手上产品相符的路径,并完成一次可信的远程交互。

从这里理解 Nexting 连接什么、信任边界在哪里,以及你手上的产品或硬件应该从哪一步开始。制作参考开发板只是可选的开发路线,并不代表 Nexting 设备只能做成双键控制器。

Nexting 如何连接

encrypted BLE → trusted Nexting Host → Agent integration

连接模型

设备形态可以不同,连接标准只有一套

设备、Host、云端与 Agent 通过加密链路双向传递消息和状态。

多种 Nexting 设备

Nexting PIN

PIN

Nexting Ring

Ring

DIY

BLE加密 GATT · 设备 ↔ Host
Nexting

Nexting Cloud

身份 · 路由 · 加密信封

可信 Host

手机或电脑 · BLE 终止在这里

云端只负责投递,不保存 Agent 凭证

加密信封Host ↔ Cloud ↔ Agent

Nexting Agent 集成

同一套设备协议,接入不同 Agent

Claude Code

Claude Code

Codex

Codex

Grok

Grok

Cursor

Cursor

OpenClaw

OpenClaw

箭头表示消息和状态的双向传递。

配件不会直接登录 Claude Code、Codex、Grok、Cursor 或其他 Agent。它只把有界的物理意图报告给官方 Nexting App(可信 Host)。你不需要另外安装或构建 Host;官方 App 负责授权设备、保管凭证与会话,并把物理意图映射到当前选中的 Agent;云端只传递加密信封和必要的投递元数据。

层职责保管内容
设备物理输入与最少显示状态不保存 Agent 凭证
可信 HostBLE 配对、授权、策略与 Agent 映射凭证与会话
Nexting Cloud传递加密信封与投递元数据不保存 Agent 凭证
Agent 集成Claude Code、Codex、Grok、Cursor 或其他受支持适配器Agent 专属状态

选择你的路径

路径从哪里开始第一次验证
使用受支持的 Nexting 自有产品按照该产品的 App 引导连接 Agent,再配对并授权产品。同一 Agent 会话收到一次经过验证的实体操作。
使用 Nexting SDK 开发适配硬件前,先运行公开协议验证工具;不需要自己构建 Host。得到确定的 Profile 交换或 PASS answer=... 本地协议验证。
当前版本的 iOS 与 Android 尚未公开第三方开发者设备注册。iOS 已核对到App Store 2.4,Android 已核对到No public version verified。受支持的替代路径是firmware-tests。它是本地协议验证,不是真实 Agent 连接。

第一次远程交互

  1. 连接 Agent

    在 Nexting App(官方 Host)里选择你要控制的 Claude Code、Codex、Grok、Cursor 或其他受支持 Agent 会话。
  2. 配对并授权

    使用产品公开提供的引导流程。Host 会先验证设备身份和声明的 Profile,再启用操作。
  3. 用已映射的控件触发动作

    从配件批准一次性请求、移动选项,或发送另一种已经声明的物理事件;SDK 不规定哪一个实体控件承担这些动作。
  4. 继续同一会话

    Host 校验时效性与策略后应用映射动作,再把最少的结果状态发回设备。

Allow / Deny 是协议选择,不是固定按键。以 MultiPad 为例,你可以在固件中把任意按键、旋钮按压或其他实体控件映射为allow 或 deny;SDK 只约定上传的语义,不假设设备的外形和键位。

当公开引导支持所选 Agent 时,Nexting 自有产品可以完成这条路径。DIY 硬件应先通过公开 Host 验证工具验证approval/1;这不是让你自己构建 Host。只有公开开发者设备注册上线后,它才会成为真实的远程 Agent 控制器。

Host 是什么,谁需要自己构建?

Host 不是用户需要额外下载或构建的程序。对使用 Nexting App 的用户和硬件开发者,官方 App 已经承担了 Host 的全部职责:蓝牙连接、设备授权、凭证保护、会话选择和 Agent 映射。本公开 SDK 只讲设备端;自定义 App/Host 属于私有产品开发,不是受支持的安装路径。

Host 职责为什么重要
保管凭证与权威会话配件固件不会收到 Agent 登录材料,也不会收到内部账号或会话路由。
授权身份与声明能力只有设备名称或 BLE 广播不能获得控制权限。
执行风险与时效策略过期、重复、重放、已撤销或未声明的输入都会被拒绝。
映射通用物理意图Agent 行为可以持续演进,无需给每个配件重新烧录固件。

一分钟了解安全性

近距离链路使用 BLE LE Secure Connections,并要求控制流量走加密 GATT。Host 只向设备发送最少且有界的 Profile 数据,同时保持为唯一能够把设备动作授权到 Agent 会话的层。

Developer Reference 使用 Just Works 配对。它会加密本地链路,但无法在配对时抵御主动中间人。量产硬件需要经过认证的应用身份与签名固件。

下一步:按你的目标选择

如果你只是使用已经做好的设备,到“安装 Nexting App 并连接设备”就结束,不需要构建 Host。下面只列出每种目标真正需要的入口。

你的目标你真正需要做的入口
直接使用设备安装 Nexting App,登录后扫描并连接设备;不构建 Host。打开 App Store
适配设备固件实现 Device SDK 并验证公开 Profile;Host 由 Nexting App 提供。设备固件 · C99
查协议和测试向量查看消息格式、限制和兼容性规则。Wire 协议