快速开始

准备一根支持数据传输的 USB 线。新版交付包以一体化程序为核心，不需要安装 Python、Arduino 或其他运行环境。

AI 一键安装（推荐客户）

对 Claude Code / Codex 等支持联网读取说明的 AI 说：

根据 https://light.buildfpga.com/agentcore-light-v3.txt 帮我装好 AgentCore-Light v3

AI 会读取安装说明、下载 v3 客户交付包，并带你完成程序安装、设备连接、灯效测试和 AI Hook 配置。遇到烧录固件这类需要确认的步骤时，它会停下让你确认。

手动安装

准备资料

下载并完整解压 v3 客户交付包：

下载 v3 客户交付包

解压后的 release/ 目录包含：

• AgentCore-Light-v3.exe：主程序（本地控制台 + 后台服务 + 命令行入口）
• latest.json：在线更新说明
• firmware/esp32_c3_v3_neopixel_oled/：固件与烧录工具
• firmware.bin：预编译固件
• esptool.exe：烧录工具
• flash-windows.bat：一键烧录脚本
• agentcore_light_v3_neopixel_oled.ino：固件源码（高级用户参考）

运行与连接

1. 双击 AgentCore-Light-v3.exe，浏览器会自动打开本地控制台。
2. 用支持数据传输的 USB 线连接状态灯。
3. 在控制台点击“启动服务”，等待设备区域显示“已连接”。
4. 用灯控按钮测试各状态灯效，拖动亮度滑块调节亮度；OLED 屏幕会同步显示状态名和 Token 百分比。

接入 AI 工具

1. 点击控制台右上角的“AI 接入”。
2. 找到你正在使用的 AI 工具，点击“安装”。
3. 重启该 AI 工具并新建对话测试，确认状态灯跟随 AI 工作状态变化。

完整灯效说明见使用手册；第一次烧录或升级固件见固件 / 烧录。