Codex OLED：让工作状态走出电脑屏幕

一块 RP2040-Zero、一块 1.3 英寸 OLED 和一条 USB-C 线，组成独立的桌面状态显示器。它传递的是任务阶段，而不是提示词或对话正文。

仓库创建：2026-08-06 14:21（不等同于项目开工日期）

本篇参考的默认分支提交：2026-08-31 00:40 · 8b1b1048

时间采用 UTC+8。文章发布时间是本次整理时间，不按 GitHub 历史日期倒填。

先定义什么算完成

本机桥接程序读取 Codex session 事件类型，再把 THINK、TOOL、DONE 和 ERROR 等状态发送给开发板。中间进度说明不能被当成最终完成，否则显示器会在任务仍在工作时给出错误信号。

OLED 除了状态动画，还显示活动任务数与简短阶段信息。设备只接收安全的阶段描述，不接收提示词、回复文本、命令参数和工具输出。这个数据边界比动画本身更重要。

SH1106 的分辨率为 128×64。项目采用 Python 桥接、USB CDC 传输和 MicroPython 固件，将状态交给开发板本地显示，同时用三色 LED 补充提示。插拔之后重新枚举 USB 设备并重发当前状态，可以减少短暂断连后的显示错位。

Windows 预览窗口用于观察同一套紧凑界面，不必每次都通过拍摄实体屏幕排查状态映射。

仓库包含可编辑的嘉立创专业版工程、载板说明、BOM 和装配资料。使用前仍应按准备制造的版本重新检查 DRC、供电和针脚定义，不能把存在 PCB 文件当成已经完成制造验收。README 明确要求 OLED 使用 3.3 V，这类硬件约束需要与软件说明一起保留。

以下为采集时默认分支的近期提交，链接保留原始记录。