常见问题

下载后无法运行程序怎么办？

请先完整解压 ZIP 文件，然后在解压后的文件夹中双击 AgentCore-Light.exe。不要直接在压缩包预览窗口中运行。

点击“启动服务”后找不到设备怎么办？

• 确认 Type-C 线支持数据传输。
• 更换 USB 接口或数据线。
• 关闭会占用串口的其他程序。
• 重新插拔设备并重启 AgentCore-Light 程序。

为什么串口状态反复跳变？

可能同时运行了多个 AgentCore-Light 进程。双击安装包中的 emergency_stop.cmd，停止所有相关进程后，再重新打开 AgentCore-Light.exe。

Hook 安装后为什么没有生效？

Hook 配置需要在新对话中加载。请完全退出并重新打开 Agent 软件，再新建一个对话测试。

Copilot 可以使用项目级 Hook 吗？

不可以。Copilot 仅支持全局安装。对它使用 --project 时，程序会自动降级为全局安装并显示提示。

Codex App 安装 Hook 后还需要做什么？

打开 设置 → 钩子，手动点击一次“信任”。Codex App 桌面版无法使用 /hooks 命令完成信任。

什么时候可以粘双面胶？

请在 USB 自动连接、手动灯效测试和 Agent Hook 联动测试都正常后再粘贴。如果仍有问题，请保持设备未粘贴状态并联系售后。