Nexting Devices · 快速开始
从 Nexting 开始
先理解设备、Host 与 Agent 的连接方式,再选择与你手上产品相符的路径,并完成一次可信的远程交互。
从这里理解 Nexting 连接什么、信任边界在哪里,以及你手上的产品或硬件应该从哪一步开始。制作参考开发板只是可选的开发路线,并不代表 Nexting 设备只能做成双键控制器。
Nexting 如何连接
encrypted BLE → trusted Nexting Host → Agent integration
连接模型
设备形态可以不同,连接标准只有一套
设备、Host、云端与 Agent 通过加密链路双向传递消息和状态。
多种 Nexting 设备

PIN

Ring
DIY
Nexting Cloud
身份 · 路由 · 加密信封
手机或电脑 · BLE 终止在这里
云端只负责投递,不保存 Agent 凭证
Nexting Agent 集成
同一套设备协议,接入不同 Agent

Claude Code

Codex
Grok
Cursor
OpenClaw
箭头表示消息和状态的双向传递。
配件不会直接登录 Claude Code、Codex、Grok、Cursor 或其他 Agent。它只把有界的物理意图报告给官方 Nexting App(可信 Host)。你不需要另外安装或构建 Host;官方 App 负责授权设备、保管凭证与会话,并把物理意图映射到当前选中的 Agent;云端只传递加密信封和必要的投递元数据。
| 层 | 职责 | 保管内容 |
|---|---|---|
| 设备 | 物理输入与最少显示状态 | 不保存 Agent 凭证 |
| 可信 Host | BLE 配对、授权、策略与 Agent 映射 | 凭证与会话 |
| Nexting Cloud | 传递加密信封与投递元数据 | 不保存 Agent 凭证 |
| Agent 集成 | Claude Code、Codex、Grok、Cursor 或其他受支持适配器 | Agent 专属状态 |
选择你的路径
| 路径 | 从哪里开始 | 第一次验证 |
|---|---|---|
| 使用受支持的 Nexting 自有产品 | 按照该产品的 App 引导连接 Agent,再配对并授权产品。 | 同一 Agent 会话收到一次经过验证的实体操作。 |
| 使用 Nexting SDK 开发 | 适配硬件前,先运行公开协议验证工具;不需要自己构建 Host。 | 得到确定的 Profile 交换或 PASS answer=... 本地协议验证。 |
firmware-tests。它是本地协议验证,不是真实 Agent 连接。第一次远程交互
连接 Agent
在 Nexting App(官方 Host)里选择你要控制的 Claude Code、Codex、Grok、Cursor 或其他受支持 Agent 会话。配对并授权
使用产品公开提供的引导流程。Host 会先验证设备身份和声明的 Profile,再启用操作。用已映射的控件触发动作
从配件批准一次性请求、移动选项,或发送另一种已经声明的物理事件;SDK 不规定哪一个实体控件承担这些动作。继续同一会话
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 会话的层。
下一步:按你的目标选择
如果你只是使用已经做好的设备,到“安装 Nexting App 并连接设备”就结束,不需要构建 Host。下面只列出每种目标真正需要的入口。
| 你的目标 | 你真正需要做的 | 入口 |
|---|---|---|
| 直接使用设备 | 安装 Nexting App,登录后扫描并连接设备;不构建 Host。 | 打开 App Store |
| 适配设备固件 | 实现 Device SDK 并验证公开 Profile;Host 由 Nexting App 提供。 | 设备固件 · C99 |
| 查协议和测试向量 | 查看消息格式、限制和兼容性规则。 | Wire 协议 |