架构设计

仓库按产品线与受众横向切分：

• firmware/port/ 是上游 MicroPython ESP32 port 的定制分支，提供 C 层 builtins（firmware/port/builtins/）与 Python 层扩展库（firmware/port/modules/），并通过 board-specific 目录（port/boards/mpython*、labplus_*）组合出不同板型；文件系统的 Python 模块（file_system/）在运行时加载。

• esp32s3/ 是 ESP32-S3 升级线，独立维护基于 ESP-IDF v5.x + MicroPython v1.24.1 + CMake 的固件源码（esp32s3/firmware/）与 Sphinx 文档（esp32s3/docs/），新增 LVGL、AI 云端、GPS、心率等组件，并集成小智语音助手（docs/4_xiaozhi/）。

• docs/ 为 ESP32 版的 Sphinx 中文手册与示例代码，与 esp32s3/docs/ 结构镜像但内容独立，分别对应两套固件 API。 三者在构建产物上互不依赖，通过“同一套 mPython API 约定”和“board manifest 机制”保持跨板兼容；新增板型只需复制 board 目录并修改 mpconfigboard.h 与 manifest.py。