常见问题

看不到串口怎么办？

检查：

• USB 线是不是数据线（充电线是最常见的原因）。
• 设备是否插紧，换一个电脑 USB 接口试试。
• 设备管理器里有没有出现新的 COM 口。

COM 口变了正常吗？

正常。更换 USB 口或重新插拔后，COM 口编号可能变化。AgentCore-Light 会自动扫描设备，flash-windows.bat 烧录时也会自动检测串口，一般不需要手动处理。

串口被占用怎么办？

关闭可能占用串口的软件后重试：

• AgentCore-Light 控制台和后台服务（在控制台点击“停止服务”）。
• Arduino IDE 串口监视器。
• 其他串口调试工具。

烧录固件失败怎么办？

• 确认 USB 线支持数据传输。
• 确认设备插紧，更换 USB 接口。
• 关闭所有占用串口的软件。
• 在设备管理器确认 COM 口后手动选择。

详细流程见固件 / 烧录。

状态灯不跟随 AI 工具变化怎么办？

• 确认控制台设备区域显示“已连接”。
• 确认已在“AI 接入”中为你使用的 AI 工具安装 Hook。
• 重启该 AI 工具并新建对话测试。
• 确认 AgentCore-Light 后台服务正在运行。

OLED 屏幕不亮但环形灯正常？

OLED 初始化失败时环形灯灯效不受影响，状态显示仍然正常。可尝试重新烧录固件；仍不恢复请联系技术支持。

蜂鸣器 / 音效设置没有效果？

v3 硬件没有蜂鸣器，蜂鸣器和音效相关的设置与命令会被设备忽略，这是正常现象，不是故障。

Token 百分比不变化怎么办？

Token 数据由 AgentCore-Light 程序发送给状态灯。请确认设备已连接、后台服务正在运行、对应 AI 工具的 Hook 已安装并已重启 AI 工具。如果长时间不变化，请记录你的使用场景反馈技术支持。