quotaframe-ai-1e8eb2dd
Revision 1
Initial draft
项目简介
QuotaFrame 将 Codex 和 Claude 的用量百分比与额度重置倒计时放到 ESP-Mosaico 的桌面屏幕上。编程时抬眼即可查看额度状态，无需频繁切换窗口。
ESP-Mosaico 功能
- 在 480×480 AMOLED 屏幕上显示 Codex / Claude 用量和额度重置倒计时。
- 支持触屏操作、AI 按键和屏幕自动旋转。
- 通过蓝牙与电脑端 QuotaFrame Bridge 同步；断开连接后保留最后一次用量数据。
- 支持通过 Bridge 发起蓝牙固件更新，更新需在电脑和设备两端确认。
数据与隐私
数据链路为 CodexBar / Win-CodexBar → 电脑端 QuotaFrame Bridge → 蓝牙 → ESP-Mosaico。账号登录与用量获取由电脑端数据源负责；Bridge 仅向设备发送用量百分比、重置时间和采样时间等显示摘要，不传输账号凭据。
使用方法
1. 烧录固件
在电脑的 Chrome 或 Edge 中打开 QuotaFrame 网页烧录工具，选择 ESP-Mosaico，通过 USB 按网页指引烧录固件。
2. 配置用量数据源
macOS： 安装并配置 CodexBar，在其高级设置中安装 CLI。
Windows： 使用 Win-CodexBar CLI，并确保相关账号已登录。
3. 安装 Bridge 并配对
下载并安装对应平台的 QuotaFrame Bridge（Windows 或 Apple Silicon Mac），在托盘或菜单栏菜单中选择“添加设备”，按提示完成蓝牙配对。
4. 查看用量与更新固件
配对后 Bridge 自动同步用量，即可在 ESP-Mosaico 屏幕上查看。后续可从 Bridge 菜单发起固件更新，并在电脑和设备两端确认。
开源项目
项目代码采用 MPL-2.0 许可证；第三方组件遵循各自许可证。