常见问题

看不到串口怎么办？

检查：

• USB 线是不是数据线
• 是否换过 USB 口
• 设备管理器里有没有新 COM 口
• 是否可以通过 arduino-cli board list 看到设备

COM 口变了正常吗？

正常。今天可能是 COM40，下次可能变成 COM38。重新执行：

arduino-cli board list

查看当前端口即可。

串口被占用怎么办？

如果出现 PermissionError、port is busy、could not open port，请关闭：

• Arduino IDE 串口监视器
• agent_light_control.py
• python_test_tools 中的测试脚本
• 旧的 daemon 进程

网页打不开怎么办？

确认：

• local_demo\start_server_2026.ps1 的 PowerShell 窗口仍在运行
• 浏览器地址是 http://localhost:2026
• 没有其他程序占用 2026 端口

网页 Codex 模式显示未连接怎么办？

请确认已启动：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local_demo\start_codex_ws_bridge.ps1

如果提示缺少 websockets：

.\.venv\Scripts\python -m pip install websockets

Codex 中没反应怎么办？

优先检查：

• start_codex_light_daemon.ps1 是否启动
• Codex 是否打开的是整个项目目录
• .codex 文件夹是否还在
• codex_light_hook.log 是否有新内容
• codex_light.log 是否有 rollout watch 或 TOKEN:x rollout

Token 百分比不变化怎么办？

状态灯有反应但 Token 不变化时，先检查本机 Codex 日志里有没有 token_count 和 used_percent。

只复制 .ino 文件可以吗？

不推荐。除了 .ino，还需要 Python 测试脚本、Codex hook 脚本、.codex\hooks.json 和 PowerShell 脚本。正确做法是复制整个客户交付文件夹。