一分钟速览
- AI Passport 是 FoloToy 的可穿戴开放硬件，正面有 240×320 彩屏，用三颗实体按键操作，并包含麦克风、扬声器、蓝牙、NFC 和电池。
- 它有三层玩法：开机同步身份卡；从官方玩法库刷小游戏；把完整项目交给 Codex、Claude Code 或 TRAE 等编程 Agent，做自己的固件。
- 官网当前展示像素宠物、剪刀石头布、番茄钟、播放器等具体玩法；这些是设备上的程序，不等于每个玩法都在设备本地运行大模型。
- 自定义开发不是说一句话就结束：Agent 生成与构建代码后，还要连接真机、安装、试玩、记录问题并再次迭代。
先这样开始
- 如果你还没有设备，先看官网的产品正反面和玩法库，确认自己想要的是一块需要动手刷写的小硬件，而不是云端聊天玩具。
- 拿到设备后，先用官方微信小程序或 App 通过本地蓝牙同步名称、头像、简介和全屏图片，熟悉上键、下键、确认键以及充电方式。
- 先从官方玩法库选一个简单项目，用支持数据传输的 USB-C 线和 Chrome/Edge 完成首次初始化与安装。保留一个可恢复的官方版本。
- 想自己做玩法时，把官方
folotoy/ai-passport完整项目作为 Agent 工作区，写清第一屏、三个按键、声音/网络/存储需求和验收结果。 - 让 Agent 完成构建并给出可安装产物，再用本地安装工具刷入测试设备。开机完整玩一遍，把小屏文字、按键、启动速度和异常日志交回同一任务继续修。
先分清三种用法
Wear 是开箱即可理解的身份卡：通过蓝牙同步个人资料和图片。Play 是刷入官方已经做好的玩法，适合先验证数据线、浏览器串口和设备连接。Create 才是自定义开发，需要项目代码、构建环境、USB 写入和真机测试。把这三层分开很重要：只想玩现成小游戏的人不必从源码开始；想让 Agent 写新应用的人，也不能把官方库里的成品误当成自己一句提示词即时生成的结果。
第一个可完成目标
第一次自定义不要做联网语音助手，先做一个离线“敲木鱼”或三键计数器：开机显示标题；确认键加一；上键清零前二次确认；下键切换声音；断电后是否保留计数要提前决定。这个目标能同时检验屏幕、按键、音频和存储，却不需要账号、服务器或麦克风上传。Agent 交付的标准应包括构建成功、产物路径、安装步骤和真机验收清单。只有代码片段、没有可刷写结果，不算完成。
AI 在做什么
这里的 AI 主要出现在创作流程：Codex 等编程 Agent 读取官方项目、硬件约束和示例，根据你的需求修改代码、运行构建并根据报错继续修正。设备本体运行的是构建好的固件；某个玩法是否联网调用模型，要看该玩法自己的实现。官方主分支把“构建通过”和“真机通过”明确分开，因为编译成功不能证明按键、电池、声音和屏幕在真实设备上都正常。不要把 Agent 能写代码夸成硬件会自主设计一切。
硬件能力与边界
官方仓库当前列出的实现包括 240×320 竖屏、上/下/确认三键、音频播放与麦克风采集；主控为 ESP32-C3 且没有 PSRAM，所以图片、动画和音频资源都要控制体积。屏幕没有触摸输入，交互必须围绕实体按键设计。官网还展示蓝牙、NFC 和电池，但自定义玩法能否直接使用某项能力，要以当前项目接口和示例为准。示例分支可能修改同一菜单或驱动，不能把几个示例简单拼在一起。
实际门槛
这是付费实体设备，官网在 2026 年 8 月 29 日显示标准版 99 元；价格、库存和购买渠道会变化，购买前以官方页面为准。首次刷写需要电脑、支持数据传输的 USB-C 线、Chrome 或 Edge，并会请求串口/设备连接权限。通过手机下发玩法也要先用电脑完成一次固件初始化，之后才可用小程序和蓝牙更换。开发自定义玩法还需要本地构建环境和可恢复的测试设备。刷写过程中不要拔线；清除设备数据会删除当前配置和用户数据，只在明确需要时操作。
隐私与安全先看这里
设备包含麦克风，身份卡又可能保存姓名、头像和简介。官方默认资料同步使用本地蓝牙，但具体自定义玩法可以增加网络、录音或第三方服务；启用前要逐项确认数据发往哪里、是否保留、能否离线运行。不要把真实个人资料、儿童信息或私密录音直接塞进测试固件。用 Agent 开发时，也不要把设备二维码里的专属网址、密钥或本地配置提交到公开仓库。官方手机下发教程特别提醒，设备专属页面网址只发送给自己的电脑。
常见卡点
电脑识别不到设备时，先换成确认支持数据传输的 USB-C 线，并在浏览器串口列表里选择包含 USB JTAG/serial debug unit 的设备，不要误选蓝牙耳机或系统调试接口。构建成功但开机黑屏时，要保留构建标识、设备日志和可恢复固件，区分代码问题与刷写问题。按钮逻辑在模拟测试里正常、真机却难按时，优先缩短菜单层级和长按时间，不要立刻增加更多功能。
来源与核验
- AI Passport 官方站：核对产品形态、三种用法、当前玩法库、硬件展示、售价和使用路径。
- FoloToy 官方 GitHub 仓库：核对当前硬件能力、资源边界、示例分支和“构建结果不等于真机结果”的开发契约。
- 官方 Codex 与通用 Agent 教程：核对完整项目、可验收任务、构建、安装和真机迭代步骤。
- 官方手机下发教程：核对首次电脑初始化、蓝牙安装、串口选择和设备专属网址风险。
- 本站最后核验：2026 年 8 月 29 日。产品价格、玩法库、固件与文档都可能继续变化。