ESP8266 · 开源硬件 · 桌面伴侣

桌上的一台
AI 状态小电脑

一枚可以捧在手心的复古麦金塔小屏幕,实时显示 Claude Code 与 Codex CLI 的工作状态、真实额度、网速和正在播放的音乐 —— 不需要任何官方账单 API key,数据全部来自你本机。

无需 API key· 支持 Windows / Mac· 网页一键刷机· 240×240 彩屏· 硬件 + 软件全开源
手心里的 AI Mac 小屏幕,屏幕上显示戴耳机的像素桌宠和 5h / 周额度百分比

它能显示什么

一眼看清你的 AI 在忙什么。

全屏单应用视图,谁在干活就显示谁。像素桌宠 + 一圈方形额度环,工作时动起来、空闲时静止。

屏幕显示戴蓝色耳机的像素桌宠、顶部绿色额度进度条,下方 5h 24% / Weekly 3%
实时状态

AI 工作状态与额度

working / idle / offline 一目了然。方形进度环 = 5h 与周窗口的真实用量百分比,颜色像红绿灯一样从绿到黄到红。

任务管理器风格的网速曲线页,DOWN 53K/s、UP 1.2M/s,绿色面积图
网速曲线

实时网速监视器

任务管理器风格的滚动面积图,56 秒窗口、逐行写屏完全无闪烁。上下行读数取 1 秒平均,数据来自 Mac 内核网卡计数。

小屏幕显示万能青年旅店的专辑封面、歌名、歌手与播放进度条 0:23 / 5:44
音乐播放页

正在播放,一屏尽览

专辑封面、歌名、歌手和播放进度条实时同步 Mac 上正在放的歌。封面 128×128 逐行绘制,每 2 秒刷新。

屏幕显示一只黄色小河马桌宠,左上角 Codex 图标,下方 5h 1% / Weekly 22%
桌宠可换

3300+ 开源桌宠随便换

内置 petdex.dev 画廊,搜索选一个动画一键上传。设备自己在板上解码缩放,重启也记得,不用重新烧录。

🖥️ 实时镜像

Mac 菜单栏左键弹出与设备完全同步的画面,不看设备也能确认。

🔴 红绿灯信号

桥接掉线或数据过期时红色闪烁,提醒你马上看一眼。

🔌 零配置配对

设备本来就在轮询本机,Mac 端记下来访 IP 即完成发现。

工作原理

两块拼图:桥接 app(Windows / Mac)+ ESP8266 固件。

电脑上的桥接 app(同时支持 Windows 和 Mac)读本地会话日志、开一个局域网 HTTP 服务;小屏幕联网后每 15 秒轮询它,把状态画到屏上。

手持小屏幕显示 working 状态:绿色进度环填满、桌宠在跑,背景 Mac 屏幕上是菜单栏 app 弹出的同款实时镜像画面
WORKING AI 干活时进度环填满亮绿、桌宠动起来 —— 背景 Mac 上就是菜单栏 app 弹出的实时镜像,与设备画面逐帧同步(5h 42% · Weekly 5%)。
来源 · 你的电脑

本地会话日志 + 官方用量接口

~/.claude / ~/.codex 会话记录判断忙闲,复用两个 CLI 已有的 OAuth 凭据取真实额度。

│ localhost:8765
桥接 · Swift 菜单栏 app

合并数据,开局域网 HTTP 服务

菜单栏一颗小图标,左键弹出实时镜像、右键遥控设备(切换显示 / 换桌宠 / USB 刷写)。

│ Wi-Fi 每 15s 轮询
显示 · ESP8266 小屏幕

把时间 + 状态画到彩屏

桌宠动画的上传、解码、缩放全部在板子上完成,换形象不再需要电脑参与。

  • 不需要任何账单 API key数据来自本机日志和两个 CLI 已存在的登录凭据,token 只发给各自官方 API。
  • 真实额度,不是估算5h / 周窗口的已用百分比 + 重置倒计时,app 每 2 分钟拉一次官方用量接口。
  • 毫秒级状态切换接收两个 CLI 官方 hooks 的事件推送,从"最多迟滞 20 秒"变成秒级响应。
  • 掉线自愈设备 DHCP 换了 IP 也能重新发现;桥接连不上时屏幕红色闪烁报警。

🔒 隐私优先:所有数据都在你的局域网内流转,HTTP 服务只下发状态和 token 计数,不含任何 API key。

网页刷机

在浏览器里一键烧录,不装任何工具。

用数据线把板子插到电脑,点一下按钮就把固件刷进去 —— 基于 Web Serial,全程在浏览器完成。

四步搞定

无需命令行、无需 PlatformIO。适用于桌面版 Chrome / Edge。

  1. 用 USB 数据线把「WiFi 天气时钟 MG01」板子连到电脑
  2. 点右侧「连接设备并烧录」,在弹窗里选中串口(CH340)
  3. 等待烧录完成,设备自动重启开机
  4. 首次开机用手机连热点 AI-Clock-Setup,在中文配网页里选 Wi-Fi 输密码即可 —— 无需填 Bridge 地址,桥接 app 会自动发现设备并配对
当前浏览器不支持 Web Serial,请用桌面版 ChromeEdge 打开本页。
需要通过 https://http://localhost 访问本页才能刷机。

配网后启动电脑上的桥接 app(下载 Windows / Mac 版),设备就会自动亮起来。

AI Mac 小屏幕 固件 v0.4.2
ESP8266 · 直接从这个页面刷入,约 30 秒完成
2026-07-09 更新:桥接自动发现配对自愈 · 配网时屏幕显示固件版本号 · 配网页面全中文

桥接 app 下载

下载桥接 app,Windows 和 Mac 都支持。

小屏幕的数据来自电脑上的桥接 app。下载对应系统的版本,打开即用。

macOS

DMG 安装包,打开后把 app 拖进 Applications 即完成安装。

AIClockBridge-v0.4.3-macOS.dmg · 759 KB
下载 macOS 版 ↓

Windows

自包含单文件 exe,双击直接运行,无需安装 .NET 运行时。

AIClockBridge-v0.4.2-Windows-x64.exe · 78 MB
下载 Windows 版 ↓

完全开源

硬件、固件、Mac app 全部公开。

拿去改、拿去做、拿去卖都行。喜欢的话给个 Star ⭐

⚙️

硬件开源方案

立创开源广场「SD2 / 小电视」原理图与 PCB。想自己打板、改外壳、批量做都从这里开始。

oshwhub.com/q21182889/sd2
查看硬件工程 →

不想动手?也可以直接买成品:ESP8266 芯片的 WiFi 天气时钟都可以,拼多多可自行选购。

直接购买成品 →
💻

软件开源仓库

ESP8266 固件(PlatformIO + Arduino,含板上 GIF 解码)与 Windows / Mac 桥接 app 的完整源码与文档。

github.com/pengchujin/esp8266-ai
在 GitHub 打开 →