AgentCore-Light serial-only v0.3.0-test 客户测试说明

这是 USB 串口专用测试版。
不需要安装 Python。
不需要安装 Node.js。
不支持 BLE。
不依赖旧 Web 面板。

使用步骤：

1. 双击 AgentCore-Light.exe
   程序会打开本地控制台页面：
   http://127.0.0.1:18793

2. 插上 AgentCore-Light 状态灯
   Type-C 用于供电、串口通信和调试。
   控制台会自动扫描并连接 USB 串口设备。

3. 测试灯效
   在控制台里点击 IDLE / THINKING / BUSY / SUCCESS / ERROR / WAIT_CONFIRM / OFF。
   也可以拖动亮度滑块，亮度会自动发送，不需要点击应用按钮。

4. 安装 AI Hook
   点击顶部“AI 接入”。
   当前测试版支持：
   - Claude Code
   - Codex
   点击“安装”或“重新安装”即可写入 Hook 配置。

5. 开机自启动
   点击顶部“设置”。
   在设置里开启或关闭“开机自启动”。

6. 不再使用时
   在设置里关闭开机自启动。
   如需完全停止后台服务，可在任务管理器中结束 AgentCore-Light.exe，或联系开发者获取清理脚本。

运行时文件位置：

配置文件：
%APPDATA%\AgentCoreLight\config.json

日志目录：
%LOCALAPPDATA%\AgentCoreLight\logs

固定安装目录：
%LOCALAPPDATA%\Programs\AgentCoreLightSerial

注意：

Hook 安装后会指向固定安装目录：
%LOCALAPPDATA%\Programs\AgentCoreLightSerial\AgentCore-Light.exe

请不要把 Claude / Codex 的第三方图标理解为官方背书。
这些图标只用于标识对应 AI 工具的接入入口。

故障处理：如果出现重复进程或串口状态跳变，请先双击 emergency_stop.cmd 停止所有 AgentCore-Light 进程，然后重新打开 AgentCore-Light.exe。

固件说明：本测试包内 firmware\firmware-cdc-on-boot-merged.bin 是已用 CDCOnBoot=cdc 编译的 ESP32-C3 serial-only 固件；如果设备出现 Write timeout，请先确认已烧录此版本固件。

