一个 7 岁小朋友创作的 AI 路易吉鬼屋

这是一个运行在 AI PASSPORT / FOLOTOY MOTE 上的离线三键回合小游戏，由一位 7 岁小朋友提出玩法并参与创作。角色不会自动走路：玩家每次按最下键向前走一步，看到事件后再选择正确动作。

玩法

• 遇到幽灵：按最下键跳过去。
• 遇到金币堆：按最上键吸进去。
• 遇到土堆：按中间键吹散。
• 每次正确动作奖励 1 枚金币；按错立即进入死亡界面。
• 死亡时可以消耗 1 根骨头继续，也可以不消耗骨头结束本局。
• 商店默认兑换 1 根骨头，也可以一次兑换多根；2 枚金币换 1 根骨头。
• 金币、骨头和最高分永久保留；每局开始时，骨头不足 2 根会补到 2 根。

画面由 LVGL 确定性绘制，包括绿色吸尘器角色、鬼屋走廊、幽灵、金币堆和土堆。版本 0.1.3 使用包含游戏文字及全角标点的 4-bpp 中文字库，并使用适合无 PSRAM ESP32-C3 的轻量位移动画。

English

AI Luigi's Mansion Created by a 7-Year-Old

An offline, turn-based three-button mini-game for AI PASSPORT / FOLOTOY MOTE, based on gameplay ideas created with a seven-year-old child. The character never moves automatically: press the bottom button to take one step, then react to the event ahead.

• Ghost: press the bottom button to jump over it.
• Coin pile: press the top button to vacuum it up.
• Dirt pile: press the middle button to blow it away.
• Every correct action awards one coin; a wrong action immediately ends the run.
• Spend one bone to continue after a failure, or end the run without spending one.
• The shop defaults to one bone and supports buying several at once. Two coins buy one bone.
• Coins, bones, and the high score persist. A new run tops the player up to two bones when fewer than two remain.

Version 0.1.3 uses a compact 4-bpp Chinese font and lightweight position-only animations designed for the no-PSRAM ESP32-C3.

构建 / Build

需要 ESP-IDF 5.5.3：

source /path/to/esp-idf-v5.5.3/export.sh
idf.py set-target esp32c3
idf.py build
python3 scripts/release.py

主机规则测试：

cmake -S host_test -B build-host
cmake --build build-host
ctest --test-dir build-host --output-on-failure

安全边界 / Flash safety

设备身份区为 0x356000..0x359fff。禁止整片擦除，也不要向这个范围写入。Web BIN 必须通过：

python3 scripts/verify_web_image.py releases/*-web.bin --manifest releases/*.manifest.json

本项目只生成固件和发布包，不会自动刷写设备。版本 0.1.3 已在真实 AI PASSPORT 设备上完成按钮、动画、存档和持续运行测试。

素材与权利说明 / Fan-project notice

这是个人学习和试玩用的非官方同人项目，与 Nintendo 无关。项目画面和名称包含对《路易吉洋馆》的致敬；请勿在未获得相关权利人许可的情况下用于商业用途。

This is an unofficial fan project for personal learning and play. It is not affiliated with or endorsed by Nintendo. Do not use the Luigi-inspired name or visuals commercially without permission from the relevant rights holders.