AgentCore-Light v3 使用说明

AgentCore-Light v3 是 ESP32-C3 AI 状态灯：8 颗 WS2812 环形灯珠显示 AI 工作状态，OLED 屏幕同时显示状态名和 Token 剩余百分比。新版客户交付包以一体化程序 AgentCore-Light-v3.exe 为核心，基本用法与 AgentCore-Light v1 一致：双击运行打开本地控制台，启动服务连接设备，再为 AI 工具一键安装 Hook。

主要能力

• 一体化程序 AgentCore-Light-v3.exe，无需安装 Python、Arduino 等运行环境
• 本地网页控制台：测试灯效、调节亮度、AI 接入
• 环形 WS2812 灯效 + SSD1306 OLED 屏幕双重显示
• 支持 IDLE、THINKING、WRITING、RUNNING、DONE、ERROR、NEED_CONFIRM、OFF 状态
• 支持 TOKEN:x Token 剩余量显示（OLED 百分比 + 环形灯呼吸 + 低于 10% 红蓝警示）
• 交付包内置预编译固件和一键烧录脚本，支持在线更新

快速入口

• 快速开始
• 使用手册
• 固件 / 烧录
• 高级教程
• 常见问题
• 使用限制与排查

推荐首次流程

1. 下载并完整解压客户交付包，双击 AgentCore-Light-v3.exe 打开本地控制台。
2. 用支持数据传输的 USB 线连接状态灯，在控制台启动服务，等待设备显示“已连接”。
3. 用灯控按钮测试各状态灯效，调节亮度。
4. 在“AI 接入”中安装你正在使用的 AI 工具 Hook，重启 AI 工具并新建对话测试。
5. 需要烧录或升级设备固件时，查看 固件 / 烧录。

资料下载

下载 v3 客户交付包