最近一直在折腾一个挺有意思的小项目AgentCore-Light。
我发现现在大家都在用各种 AI Agent、Codex、Claude Code、OpenCode 写代码,但 AI 的工作过程其实一直都是“隐藏”的:
AI 在思考?
AI 在运行命令?
AI 卡住了?
Token 快没了?
需要人工确认?
很多时候只能盯着终端窗口。
于是我就在想:
能不能把 AI 的工作状态,做成一个真正“看得见”的桌面设备?
于是就有了这个项目:
Agent Core Light
一个基于:
ESP32-S3
WS2812 RGB灯环
SSD1306 OLED
3D打印外壳
实现的 AI Agent 状态核心灯。
1. 项目简介
AgentCore-Light 是一个:展示AI 的工作状态,做成一个真正“看得见”的桌面设备
AI Agent 实体状态核心
核心思路:
使用 ESP32-S3 作为主控
使用 WS2812 RGB 灯环实现动态状态灯效
使用 OLED 实时显示 Agent 状态
使用 3D 打印外壳实现桌面设备化
通过串口 / WiFi / 蓝牙脚本接收电脑端状态信息
用于直观显示:
AI 思考中
正在生成代码
正在运行命令
任务完成
错误异常
等待用户确认
Token 剩余额度
本项目当前主打:AI 工作流可视化,让 AI 不再只是一个聊天窗口。
2. 效果预览
当前支持状态:
| 场景 | 模式 | 灯效 |
|---|---|---|
| 默认待机 | IDLE | 深蓝呼吸 |
| AI 思考中 | THINKING | 紫色神经脉冲 |
| AI 正在生成代码 | WRITING | 青蓝数据流 |
| AI 正在执行命令 | RUNNING | 橙红高速扫描 |
| 任务完成 | DONE | 青绿色扩散 |
| 任务失败 | ERROR | 红色故障闪烁 |
| 等待人工确认 | NEED_CONFIRM | 白色双闪 |
| Token 过低 | TOKEN_LOW | 红蓝低频警告 |
OLED 会同步显示:
当前状态
Token 百分比
Agent 信息
动态状态动画
3. 硬件清单
| 类别 | 物料 | 数量 | 说明 |
|---|---|---|---|
| 主控 | ESP32-C3 开发板 | 1 块 | 推荐 Type-C 版本 |
| 灯环 | WS2812 8位 RGB灯环 | 1 个 | 外径约32mm |
| 显示 | OLED 0.96 | 1 块 | I2C接口 |
| 外壳 | 3D打印外壳 | 1 套 | FDM打印 |
| 导线 | 飞线 / 杜邦线 | 若干 | 建议软硅胶线 |
| 供电 | Type-C 数据线 | 1 条 | 支持数据传输 |
| 固定 | 3M双面胶 | 1 个 | 固定显示器 |
| 工具 | 电烙铁、焊锡丝、镊子 | 若干 | 基础焊接工具 |
4. 硬件结构
本项目采用:环形灯 + 中心OLED结构。
整体灵感类似:
AI 核心
科幻反应堆
桌面 AI 状态终端
当前结构:
WS2812 RGB灯环 ↓ OLED显示屏 ↓ ESP32-S3 ↓ 3D打印外壳显示器安装方式:
L型支架 + 3M双面胶固定于显示器顶部或左上角。
5. 接线说明
WS2812
| WS2812 | ESP32-S3 |
|---|---|
| VCC | 3.3V |
| GND | GND |
| DI | GPIO4 |
OLED
| OLED | ESP32-S3 |
|---|---|
| VCC | 3.3V |
| GND | GND |
| SDA | GPIO8 |
| SCL | GPIO9 |
6. 固件说明
当前工程基于:
Arduino Framework主要使用:
Adafruit NeoPixel
Adafruit SSD1306
Adafruit GFX
固件特性:
多状态动态灯效
OLED UI
Token 百分比显示
串口实时控制
非阻塞动画
millis() 动画系统
7. 串口/蓝牙控制
当前通过:
115200 串口接收状态命令。