使用限制与排查
使用注意事项
- 必须使用支持数据传输的 USB 线。
- 烧录和测试时不要同时打开多个占用串口的程序。
一键启动全套程序.cmd不会烧录固件，只负责启动软件服务。- 第一次启动时，如果
.venv缺失或损坏，启动器会自动重建并安装依赖。 - COM 口编号变化是正常现象。
服务不要混淆
| 服务 | 作用 |
|---|---|
| 网页展示服务 | 打开本地 UI，端口 2026 |
| Codex WebSocket bridge | 给网页推送 Codex 状态，端口 8765 |
| 串口 daemon | 控制真实 ESP32-C3 灯板，端口 37637 |
日志检查
检查 hook：
Get-Content .\codex_light_hook.log -Tail 30检查串口桥：
Get-Content .\codex_light.log -Tail 30无开发板时测试 Token 换算
.\.venv\Scripts\python -c "import codex_light_serial as c; print(c.command_from_rollout_event({'type':'event_msg','payload':{'type':'token_count','rate_limits':{'primary':{'used_percent':27.2,'window_minutes':300}}}}))"正常输出：
TOKEN:73资料不足项
以下内容在 sketch_may27a_customer 中没有明确完整资料，暂不编造：
- 成品外壳尺寸：【待补充】
- 电池容量 / 续航：【待补充】
- 蓝牙硬件参数：【待补充】
- macOS 完整使用流程：【待补充】