LCD 图片资源优化与维护

目标

固件使用的 LCD 为 RGB565 显示格式，而设计工具导出的 PNG 通常是 RGB888 或 RGBA8888。原始 PNG 中包含 LCD 无法显示的颜色精度，部分图片还携带未实际使用的 Alpha 通道。

本项目在不改变 LCD 最终 RGB565 像素的前提下，将固件图片转换成 RGB565 颜色精度，并在颜色数量不超过 256 时保存为索引色 PNG，以降低应用镜像中的素材占用。

正常固件编译直接使用已经提交到 Git 的优化图片，不要求开发环境安装 Pillow。只有修改或验证图片资源时才需要 Pillow。

components/platform/assets/
├── lcd_source/       原始设计图片，不直接打包进固件
└── lcd_optimized/    优化图片和 manifest.json，固件实际使用

两个目录中的 PNG 文件名必须一致。运行时逻辑名称为 lcd/<文件名>.png，业务代码不需要区分原图和优化图。

lcd_source 中的 OTA.gif 是历史资源，不属于当前 PNG 优化和嵌入素材清单。

脚本 tools/optimize_lcd_assets.py 对每张 PNG 执行以下操作：

只要有一个 RGB565 像素不同，生成操作就会失败。发现透明或半透明图片时也会停止，避免静默删除有效透明度。

建议使用独立 Python 虚拟环境，避免修改系统 Python：

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r tools/requirements-assets.txt
python tools/optimize_lcd_assets.py check-env

ESP-IDF 自带的 Python 环境如果已经安装对应版本的 Pillow，也可以直接使用。

只修改 lcd_source 中的原图，不要手动编辑 lcd_optimized。

生成全部优化图片：

python tools/optimize_lcd_assets.py generate

执行完整的 RGB565 等价验证：

python tools/optimize_lcd_assets.py verify

然后检查并提交以下内容：

components/platform/assets/lcd_source/
components/platform/assets/lcd_optimized/
components/platform/assets/lcd_optimized/manifest.json

不要反复处理 lcd_optimized 中的图片。每次必须从 lcd_source 原图重新生成，避免累计颜色或压缩处理误差。

普通构建不生成图片，也不导入 Pillow。构建系统只执行基于 Python 标准库的哈希检查，确认：

资源过期时，构建会停止并提示重新运行 generate。资源有效时，构建系统把 lcd_optimized 中的 PNG 复制到构建目录，生成只读素材包并链接到应用镜像。