A LITTLE SPACE FOR YOUR AI USAGE

AI 编码额度，
抬眼即见。

让 Codex 和 Claude 的用量，
在桌面上有自己的位置。

一块独立小屏，显示额度百分比与重置倒计时。
少一次窗口切换，多一点专注。

设置我的设备试试桌面交互

开源项目 · 本地 Bridge · 加密蓝牙同步

界面实时还原 · 演示数据，非设备实拍

MADE FOR YOUR DESK

重要的信息，留在视线里。

从电脑获取用量，通过蓝牙同步到小屏。
电脑端需要持续运行，才能保持数据更新。

01 / 一眼看全

两个工具，一个总览

把 Codex 和 Claude 放在一起，看清短期和每周用量。

02 / 心里有数

知道何时恢复额度

百分比与重置倒计时同时显示，接近用量上限时更醒目。

03 / 陪伴专注

看时间，也留意额度

微雪 AMOLED 时钟旁，两条进度显示用量。接近上限，百分比会醒目显示。

第 1 步

选择你的设备

按外观和完整型号核对。相同芯片的不同设备不能混用固件。不确定选哪块？看设备对比

正在读取支持的设备…

设备图来自 M5Stack 、微雪官方文档与乐鑫官方文档，屏幕内容为厂商演示。

第 2 步

安装固件

先连接，再开始

用 USB 数据线连接设备，关闭占用串口的程序。点击下方按钮后，在浏览器弹出的列表中选择这台设备。

固件与安装信息

设备
文件
安装方式: 完整镜像 · 从地址 0x0 写入

安装前擦除设备清除设备上的原固件、配置和蓝牙绑定信息。

已有设备？了解擦除与配对

电脑上的蓝牙配对记录不会被擦除。安装后请删除电脑中的旧配对记录，再重新配对。

取消勾选只会跳过整片擦除。本次仍写入完整镜像，不能保证保留设备配置或绑定信息。

我已核对设备型号，了解本次安装会覆盖固件，并可能重置配置与绑定信息。

烧录时请保持页面打开、电脑唤醒和 USB 连接稳定。

连接或安装遇到了问题？

列表里没有设备：确认 USB 线支持数据传输，尝试其他 USB 接口，并检查设备所需驱动。
连接失败：关闭占用串口的终端、烧录程序或其他浏览器标签。按设备厂商说明进入下载模式，再次连接。
下载失败：检查网络后重试。设备已经擦除或开始写入时，请重新完成安装。
型号或芯片不匹配：返回核对设备型号，不要绕过校验安装其他设备的固件。
写入中断：保持供电稳定，重新连接并安装。已擦除的数据不会恢复。
安装完成但屏幕没变化：尝试重新上电；写入完成并不代表设备已成功启动。仍有问题时查看设备文档。

查看设备说明与手动安装方法

ONE LAST CONNECTION

在电脑上连接它。

固件安装好后，完成这三件事，
让用量从电脑走到桌面。

macOS 14 或更新版本 · 仅 Apple Silicon · 需要蓝牙

准备好用量来源

安装 CodexBar，登录所用账号，确认能正常显示用量。

在 CodexBar 的 Preferences → Advanced 中选择 Install CLI，让电脑端能够读取用量。
安装 QuotaFrame 电脑端

在发布页下载 macos-arm64 .dmg 安装包，安装并打开 QuotaFrame Bridge。
前往下载电脑端
添加设备，开始同步

在电脑端添加蓝牙设备，按提示完成配对。屏幕出现用量百分比和重置倒计时，就可以开始使用了。

重新烧录过设备？先删除电脑中的旧蓝牙配对记录。完整电脑端指南

试试 Bridge 的快捷操作

在 macOS 菜单栏或 Windows 托盘，点击或滚动 Bridge 图标，就能控制小屏。

额度总览

Bridge 图标

左键单击，切换时钟。
在图标上滚动，翻看额度。

演示数据，无需连接设备。实际操作需配套 Bridge 与固件，会控制所有兼容的已连接设备；时钟切换支持微雪 AMOLED。

CHOOSE YOUR SCREEN

四块小屏，各有所长。

显示内容相同，差别在屏幕与交互。

	微雪AMOLED 2.16	M5StackStickS3	微雪ePaper 3.97	乐鑫ESP-Mosaico
屏幕	480 × 480 圆角方形 AMOLED	135 × 240 LCD	800 × 480 四灰阶墨水屏	480 × 480 AMOLED
用量页面	总览 / Codex / Claude	总览 / Codex / Claude	主页同屏显示 Codex 与 Claude，另有趋势页	总览 / Codex / Claude
翻页	触控标签、左右滑动	正面按键	三向拨轮	触控标签、左右滑动、AI 键
时钟屏保	支持	不支持	支持	支持断电后需电脑端重新校时
屏保用量细条	支持	不支持	支持	支持
自动旋转	支持四向	不支持	支持四向	支持四向
摇动 / 翻转唤醒	支持	不支持	不支持	支持
屏上设置	支持亮度、时钟超时	不支持	支持刷新间隔、方向	支持亮度、时钟超时
托盘单击切换时钟	支持	不支持	支持	支持
温湿度	不支持	不支持	支持时钟页	不支持
用量趋势	不支持	不支持	支持需 SD 卡	不支持

四块屏都支持：Codex / Claude 用量显示、电量与充电显示、断连保留最后用量、在托盘图标上滚动翻页、电脑端 OTA 更新与网页安装。

LOCAL BY DESIGN

凭证留在本机，
小屏只收摘要。

QuotaFrame 不接管账号登录，只将本机整理的用量摘要发送到已配对的小屏。

留在这台电脑上

登录与凭证

邮箱与账号
Token 与 Cookie
API Key
套餐与费用

Bridge 只提取用量摘要，账号与凭证不写入蓝牙消息或常规日志。

经加密蓝牙送出

一条摘要示例

SOURCE	USED	RESET
CODEX	42%	2H 14M
CLAUDE	87%	47M

用量同步只发送摘要与同步状态，小屏无需登录账号。

QuotaFrame 不设用量云服务。获取用量与检查更新仍需联网。

你可能还想知道

需要一直连接 USB 吗？

首次安装固件需要 USB 数据连接。用量通过蓝牙同步；日常使用仍需根据设备情况供电或充电。

电脑需要一直开着吗？

需要保持电脑端运行、蓝牙连接正常，并能从 CodexBar 或 Win-CodexBar 读取用量，屏幕才能继续更新。

已经装过固件，如何更新？

Windows 可通过 QuotaFrame Bridge 的 OTA 功能更新固件。macOS 暂未提供 OTA，请连接 USB，使用网页安装对应型号的固件；网页也可用于首次设置或恢复设备。

可以使用其他 ESP32 屏幕吗？