vibe-usage-esp32

这是一个开源 ESP-IDF 固件项目，两个正式产品分别为 Vibe Passport（FoloToy
AI Passport 硬件）和 Vibe Note（黑白版 ZECTRIX NOTE4 硬件），直接显示
Vibe Usage。设备通过浏览器完成 Vibe Device Flow，自行调用
HTTPS Usage API；固件中不内置个人 API Key。

当前产品版本为 0.0.1，统一维护在 VERSION 中。
仓库：talisk/vibe-usage-esp32。
作者：SwainTalisk。两个 Settings 菜单均使用
VibeCafe 作为账号入口；About 展示产品名、版本、完整仓库与作者链接。
Passport 使用向内收的 ↑ / ↓ 页脚箭头，圆角外侧为黑色。

Vibe Passport	Vibe Note

产品展示图由项目作者提供，可点击放大。

[!IMPORTANT]
本项目是独立社区项目，不代表 Vibe、FoloToy 或 ZECTRIX 官方。NOTE4 仅支持
400 × 300 黑白墨水屏版本，不兼容 NOTE4C。

功能

• Today / 最近 7 天 Token 总量与来源排行。
• 对 API totalTokens 做精确无符号 64 位求和，不经过浮点数。
• 流式、有界 JSON 解析；遇到未知分页、半包、超限或 schema 错误时拒绝候选，
  保留 Last Known Good。
• Device Flow 授权二维码与 user code；API Key 不进入 UI。
• 最多保存 10 组 2.4 GHz Wi‑Fi，支持隐藏 SSID 主动回退与同名 AP 强信号选择。
• 带 CRC、账号 generation 和时区隔离的 8 日 A/B 缓存。
• 持久化 Retry-After、串行网络 worker、异步取消与可续跑 Factory Reset。
• Passport LVGL 界面与 30 秒降背光；NOTE4 全刷/局刷策略与长按关机。
• 双目标干净构建、Passport 保护区校验、Release manifest、SHA-256 与 SPDX 清单。

屏幕口径固定为 API_TOTAL_V1，即所有 bucket 的 totalTokens 安全求和。当桌面
App 额外计入 cached input 时，两者可能不同。详见
API 契约。

支持硬件

了解两款产品的原始硬件：Vibe Passport 对应
FoloToy AI Passport 开发资源，Vibe Note 对应
ZECTRIX NOTE 硬件规格。
这些上游链接介绍硬件本身，不代表本社区固件。

设备	芯片	屏幕	Flash	默认刷新
FoloToy AI Passport	ESP32-C3	ST7789，240 × 320	8 MB，无 PSRAM	15 分钟
ZECTRIX NOTE4 BLACK-WHITE	ESP32-S3	SSD2683，400 × 300	16 MB，8 MB 八线 PSRAM	30 分钟