v0.3.1 · 限频亮屏与省电优化

Codex Passport 0.3.1 减少连续提醒造成的长时间亮屏，并在熄屏后停止普通界面重绘。同步、未读记录、大 dashboard 和三会话进展页继续保留。

• 新的待回复／待批准通知最多每 5 分钟自动亮屏一次，每次约 15 秒。连续提醒不续亮，开机历史、重复投递和冷却期内的提醒不会稍后补亮。
• 新安装默认 35% 亮度、30 秒无操作后熄屏。已有亮度、熄屏、静音和配对设置保留；按键查看仍使用保存的时长。静音只控制声音，不关闭视觉提醒。
• 熄屏后继续接收数据和确认回执，唤醒前更新画面；降低主循环空闲轮询和电量读取频率。首次按键只唤醒，上／下切页的规则保持。
• Android 补充通知亮屏说明，并更新「日常使用」预设。Python 0.3.1 更新版本信息和指南，0.3.0 中继与现有手机 App 仍兼容新版固件。
• USB 增加只读 POWER 诊断，可检查实际背光占空比和重绘次数，不输出会话或网络凭据。

升级：省电策略需要更新 Passport 固件。APK 可覆盖安装，签名与 0.3.0 一致；无需卸载或重新配对。Python 可按指南升级并保留状态目录。APK 仍使用调试签名。

codex-passport-0.3.1.bin 是应用固件，只写入官方设备布局的 0x10000，保留 bootloader、分区表、NVS、cardid 和 Recovery。不要整片擦除，也不要把这个应用文件写到 0x0。下载文件附 SHA256 校验和第三方许可证。

验证：33 项 Python 测试（源码及隔离 wheel 环境）、原生省电／提醒／按键回归和固件／APK 构建通过。行为相同的开发固件实测连续提醒后 15.401 秒熄屏、两次自动亮屏间隔 304.088 秒；熄屏继续同步且不重绘。手机与电脑 BLE 往返及主动查找通过，用户确认首次 OK 只唤醒、未读保留、两页切换正常。正式 0.3.1 固件已通过写入校验及手机路径的版本回执。

未测量实际省电比例或续航；本轮未复测 Wi-Fi、首次配对码、RF 距离和外网 WireGuard。手机新版说明页完成构建，实机链路验收使用现有 App。当前仍为只读进展伴侣，回复、恢复会话和审批在 Codex 中完成。

English: Version 0.3.1 bounds attention-triggered wakeups to about 15 seconds, no more than once every five minutes, and defers normal rendering while dark. Saved settings, unread state and BLE bonds remain intact. Android updates presets/guidance; the Python update contains metadata and documentation changes. Existing 0.3.0 relay/app installations remain compatible. The wake policy and physical buttons passed the checks described above; battery savings have not been measured. Flash only the application binary at 0x10000 on the documented official layout. The APK is debug-signed with the same certificate as 0.3.0.

中文一步步入门 · Python / uvx · 省电检查 · 验证记录