遇到问题

先按下面顺序检查，通常可以快速解决。

找不到设备

1. 确认已在程序页面点击“启动服务”。
2. 换一根确认支持数据传输的 Type-C 线，再换一个 USB 接口。
3. 关闭串口监视器、烧录工具等可能占用设备的软件，然后重新插拔设备。

程序打不开或状态反复跳变

先完整解压安装包，不要直接在 ZIP 预览窗口运行。若仍反复跳变，运行安装包中的 emergency_stop.cmd，再重新打开 AgentCore-Light.exe。

AI 不会带动灯效

完全退出并重新打开 AI 工具，然后新建对话再测试。Codex App 桌面版还需在“设置 → 钩子”中点“信任”。

什么时候可以粘双面胶？

只有在设备已连接、手动灯效正常、AI 新对话也能带动灯效后，才可以粘贴。其他时候请先不要粘贴。

需要重刷固件时才查看 固件升级；设备能正常连接时不要随意刷固件。