简体中文 · English

本仓库是 FoloToy/ai-passport 的个人 fork。 上游仓库是 FoloToy AI Passport（开源可穿戴 AI 设备： ESP32-C3、240×320 彩屏、三键操作、8 MB Flash、无 PSRAM）的开发基线。

这个 fork 在基线之上承载了多个独立应用，每个项目各自位于一个 feature/* 分支上， 下面逐个介绍。板卡事实、BSP 与开发流程来自上游仓库 —— 见 docs/README.md、AGENTS.md 与 docs/contribution/。每个项目的固件发布挂在本仓库的 Releases 上。

把 AI Passport 变成口袋音频播放器的音效钥匙扣：开机即进入应用，播放来自几十个角色包的 数百条中文语音片段 —— jojo、meme cat、刘华强、哈吉米、奶龙等等。最新版：v1.5.0。

• 分支：feature/voice-keychain
• 发布：v1.1.0、v1.3.0、v1.4.0、v1.5.0
• 经验沉淀：docs/reference/shinku-chen/voice-keychain/

操作方式（三键）： UP / DOWN 在列表中移动，OK 进入目录、选择片段或播放， OK（长按） 进入设置（音量、电量）或返回。

亮点：

• 自包含固件 —— FoloToy-AI-Passport-full.bin 把 voicefs 数据分区（位于 0x210000）打进同一个 8 MB 镜像，从 0x0 整体烧录即可，无需再单独刷数据分区。
• 深睡唤醒已修复 —— GPIO0 唤醒源此前从未启用（把引脚号当位掩码传入），导致"睡了 按不醒"；现改为 5 分钟无操作入睡、任意按键可唤醒（真机验证）。
• 列表播放更可靠 —— 此前每次播放都临时申请 16 KB Opus 解码栈，堆不足时"停掉当前 声音却不播选中项"；改为单个常驻播放任务（静态栈 + 二值信号量）。
• 电量每 30 秒刷新；CW2017 上电偶发读到 0xFF 时，按开路电压查表兜底估算电量。
• 更安静的深睡（v1.4.0） —— 入睡前先关掉 LCD 面板、codec 与电量计。
• 目录顺序（v1.5.0） —— 黄袋鼠（Yellow Kangaroo）排到角色目录首位。

按键驱动的食物转盘决策器，终结"今天吃什么"。按住 UP 播放"今天午餐要吃什么呢？" 引导动画，按住 DOWN 滚动食物选择器，松开停在随机结果上。最新版：v1.2.0。

• 分支：feature/cheerful-goodall
• 发布：v1.2.0
• 经验沉淀：docs/reference/shinku-chen/eat-what/

操作方式： 按住 UP / DOWN 运行两套动画，松开停在当前帧；OK 切换 LVGL 局部刷新 与快速隔行刷新。空闲 2 分钟自动关机（深睡，GPIO0 唤醒）。

汉字闪卡识记应用。三种模式 —— 浏览（Browse）：滚动字卡；自测（Self-test）： 标记每个字认识/不认识；拼读（Spell）：看拼音猜字。OK 短按揭晓答案，已认识 标记持久化到 NVS。最新版：v1.0.0。

• 分支：feature/shengzi-cards
• 发布：v1.0.0

AI Passport 上的横屏四子棋：棋盘 10 列 × 7 行，可与电脑对战（低 / 中 / 高三档难度，先手可选玩家或电脑）、双人同机轮下，也可以两台设备通过蓝牙联机对战。最新版本：v1.7.0-connect-four，新增两台设备通过蓝牙联机对战。

• 分支：feature/connect-four
• 发布：v1.7.0-connect-four
• 经验沉淀：docs/reference/shinku-chen/two-device-ble-link.zh_CN.md

操作： 上 / 下移动落子列（横屏持握时「上」在右手边），确定落子，长按确定回设置屏。设置屏上用上 / 下选行、确定切换取值（模式：HUMAN vs AI / AI vs HUMAN / TWO PLAYERS / LINK PLAY，难度：低 / 中 / 高，预览：落点 / 顶部行），选到 START 按确定开局；LINK PLAY 下则进入联机屏。两个电脑模式只差先后手。

双机联机： 两台设备都设成 MODE = LINK PLAY 并按 START；每台都同时广播并扫描对端，不需要选主机 / 加入——BLE 地址较大的一方主动连接，两边各自算出的角色必然相反。屏幕依次显示 SEARCHING... / CONNECTING... / HANDSHAKE...，双方交换完 HELLO 后自动开局；主动连接的一方先手，之后每重开一局先手轮换，且只有轮到的一方才能落子（顶部显示 YOUR TURN / PEER TURN）。局面一致性靠停等可靠层（逐包序号 + 捎带确认 + 超时重传）加每手落子数校验保证；tools/c4_peer.py 可在 PC 上通过 BLE 扮演对端说同一套协议。联机占约 73KB 堆，而串口截图要静态预留整屏 320 × 240，因此默认固件带 LINK PLAY，截图工具改为可选构建 idf.py -DC4_ENABLE_SCREENSHOT=ON build。

亮点：

• 横屏 320 × 240、棋盘密排 —— 70 个格子、26px 棋子、相邻仅隔 3px，靠 BSP 层的 MADCTL 硬件旋转铺满屏幕。
• 三档电脑难度 —— 用墙钟搜索预算把每步控制在 1 秒内；低 / 中难度带固定失误率放水，保证打得赢。
• 无素材音效 —— 换列、落子、胜、负、平局音都由正弦表实时合成，不占 flash 资源。
• 不依赖手机的双机对战 —— BLE 对等发现放在 components/bsp/bsp_ble_link.c，报文与可靠投递放在 main/c4_link_proto.c（有宿主测试）；实测约 73KB 堆开销。
• 空闲自动深睡 —— 设置屏 60 秒、对局中 180 秒后进入深睡，任意键唤醒（GPIO0 低电平唤醒，已修复 ADC 占用该脚导致的立即自唤醒）。
• 串口截图 —— FAP_SCREENSHOT_V1 命令回传真实 320 × 240 画面，本版封面就是这么抓的；它现在是可选的开发构建，因为在没有 PSRAM 的板子上它与 BLE 联机无法共存。

从小米手环版本 liuyuze61/Asunabi-miband 移植到 AI Passport 的竖屏视觉小说：30 章、4649 句对白、约 9.4 万字，从头读到唯一结局。 状态：已发布 —— tag v0.1.0-asunabi，并已投稿到 AI Passport 社区市场（审核中）。

• 分支：feature/asunabi-galgame
• 发布：v0.1.0-asunabi —— 合并镜像 FoloToy-AI-Passport-full.bin，7,917,142 字节
• 上游作品：liuyuze61/Asunabi-miband —— 本次移植所依据的小米手环快应用版本。该仓库未声明许可；其美术与章节剧本随分支提交在 assets/gal-source/，并以上游项目作为来源标注。
• 素材工具链：tools/gal/

操作方式（三键）： UP 推进一句（打字中则立即全显）；UP（长按） 按住快进、松手即停； OK 呼出菜单（继续阅读、保存、读取、跳过本章、设置、返回标题）；DOWN 滚动超出面板的文字； DOWN（长按） 开关自动阅读：每句显示完毕后 0.9 秒自动推进，按任意键解除。 长按判定 300 ms（由 BSP 显式下发，而不是用 button 组件默认的 1500 ms）。

模式与存档： 6 个手动存档槽，位置包含「分页中的第几页」（在槽上长按确定键删除）； 最后一次位置自动记住，「继续阅读」即从这里接着读；另有章节跳转列表，以及设置页 （文字速度：慢 / 中 / 快 / 瞬间，文字大小：16px / 20px 带实时打字预览，自动阅读开关）。 全部只有一个结局，读完后会清掉继续点。

亮点：

• 第三方美术随分支提交 —— 美术与剧本来自上游项目，而它未声明任何许可；它们提交在 assets/gal-source/， 因此 clone 就能构建出完整作品。打包器把它们打进独立的 4 MiB assets 数据分区（实际用 3.55 MiB）， 并在放不下时让构建失败而不是产出被截断的镜像；没有该目录时构建仍能启动，只是改为占位包。
• 串口截图 —— FAP_SCREENSHOT_V1 命令会通过控制台回一帧当前画面（RGB565LE），这是社区发布接受投稿前的硬性要求。
• 画面优先的界面 —— 标题背景、选项底板与对白面板都改为半透明叠色（30% / 50% / 70%）而不是不透明， 画面保持可见、近白色文字也压得住；固件也不会熄灭屏幕。
• 无 PSRAM 也能铺满全屏美术 —— 背景是内存映射分区里的 LVGL 索引图，直接从 flash 绘制、 按行解码（约 960 字节），而不是 150 KB 的帧缓冲；占用芯片 128 个 flash-MMU 页中的 83 个。
• 面板高度由字号推导 —— 四行 × 行高 + 内边距，因此 16px 与 20px 下一页四行都完整显示。 仍然放不下的长句是翻页而不是裁掉：切页在纯 model 层完成（含标点禁则），页号进存档。
• 按住快进不改 BSP —— BSP 没有松手事件，于是快进轮询公开的 bsp_button_read_mv()， 读数一旦离开该键文档化的电压窗口就停。
• 两次把素材体积压下来 —— 立绘先裁到真能进入屏幕的区域、再取 alpha 包围盒 （0.82 MiB → 0.24 MiB）；被替换的素材只存一份而非两份（4.41 MiB → 3.55 MiB）。
• 解析与排版有 host 测试 —— 包读取、推进规则与分页不依赖 ESP-IDF/LVGL，由 host 测试覆盖， 含格式要求的 4 字节结构对齐守卫，以及一条让打包素材名与固件查询名保持一致的守卫。
• 顺带修掉上游 8 处素材缺失 —— 上游剧本引用了 8 张它自己仓库里没有的图（其中 5 处是笔误）， 现在打包时逐条替换并报告，而不是在设备上画出空白帧。

把小米手环上的《ATRI -My Dear Moments-》同人移植搬到 AI Passport 上的竖屏视觉小说阅读器： 34 章、1,069 幕、12,188 句对白、5 张全身立绘、三个结局，完全离线。剧本与素材取自 fywmjj/better-mb9p-ATRI（它在 liuyuze61/ATRI-miband 基础上重构，补上了原版没有的 src/common/character/* 全身立绘）。原版是 Vela OS 的触屏应用，本分支用 C + LVGL 重写阅读引擎， 改成三键操作。状态：已发布 —— tag v1.0.2-atri-reader，并已投稿到 AI Passport 社区市场 （作品 my-dear-moments-2，审核中）。

• 分支：feature/atri-reader
• 发布：v1.0.2-atri-reader —— 合并镜像 FoloToy-AI-Passport-full.bin，5,134,544 字节
• 上游作品：fywmjj/better-mb9p-ATRI 与 liuyuze61/ATRI-miband —— 本次移植所依据的同人版本，两个仓库都未声明许可；其剧本、背景与立绘随分支提交并打包进固件，来源以上游项目标注。
• 素材工具链：tools/atri_pack.py（剧本 + 图像打包成 main/atri_data/atri_pack.bin，3.83 MB）与 tools/atri_font.py（16px 中文字体子集，2,771 个码位）

操作方式（三键）： 列表页上 / 下移动光标、确定进入、长按确定返回上一层；正文里 上 / 下短按是下一句、长按上是快进（松手即停，快进时整句直接显示）、 长按下开关自动阅读（打字完停 0.7 秒自动翻页，右下角显示「自动」，任意键停止，期间屏幕不熄灭）、 确定打开菜单（继续阅读、保存进度、读取存档、跳过章节、返回标题）；选项页上 / 下选择、确定确认， 跳过章节会一直推进到下一章，遇到选项或结局停下。长按判定 300 ms、短按 120 ms；文字速度可选 瞬间 / 慢 / 中 / 快，关于页用上 / 下滚动。

存档、结局与空闲： 五个手动槽 + 一个自动槽（每次换幕自动写入，标题页的「继续阅读」读它）， 存档页短按确定存 / 读、长按确定删除手动槽；剧本里的三次选择通向圆满或悲剧结局，两者都达成后 标题页解锁「真正的结局」，与原版手环应用的门槛一致。空闲 45 秒调暗、2.5 分钟熄屏、7 分钟深睡， 任意键唤醒，自动阅读期间不计入空闲。

亮点：

• 立绘跟着说话人 —— 只有带人物名称的台词才出现全身立绘，说完即收；事件 CG、黑屏与男主视角不出镜，立绘按原作站位靠右。
• 无 PSRAM 也扛得住整屏合成 —— 背景用 JPEG 直接解码进画布，立绘与特效叠加用无损 RGB565 + 4bpp alpha 遮罩（按 alpha 包围盒裁剪），空闲堆仍留 40 KB 以上。
• 离线数据管线 —— 运行时不下载任何东西，tools/atri_pack.py 与 tools/atri_font.py 的产物提交进仓库，普通 checkout 直接能编。
• 串口调试通道 —— ATRISHOT <章> <幕> 把任意一幕渲染进画面区并回传原始 240 × 320 帧，本版封面与历次版面验证靠的就是它；ATRIJUMP 可直接跳章。

把小米手环上的《星空鉄道とシロの旅》同人移植（含中文译文）搬到 AI Passport 上的竖屏视觉小说阅读器： 39 章、1,260 幕、13,787 句对白、一处选项、一个结局，完全离线。剧本、素材与译文取自 liuyuze61/Starry_Sky_Railroad_and_Shiro-s_Journey_miband9P （小米手环 9 Pro 快应用）；本分支在 ATRI 阅读器的 LVGL 页面系统上重写阅读引擎，改成三键操作。 状态：已发布 —— tag v0.1.0-starry-sky-railroad，并已投稿到 AI Passport 社区市场 （作品 community-0d8223f7，审核中）。

• 分支：feature/starry-sky-railroad
• 发布：v0.1.0-starry-sky-railroad —— 合并镜像 FoloToy-AI-Passport-full.bin，4,627,696 字节
• 上游作品：liuyuze61/Starry_Sky_Railroad_and_Shiro-s_Journey_miband9P —— 本次移植所依据的同人版本，未声明许可；其剧本、背景与立绘随分支提交并打包进固件，来源以上游项目标注。
• 素材工具链：tools/starry_pack.py（剧本 + 图像打包成 main/starry_data/starry_pack.bin，3.44 MB）与 tools/starry_lvgl_font.py（16px 中文字体子集，2,708 个码位）

操作方式（三键）： 列表页上 / 下移动光标、确定进入、长按确定返回上一层；正文里 上 / 下短按推进一步（打字中按一下先显示全文）、长按上是快进（松手即停）、 长按下开关自动阅读（每页显示完整后 0.9 秒翻页，按其它键停止）、确定打开菜单 （继续阅读、保存进度、读取存档、跳过章节、返回标题）；选项页上 / 下选择、确定确认， 跳过章节会播放章节过场卡并进下一章。短按判定 180 ms、长按判定 500 ms，由 BSP 显式 下发给按键组件。

存档、结局与空闲： 五个手动槽 + 一个自动槽（每次换场景自动写入，标题页的「继续阅读」读它）， 存档页短按确定存 / 读、长按确定删除手动槽；剧本只有一处选择、一个结局。空闲 60 秒调暗、 3 分钟熄屏、7 分钟深睡，任意键唤醒，自动阅读与快进不计入空闲。

亮点：

• 立绘只在该角色本人说话时出现 —— 打包器按「哪个有名字的说话人引用了这张立绘」统计归属，全剧本 11,777 个对白步里有 3,444 步会画出立绘；事件插画与纯色幕额外打标，永远不会被贴上人脸。
• 立绘压在半透明正文带下面 —— 蓝色文本框叠在人物之上，与源移植版一致：下半身落在面板里，带子以上的部分不受影响。
• 无 PSRAM 也扛得住整屏合成 —— 背景直接解码进 240 × 320 画布，立绘用无损 RGB565 + 4bpp 遮罩从 Flash 逐行 blit（完全不需要立绘解码缓冲），面板由 40 行分部缓冲推送。
• 离线数据管线 —— 运行时不下载任何东西，tools/starry_pack.py 与 tools/starry_lvgl_font.py 的产物提交进仓库，普通 checkout 直接能编。
• 串口调试通道 —— STARRYPAGE [title | <章> <幕>] 从 LVGL 刷屏路径取帧并回传原始 RGB565，本项目的历次版面核对靠的就是它；STARRYJUMP 可直接跳章。

把《魔女的夜宴》手环移植版搬到 AI Passport 的竖屏视觉小说阅读器:101 章、53,190 句对白、约 110 万字、五条角色线五个结局,全程离线。剧本与素材来自 hrk666666/Sanoba-Witch-MiBand-10(小米手环 9/10 快应用,其上游是已存档的 futrw4v/Sanoba-Witch-MiBand-9Pro);本分支在 ATRI 阅读器的 LVGL 页面体系上重写了阅读器,用三键操作。状态:已发布 —— tag v0.1.0-sanoba-witch,并已投稿 AI Passport 社区市场 community-8e228d9f(审核中)。

• 分支:feature/sanoba-witch
• 发布:v0.1.0-sanoba-witch —— 合并镜像 FoloToy-AI-Passport-full.bin,5,929,664 字节
• 上游工程:hrk666666/Sanoba-Witch-MiBand-10 —— 本分支的移植来源(其上游为已存档的 futrw4v/Sanoba-Witch-MiBand-9Pro)。其代码为 GPL-3.0;美术版权归 Yuzusoft,简体中文文本归暗鸽汉化组。打包用的素材随分支提交在 assets/sanoba-source/,并注明上游出处。
• 素材工具链:tools/sanoba_pack.py 与 tools/sanoba_scn_pack.py(图片包 2.97 MB、剧本包 1.45 MB,产出到 main/sanoba_data/),外加 tools/sanoba_font.py(16px 中文字库子集,3,458 字形,按剧本码表顺序生成,零缺字)

操作(三键): 列表页上/下移动光标、确定进入。阅读时 上/下 推进一句(打字机没打完按一下就显示完整,长句自动分页用下键翻页),上 长按 快进(松手即停),下 长按 切换自动阅读,确定 打开菜单(存档、读档、跳到下一个选项、自动播放、返回主页);选项处用上/下 + 确定。停在选项上不会关掉自动阅读,答完会自己接着读。短按判定 180 ms、长按 500 ms,由 BSP 显式下发给按键组件。

存档、结局与省电: 5 个手动槽位 + 1 个自动槽位(每次换场景写入),标题页的"继续阅读"直接接上。五条线对应五个结局。不操作时:60 秒调暗、180 秒熄屏、420 秒休眠,任意键唤醒;自动阅读与快进不计入空闲,屏幕保持常亮。

亮点:

• 紧凑剧本包,不是把剧本原样塞进去 —— 5.06 MB 的节点 JSON 变成 1.45 MB 的包,一次只解一块(单块解压 3 KB、缓冲 4 KB),因为开机后最大连续空闲块不到 8 KB;跳转目标走标签表直接定位,不扫块。
• 三个只在真机上才暴露的缺陷 —— 压缩流封装、块缓冲分配、主任务栈三者都表现为"一进阅读就全剧终";启动自检现在会打印首个块解压后的字节数与首句,这类问题在日志里就直接现形,不会再看起来像剧情结束。
• 版面按面板来 —— 240 × 320 竖屏:整宽背景、上三分之一处的 240 × 144 SD 窗、五行正文带。背景直接解进画布、SD 图解码进它占用的那段行,两者都不需要额外解码缓冲。
• 显示剧本自己的章节号 —— 角落浮层与换章卡显示源数据的编号(如 4-7),而存档标签与列表用场景名。
• 离线且可复现 —— 两个打包器与字库生成器都从 assets/sanoba-source/ 的入库素材运行;重建任一包都与固件里的逐字节一致。
• 串口调试通道 —— SANOBAPAGE [title | <场景> <句>] 在 LVGL 刷屏路径上抓整帧并以原始 RGB565 回传;SANOBASHOT、SANOBAJUMP、SANOBAAUTO 分别覆盖场景渲染、场景跳转与自动阅读检查。
• 没有人物立绘,也没有事件 CG —— 上游移植版就没有这两类图,所以人物说话时只显示名字牌,场面由背景 + Q 版演出小图承担;剧情文本、分支与五个结局都是完整的。

移植自小米手环同人移植版《千恋＊万花》的竖屏视觉小说阅读器：源移植版的完整剧情，外加 92 张背景、123 张立绘（含多套姿势）、570 张事件立绘 及其附带内容，全程离线。剧本与美术来自 hrk666666/Senren-Banka-MiBand-10（小米手环 9/10 快应用）；本分支在 ATRI 阅读器的 LVGL 页面系统上重写阅读引擎，改由三个按键操作。状态：已发布 —— tag v0.1.0-senren-banka，并以 community-07c775dc 提交到 AI Passport 社区市场（审核中）。

• 分支：feature/senren-banka
• 发布：v0.1.0-senren-banka —— 合并固件 FoloToy-AI-Passport-full.bin，7,997,648 字节（该镜像已在真机验证；CI 用同一份源码重建）
• 上游来源：hrk666666/Senren-Banka-MiBand-10 —— 本分支移植的来源项目，未声明许可证；其剧本与美术随本分支收录在 assets/senren-source/（92 张背景 / 123 个立绘 / 570 张事件插图 / 112 个剧本分块，含记录上游引用与逐文件 SHA-256 的 MANIFEST.json，也可用 tools/senren_fetch_source.py 重新拉取），打包进固件并署名来源。按应用首次启动的说明，本移植仅供个人学习交流。
• 素材工具链：tools/senren_pack.py（图片包 5,263,756 字节，输出到 main/senren_data/）、tools/senren_scn_pack.py（剧本包 1,432,148 字节）与 tools/senren_lvgl_font.py（16px 中文子集，3,492 个字形，按码点顺序供稀疏字体二分查找）；两个包都能用 assets/senren-source/ 离线重打，且与已提交的包字节级一致

操作（三键）： 列表页上 / 下移动光标、确定进入。阅读时 上 / 下 推进一行（打字过程中按一下先补全，一行放不下会分页），长按上快进、松手即停，长按下切换自动阅读，确定（短按或长按）打开菜单 —— 继续、保存、读取、跳过章节、返回标题。选项用上 / 下 + 确定，选中即存档。短按阈值 180 ms、长按 500 ms，由 BSP 显式传给按键组件。

存档、章节与空闲： 1 个自动存档位 + 5 个手动位，自动位在每次换章、每次选项和入睡前写入，标题页以「继续」入口呈现。每章进入时显示 Chapter X-X 卡片（章 + 节）。空闲策略：60 秒调暗背光、180 秒熄屏、420 秒进入 deep sleep，任意键唤醒；自动阅读与快进不计入空闲时间，因此长时间挂着不会自动变暗或休眠。

亮点：

• 自写 inflate 替代 ROM 解压器 —— 整块解压到一个缓冲区，不需要 32 KB 滑动字典，在没有 PSRAM 的板子上把工作缓冲压到 4 KB。
• 分块调色板图片格式 —— 背景与事件立绘存为 240 × 320 JPEG，立绘按姿势分块、底部对齐，事件立绘的变体以基础图 + 稀疏遮罩补丁表示，哪种更小就用哪种。
• 剧本按 3 KB 分块打包 —— 用约 200 KB 压缩率换来同样的 4 KB 缓冲；所有跳转目标经分块表解析，不做全文扫描。
• 「菜单自己弹出来」背后的真机发现 —— 三个按键共用一个 ADC 引脚、按电压区间区分；长按过程中触点短暂断开会让电压扫过相邻区间而被读成另一个键。BSP 现在在电压回到释放区间前锁定按键身份，并在确认前持续 40 ms 才接受按键。这属于板级逻辑，应回到上游。
• 串口调试通道 —— SENRENPAGE [title | <章节> <步>] 从 LVGL flush 路径抓帧并以原始 RGB565 回传；SENRENJUMP、SENRENSKIP、SENRENSAVE、SENRENLOAD、SENRENINFO 与 SENRENKEYS（最近 32 个按键事件及其被识别时的 ADC 电压，正是上面按键区间缺陷的证据）覆盖跳章、跳过、存读档、状态读取与按键追踪。

移植自小米手环 10 同人移植版《沙耶之歌》（liuyuze61/Saya-miband10）的横屏视觉小说阅读器：44 章、473 个场景、3,828 段对白、3 个结局，全程离线。手环版是竖屏触控应用，本分支用 C + LVGL 重写阅读引擎，改由三个按键操作。状态：已发布 —— tag v0.1.1-saya-no-uta，已在 AI Passport 社区市场以 community-10803507 上架。

• 分支：feature/saya-no-uta
• 发布：v0.1.1-saya-no-uta —— FoloToy-AI-Passport-full.bin（community 变体，由 CI 构建），另附一份供个人设备使用的含补丁本地构建
• 数据管线：tools/saya_pack.py（剧本与图片 → main/saya_data/saya_pack.bin，约 3.9 MB）与 tools/saya_font.py（16px / 20px 中文字体子集，由仓库内生成器产出）

操作（三键）： 开机警告页用上 / 下滚动，读到最后提示才会变成「按确定继续阅读」。列表页上 / 下移动光标（到顶 / 到底停住），确定进入，长按确定返回。阅读时 确定 打开菜单；上短按推进一段（打字过程中按一下先补全），长按上 1 秒快进（每 180 ms 一段）松手即停；下短按回看上一页，长按下 1 秒进入自动播放 —— 每段打完字后 900 ms 推进一段，任意键、选项与结局处自动停下。菜单含保存、读取、跳过章节、返回标题与关闭；跳过章节时会停在尚未遇到的选项上。设置含文字速度（慢 / 中 / 快 / 瞬间）与字号（16px / 20px）。

存档与空闲： 5 个手动存档位 + 1 个自动位（每次换场景写入），标题页的「继续」从自动位接上；保存模式下在槽位上长按确定可删除。空闲策略：60 秒调暗背光、3 分钟熄屏、7 分钟进入 deep sleep，任意键唤醒并从自动存档继续；自动播放期间不调暗、不息屏。

亮点：

• 背景直接从 Flash 解码 —— 每张背景打包时一次性缩放到整幅 320 × 240，存成两张 1:1 JPEG（第 0–149 行、第 150–239 行），立绘存成 JPEG + 1bpp 遮罩；资源包 mmap 直接读取，运行时不解析 JSON、不解压。
• 一份仓库、两个版本 —— 入库的资源包是 community 变体；含补丁的完整版由 assets/saya-patch/ 本地重建，其资源包与固件不入库、不发布。
• 自研字体生成器替代 lv_font_conv —— 该工具最后一版在当前 Node.js 下写出的字形位图是坏的；仓库内置生成器会回读自己写出的 C 文件、逐字形与栅格化结果比对后才落盘。
• 内容与授权 —— 剧情含大量血腥内容，保留源移植版的开机警告；《沙耶之歌》是 Nitroplus 的商业作品，本移植为个人同人作品，生成的资源包不得作为素材再分发。

把 AI Passport 变成一台随身 AI 对讲机：按住 OK 说话 → 手机端 App 作为中介，把你的话交给 后端 AI → 回答同时回到设备小屏和手机里。手机端作为中介，连接你的对讲机和后端 AI：后端 可以是 OpenClaw，也可以是兼容 OpenAI 的 Hermes 等接口。设备本身不用联网，语音只在 「设备 ↔ 手机」之间走蓝牙。状态：已发布 —— tag v1.8.0-intercom，并已在 AI Passport 社区上架。

• 社区作品：随身 AI 对讲机 · Pocket Intercom（community-82cbed79）

• 分支：feature/openclaw-intercom

• 发布：v1.8.0-intercom —— FoloToy-AI-Passport-full.bin（由 CI 构建）；后续版本到 Releases 列表 里找名字带 intercom 的最新一版

• 手机端 App（另一个仓库）：Shinku-Chen/ai-passport-openclaw-android —— Android 8+，在它的 Releases 里下载已签名的 app-release.apk

• 协议文档：docs/development/engineering/intercom-wire-protocol.md（中英各一份）

操作（三键）： 按住 OK 说话 —— 设备屏立刻变红表示正在准备，变绿就可以说，松手即发送；短按 OK 只点亮屏幕，长按 UP 进设置（亮度 / 设备信息），UP / DOWN 翻看历史消息。

亮点：

• 设备端 Opus 上行 —— 16 kHz 采集、60 ms 帧、DTX，约 3 KB/s（PCM 的十分之一）；在没有 PSRAM 的 ESP32-C3 上用静态栈跑编码，避开堆碎片。
• 手机端当网关 —— App 负责语音识别、把文本交给后端（OpenClaw 走 websocket RPC + ed25519 设备身份；Hermes / 自定义走 OpenAI 兼容 HTTP），再把回答回传设备；设备端不解析 HTTP、不存密钥。
• 按下即红、就绪变绿 —— 按键一按下就变红并开始听，网关就绪后转绿，实测按下到变绿约 280–290 ms；识别通道常驻预热，不用等连接。
• 网关授权闭环 —— OpenClaw 要求设备先被批准，未批时 App 直接显示「等待网关授权……（deviceId …）」，在控制台 Devices 页批准或跑 openclaw devices approve <deviceId>，批准后自动继续。
• 回复收集 —— 网关的状态话术、流式片段与工具输出分开处理，正文取终局消息并用 chat.history 补正，设备只显示一轮一个正文气泡。
• 没有语音生成 —— 当前版本不接 TTS：回答只以文字上屏（设备屏 + App），设备不会念出来。

• 每个应用都是基于上游基线的一个独立 feature/* 分支。不要把 demo 分支整支合入 main；需要复用时应抽取可移植的模式（见上游 AGENTS.md）。
• 烧录使用在线刷机工具或 esptool —— 每个 release 都提供合并固件 FoloToy-AI-Passport-full.bin，从偏移 0x0 写入即可。 目标板卡：8 MB Flash。
• 这些发布沉淀的可复用工程经验位于 docs/reference/shinku-chen/。