观序AI对接实体物 AI Passport 实践

关键结论：对接方向是反的
它没有给你一套”开放平台接口”去接。我把官方 README、官网、文档目录都翻了：

全文没有 HTTP / WebSocket / MCP 的服务端契约、没有 API 端点、没有鉴权规范；
基线固件里 Wi-Fi 只是个扫描 demo（不连接、不存凭证），BLE 只是不可连接广播；
官网说的玩法安装是「电脑 Chrome/Edge + Type-C 线烧录」，而且会覆盖设备当前全部内容。
所以不存在”打开 AI Passport 的接口”。真正的方向是：你写一段固件，让设备当客户端去调观序的接口——要”打开”的是观序自己的 HTTP 接口。

观序这边其实已经齐了（不用新开）
用途 接口 现状
探活 / 拿登录策略 GET /api/health 免登录可用 ✅
换令牌 POST /api/auth/login（account + password） 免登录可调 ✅
录音转文字 POST /api/voice/recognize（别名 asr / stt） 需令牌
文字转语音 POST /api/voice/tts、GET /api/voice/voices 需令牌
对话 POST /api/chat（或 /api/agent/run） 需令牌

固件本体（ESP-IDF + BSP、三按键、ES8311 音频、Wi-Fi 配网）——基线固件的 Wi-Fi 只有扫描 demo，配网逻辑得自己写；
真机联调：麦克风增益、喇叭音量、电源、按键手感这些只能上手调。
设备到了之前，我建议你顺手做一件事：把固件仓库先克隆下来在 AI IDE 里打开一次（gitee.com/folotoy/ai-passport，让它先读 AGENTS.md）——确认下你的开发环境能编译出官方基线固件。很多人是卡在这一步（ESP-IDF 工具链），提前踩掉比设备到了再折腾划算