使用手册
AgentCore-Light-v3.exe 的用法与 v1 的 AgentCore-Light.exe 基本一致：双击运行后浏览器自动打开本地控制台，在控制台启动服务、连接设备、测试灯效、安装 AI Hook。本页重点说明 v3 设备的灯效和功能差异。
控制台基本操作
- 双击
AgentCore-Light-v3.exe打开本地控制台。 - 点击“启动服务”，程序自动扫描并连接 ESP32-C3 状态灯。
- 设备区域显示“已连接”后，用灯控按钮测试各状态。
- 拖动亮度滑块调节整体亮度。
- 在“AI 接入”中为你使用的 AI 工具安装 Hook，重启 AI 工具并新建对话测试。
状态与灯效
| 状态 | 环形灯效果 | OLED 显示 |
|---|---|---|
IDLE | 蓝色呼吸灯，亮灯数量随 Token 剩余量变化 | IDLE |
THINKING | 紫色旋转灯效 | THINK |
WRITING | 青蓝色多点移动灯效 | WRITE |
RUNNING | 橙色快速旋转灯效 | RUN |
DONE | 绿色扩散灯效，约 10 秒后回到 IDLE | DONE |
ERROR | 红色随机闪烁 | ERROR |
NEED_CONFIRM | 白色双闪提示 | CONFIRM |
OFF | 全部熄灭 | - |
v3 同时接受 v1 风格的状态别名：AI 等同 WRITING，BUSY 等同 RUNNING，SUCCESS 等同 DONE，WAIT_CONFIRM、CONFIRM、WAITING、WAIT 等同 NEED_CONFIRM。
Token 显示
状态灯支持 TOKEN:x（0-100）显示 Token 剩余百分比：
- OLED 屏幕显示
Token xx%和进度条。 IDLE状态下环形灯按 Token 剩余量点亮对应数量的灯珠。- Token 低于 10% 时，环形灯切换为红蓝交替警示闪烁。
AI 工具联动时，Token 用量由 AgentCore-Light 程序读取并自动发送给状态灯。
OLED 屏幕
OLED 屏幕同时显示：
Codex标题- 当前状态短名，例如
THINK、WRITE、RUN Token xx%和进度条
如果 OLED 初始化失败，环形灯灯效仍会继续运行，不影响状态显示。
蜂鸣器说明
v3 设备没有蜂鸣器。控制台或接口中的蜂鸣器、音效类命令会被设备忽略，这是正常现象。
亮度说明
控制台亮度范围为 0-100。v3 灯珠物理亮度较高，固件会把实际驱动亮度限制在 50% 以内，默认亮度也偏低，属于正常设计。
停止服务
关闭浏览器页面不会停止后台服务。如需停止，请重新打开控制台点击“停止服务”；不再需要登录后自动运行时，请在“设置”中关闭自启动。