使用手册
AgentCore-Light v3 有三种使用方式：网页演示、网页跟随 Codex、真实 ESP32-C3 状态灯跟随 Codex。
三个服务
| 脚本 | 作用 | 端口 |
|---|---|---|
local_demo\start_server_2026.ps1 | 启动网页展示 | 2026 |
local_demo\start_codex_ws_bridge.ps1 | 启动网页 Codex 数据源 | 8765 |
start_codex_light_daemon.ps1 | 启动真实开发板串口通信 | 37637 |
网页连接 Codex 状态
第一个 PowerShell 启动网页：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local_demo\start_server_2026.ps1第二个 PowerShell 启动 Codex WebSocket bridge：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local_demo\start_codex_ws_bridge.ps1打开：
http://localhost:2026右侧选择：
数据来源 → Codex连接成功时页面会显示“已连接”。
真实 ESP32-C3 状态灯跟随 Codex
连接开发板后启动串口后台进程：
.\start_codex_light_daemon.ps1后台进程会：
- 持续占用 ESP32-C3 串口
- 接收 Codex hook 发来的状态
- 读取本机 Codex 会话日志中的 Token 用量
- 转发状态和 Token 剩余量到灯板
状态命令
固件和测试工具支持：
IDLETHINKINGWRITINGRUNNINGDONEERRORNEED_CONFIRMTOKEN:x
Token 显示
串口 daemon 会读取：
C:\Users\你的用户名\.codex\sessions\**\rollout-*.jsonl从 token_count 事件中读取 rate_limits.primary.used_percent，并换算为：
剩余百分比 = 100 - used_percent最后发送给灯板：
TOKEN:68灯板只接收串口命令，不会直接读取 Codex 日志。