ESP8266 · 开源硬件 · 桌面伴侣
ESP8266 · Open-source hardware · Desk companion
一枚可以捧在手心的复古麦金塔小屏幕，实时显示 Claude Code 与 Codex CLI 的工作状态、真实额度、网速和正在播放的音乐 —— 不需要任何官方账单 API key，数据全部来自你本机。
A palm-sized retro Macintosh that shows what Claude Code and Codex CLI are up to in real time — work status, true usage quota, network speed and now playing — no billing API key required, all data comes from your own machine.
它能显示什么
What it shows
全屏单应用视图，谁在干活就显示谁。像素桌宠 + 一圈方形额度环，工作时动起来、空闲时静止。
Full-screen single-app view — whoever is working gets the screen. A pixel pet plus a square quota ring: animated while working, still when idle.
working / idle / offline 一目了然。方形进度环 = 5h 与周窗口的真实用量百分比，颜色像红绿灯一样从绿到黄到红。
working / idle / offline at a glance. The square progress ring shows real usage of the 5-hour and weekly windows, shifting green → yellow → red like a traffic light.
任务管理器风格的滚动面积图，56 秒窗口、逐行写屏完全无闪烁。上下行读数取 1 秒平均，数据来自 Mac 内核网卡计数。
A Task-Manager-style scrolling area chart: 56-second window, drawn line by line with zero flicker. Up/down readings are 1-second averages from the Mac kernel's interface counters.
专辑封面、歌名、歌手和播放进度条实时同步 Mac 上正在放的歌。封面 128×128 逐行绘制，每 2 秒刷新。
Album art, title, artist and progress bar stay in sync with whatever your Mac is playing. The 128×128 cover is drawn line by line and refreshes every 2 seconds.
内置 petdex.dev 画廊，搜索选一个动画一键上传。设备自己在板上解码缩放，重启也记得，不用重新烧录。
Built-in petdex.dev gallery — search, pick an animation, upload in one click. The board decodes and scales it on-device and remembers it across reboots. No reflashing.
Mac 菜单栏左键弹出与设备完全同步的画面，不看设备也能确认。
Left-click the menu-bar icon for a pixel-perfect live mirror of the device — no need to look over at it.
桥接掉线或数据过期时红色闪烁，提醒你马上看一眼。
The screen flashes red when the bridge goes offline or data turns stale, so you notice right away.
设备本来就在轮询本机，Mac 端记下来访 IP 即完成发现。
The device already polls your computer; the bridge records the visiting IP and discovery is done.
工作原理
How it works
电脑上的桥接 app（同时支持 Windows 和 Mac）读本地会话日志、开一个局域网 HTTP 服务；小屏幕联网后每 15 秒轮询它，把状态画到屏上。
The bridge app on your computer reads local session logs and serves a LAN HTTP endpoint; the display polls it every 15 seconds over Wi-Fi and paints the status on screen.
读 ~/.claude / ~/.codex 会话记录判断忙闲，复用两个 CLI 已有的 OAuth 凭据取真实额度。
Reads ~/.claude / ~/.codex session records to tell busy from idle, and reuses the CLIs' existing OAuth credentials to fetch true quota.
菜单栏一颗小图标，左键弹出实时镜像、右键遥控设备（切换显示 / 换桌宠 / USB 刷写）。
One tiny menu-bar icon — left-click for the live mirror, right-click to control the device (switch views / change pet / flash over USB).
桌宠动画的上传、解码、缩放全部在板子上完成，换形象不再需要电脑参与。
Pet upload, decoding and scaling all happen on the board — changing pets no longer needs the computer.
🔒 隐私优先：所有数据都在你的局域网内流转，HTTP 服务只下发状态和 token 计数，不含任何 API key。
🔒 Privacy first: everything stays inside your LAN. The HTTP service only serves status and token counts — never any API key.
网页刷机
Flash from the browser
用数据线把板子插到电脑，点一下按钮就把固件刷进去 —— 基于 Web Serial，全程在浏览器完成。
Plug the board into your computer with a data cable and click one button — powered by Web Serial, entirely in the browser.
无需命令行、无需 PlatformIO。适用于桌面版 Chrome / Edge。
No command line, no PlatformIO. Works in desktop Chrome / Edge.
AI-Clock-Setup，在中文配网页里选 Wi-Fi 输密码即可 —— 无需填 Bridge 地址，桥接 app 会自动发现设备并配对On first boot, join the AI-Clock-Setup hotspot from your phone and pick your Wi-Fi + password on the setup page — no bridge address needed, the bridge app discovers and pairs with the device automaticallyhttps:// 或 http://localhost 访问本页才能刷机。This page must be served over https:// or http://localhost for flashing to work.配网后启动电脑上的桥接 app（下载 Windows / Mac 版），设备就会自动亮起来。
After Wi-Fi setup, launch the bridge app on your computer (download for Windows / Mac) and the device lights up automatically.
很多 USB 线是纯充电线，只供电、不传数据——插上后板子灯会亮，但电脑完全识别不到。请换一根确定能传数据的线（比如手机连电脑传过文件的那根）再试。
Many USB cables are charge-only — power but no data. The board's LED lights up, yet the computer never sees it. Grab a cable you know carries data (e.g. one you've used to transfer files from a phone) and try again.
插上板子，打开设备管理器，展开「端口 (COM 和 LPT)」：
Plug the board in, open Device Manager and expand "Ports (COM & LPT)":
不需要装任何驱动——macOS 系统自带 CH340 驱动，装第三方驱动反而容易出问题（内核扩展默认被系统拦截，导致设备无法识别）。
Don't install any driver — macOS ships with a CH340 driver, and a third-party one tends to make things worse (the kernel extension gets blocked by default and the device disappears).
ls /dev/cu.*，插拔一次板子对比输出——正常会新增一个 cu.usbserial-xxx 或 cu.wchusbserial-xxx。ls /dev/cu.*, unplug/replug the board and compare — a new cu.usbserial-xxx or cu.wchusbserial-xxx should appear.桥接 app 下载
Bridge app download
小屏幕的数据来自电脑上的桥接 app。下载对应系统的版本，打开即用。
The display gets its data from the bridge app on your computer. Grab the build for your OS and run it.
DMG 安装包，打开后把 app 拖进 Applications 即完成安装。
DMG installer — open it and drag the app into Applications. Done.
自包含单文件 exe，双击直接运行，无需安装 .NET 运行时。
Self-contained single-file exe — double-click to run, no .NET runtime required.
历史版本与完整更新日志见 Older versions and full changelogs on GitHub Releases →
完全开源
Fully open source
拿去改、拿去做、拿去卖都行。喜欢的话给个 Star ⭐
Fork it, build it, even sell it. Leave a star if you like it ⭐
立创开源广场「SD2 / 小电视」原理图与 PCB。想自己打板、改外壳、批量做都从这里开始。
Schematic and PCB for the "SD2 / mini TV" on OSHWHub. Start here to fab your own boards, redesign the case, or build in volume.
不想动手？也可以直接买成品：ESP8266 芯片的 WiFi 天气时钟都可以，拼多多可自行选购。
Don't want to solder? Any ESP8266-based "WiFi weather clock" works — ready-made units are cheap and easy to find online.
直接购买成品 →Buy a ready-made unit →ESP8266 固件（PlatformIO + Arduino，含板上 GIF 解码）与 Windows / Mac 桥接 app 的完整源码与文档。
Full source and docs for the ESP8266 firmware (PlatformIO + Arduino, with on-board GIF decoding) and the Windows / Mac bridge apps.