【造点好玩的】K10摇身变AI PassPort

一、项目介绍和创意来源

奥迪说：你踩油门，剩下的交给Quattro； 行空板K10说：你想创意，剩下的交给AI。这不，这次仔爸打算用AI复刻一下最近流行的AI PassPort(介绍详见：https://ai-passport.folotoy.cn/)。

我手头没有这款硬件，只是看了网上的介绍，认识的有些网友也购买了，正在愉快地玩耍。看到esp32 c3的硬件配置，我就…… 不如把手头的K10打造成更强的PassPort，说干就干。注意，本文不涉及编程，因为编程这事交给WorkBuddy了，我只负责创意和想法。

二、项目实施过程

1.首先在WorkBuddy(下面简称WB，选择Deepseek V4-Pro模型）中提供行空板的介绍网址和AI PassPort的github网址，并让WB进行学习。学习完成之后，让WB尝试写出适用于K10的固件。在编写固件的时候，WB会自动安装一些编译环境，如arduino-cli等。

以下是提示词，并使用了嵌入式硬件开发的技能和专家。
任务：把 FoloToy AI Passport 方案移植到 UNIHIKER K10（ESP32-S3，8MB PSRAM+16MB Flash，板载 2.8"LCD/双麦/喇叭/WiFi-BLE/摄像头/RGB×3/AHT20/加速度计/microSD/电池口）。
结论：K10 几乎内置原机所有外设，且 PSRAM 补足原机 ESP32-C3 无 PSRAM 短板；唯一缺件是 NFC。
产出文件：
k10_firmware_design.md：架构/模块/引脚映射/协议/驱动/环境烧录调试/NFC选配。
firmware/AI_Passport_K10/：AI_Passport_K10.ino(主固件 MVP: 身份卡+SoftAP配网QR+语音对话)、config.h、nfc_reader.h(可选PN532 I2C)。
firmware/server/aipassport_server.py：零依赖本地AI代理(/llm /asr /chat 桩实现)。
关键决策：主链路用 WiFi 直连 AI 后端（替代原机 BLE 中继），因 K10 BT 可能被出厂 AI 固件占用；NFC 用被动 NTAG213 标签零焊接复刻“碰一碰”，或选配 PN532 读卡。
未实机编译（无 K10 硬件/BSP 工具链）；TTS 依赖中文固件，录音读回依赖 TF(SD) 文件系统，需实机验证。
K10 开发用 skill: unihiker-k10-arduino（FQBN UNIHIKER:esp32:k10，TTS 仅中文固件，屏幕必须局部刷新）。

2.启用并接入接真实大模型

K10本身不具备大模型推理的能力，因此需要通过接入网络上的真实大模型来调用并推理，这里我选择了Deepseek。去Deepseek网站上获取API，填入aipassport_server.py配置文件（见附件），并双击打开该文件（需要安装python环境），这样就能启用大模型服务了。

另外，语音交互中使用了ASR 模式: 百度语音识别，还需要去百度创建语音识别应用并获取API

把获取的API Key和Secret Key仍填入aipassport_server.py配置文件。

这是双击aipassport_server.py文件后运行的终端界面，行空板K10连接上Wifi（与本机电脑在同一网络）就可以使用在线真实大模型了。

3.编写自己的微信小程序。因为自行移植到K10上的固件是不能使用AI PassPort官方小程序，因此需要自行编写小程序。继续交给WB，但需要先注册微信小程序开发账号，获取APIID，然后交给WB一通编写。

然后安装微信开发者工具（下载地址https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html），安装并登录。然后在软件中选择导入项目，把WB生成的微信小程序导入进来。

下图中红框中的文件是导入项目必须具备的文件。其中project.config.json里面保存了小程序开发APPID。

然后在微信小程序开发软件中单击右上角的“真机调试”

然后在手机的微信中自动打开这调试的小程序，单击“扫描设备”，就会出现行空板K10的这个设备。

在手机上单击行空板K10设备名称，就进入玩法界面。