AI Mac 小屏幕

桌上的一台 AI 状态小电脑 —— ESP8266 · 开源硬件 · 桌面伴侣

一块 240×240 的复古小电视，放在桌上实时显示 Claude Code / Codex CLI 在干什么、额度还剩多少。不需要任何 API key：数据来自本机已有的 CLI 登录凭据和会话日志，由配套的 Mac / Windows 桥接程序在局域网内提供给设备。

功能


	AI 工作状态与额度桌宠动起来 = AI 正在干活。方形进度环 + 大字显示 5 小时 / 周额度的真实用量；额度用满自动换成重置倒计时，等你审批时整圈边框红闪提醒。
	网速实时监视任务管理器风格的上下行曲线，56 秒滚动窗口，量程自动调整。
	音乐播放显示专辑封面、歌名、歌手、进度条实时同步；音乐响起自动切入，停止自动切回。
	可换桌宠内置 petdex.dev 画廊 3300+ 开源桌宠，也可上传任意 GIF，设备板上直接解码，无需重烧固件。

快速上手

需要的东西：一台「SD2 小电视」开发板（开源硬件，也可直接购买成品）、一根 USB 数据线。

第 1 步 · 刷固件（约 30 秒）

用 Chrome / Edge 打开 mac.qust.me/#flash，USB 连接设备，点「连接设备并烧录」，选择串口等待完成即可，无需安装任何工具。

弹窗里看不到串口？Windows 需要装 CH340 驱动，Mac 系统自带无需安装；换根 USB 线（很多线只能充电）；更多排查见官网 FAQ。

命令行党也可以用 esptool 把 Releases 里的 esp8266-ai-firmware-*.bin 刷到 0x0。

第 2 步 · 配 WiFi

设备首次开机会开热点 AI-Clock-Setup：手机连上后自动弹出配网页（没弹就用浏览器打开 192.168.4.1），选择家里 WiFi、输入密码，完成。

第 3 步 · 装桥接程序

从 Releases 下载并打开：

macOS：AIClockBridge-*-macOS.dmg，拖入 Applications（ad-hoc 签名，首次启动需在「系统设置 → 隐私与安全性」允许，并同意本地网络权限）
Windows：AIClockBridge-*-Windows-x64.exe，双击即用

桥接程序常驻菜单栏 / 托盘，会自动发现并配对同一局域网内的设备——到这里屏幕就活了。

日常使用都在托盘图标上：左键打开设备画面的实时镜像（底部有屏幕亮度滑条），右键是完整菜单（额度详情、屏幕切换、更换桌宠、音乐/网速页等）。

常见问题

屏幕边框红色闪烁：设备连不上桥接程序——确认电脑端程序在运行、和设备在同一 WiFi。
额度一直显示 -：本机没有登录过 Claude Code / Codex CLI，桥接程序读不到凭据。
想换桌宠：右键托盘图标 → 「更换桌宠动画…」，挑一个点上传就行。

开发

firmware/     ESP8266 固件（PlatformIO + Arduino，含板上 GIF 解码）
mac-app/      macOS 菜单栏桥接（Swift/SPM，零第三方依赖）
windows-app/  Windows 托盘桥接（C# / .NET 8 WinForms）
tools/        GIF → RGB565 内置精灵图转换脚本
docs/         开发文档（硬件引脚、HTTP API、架构细节）

cd firmware && pio run -t upload   # 固件：编译 + USB 烧录
cd mac-app && swift run            # Mac 桥接：本地跑起来

硬件引脚表、屏幕驱动的坑、设备 HTTP API、GIF 板上解码架构等细节见 docs/DEVELOPMENT.md。

硬件、固件、软件全部开源，拿去改、拿去做、拿去卖都行。

jimersylee/zen-desktop-pet

README