Light v3 Docs

高级教程

状态映射、灯效/OLED 行为、Codex hook、WebSocket bridge 与串口 daemon 的高级说明。

AgentCore-Light v3 产品图

高级教程

本页整理自源码注释、codex_light_serial.py、agent_light_control.py 和 ESP32-C3 固件代码。

ESP32-C3 硬件引脚

固件中定义：

功能	引脚 / 参数
WS2812 LED	`GPIO 4`
LED 数量	`8`
LED 亮度	`10`
OLED SDA	`GPIO 9`
OLED SCL	`GPIO 8`
OLED 分辨率	`128 × 64`
OLED 地址	`0x3C`

状态映射

状态	固件行为
`IDLE`	根据 Token 剩余量显示蓝色呼吸 / 低 Token 警示
`THINKING`	紫色旋转灯效
`WRITING`	青蓝色多点移动灯效
`RUNNING`	橙色快速旋转灯效
`DONE`	绿色扩散灯效，约 10 秒后回到 `IDLE`
`ERROR`	红色随机闪烁
`NEED_CONFIRM`	白色双闪确认提示

OLED 显示

OLED 会显示：

Codex
当前短状态名，例如 THINK、WRITE、RUN
Token xx%
Token 进度条

如果 OLED 初始化失败，串口会输出：

OLED init failed. WS2812 will continue running.

此时 WS2812 灯效会继续运行。

Codex 状态来源

codex_light_serial.py 会从 Codex rollout 日志和 SQLite 日志中提取状态：

用户消息 → THINKING
工具调用 → RUNNING
apply_patch → WRITING
任务完成 → DONE
需要确认 → NEED_CONFIRM
出现错误标记 → ERROR
token_count → TOKEN:x

可配置项

源码里明确存在的可配置项：

CODEX_LIGHT_PORT：手动指定串口
DEFAULT_BAUD_RATE = 115200
TCP_PORT = 37637
AUTO_IDLE_SECONDS = 45
DONE_IDLE_SECONDS = 3
DEDUP_WINDOW_SECONDS = 2.5

更多硬件规格、外壳尺寸、电池容量和蓝牙能力资料：【待补充】

快速开始查看说明使用手册查看说明固件 / 烧录查看说明高级教程当前页面常见问题查看说明使用限制查看说明