使用手册
AgentCore-Light v2 由实体灯、PromLight PC 端程序和 AI Hook 配置三部分组成。
日常使用
- 长按设备按键开机。
- 电脑自动连接已配对的
PromLight。 - PromLight PC 端程序后台常驻并接收 AI 状态。
- 正常使用 AI，指示灯自动变化。
PromLight 程序设置为开机自启动，通常不需要每次手动打开。
Web 控制台
默认控制台地址：
http://127.0.0.1:7800常用命令：
help查看命令说明led all blink测试所有灯是否可控setup all给已安装的 AI 写入 Hook 配置setup codex只配置 Codexsetup claude只配置 Claude Code
默认灯效
| 指示灯 | 含义 |
|---|---|
| 红黄绿三颗灯闪烁一下，然后绿灯常亮 | 新对话开始 |
| 黄灯常亮 | 正在处理、思考、修改文件或执行命令 |
| 黄灯闪烁 | 正在等待用户确认或回复 |
| 红灯闪烁 | 本轮出现错误 |
| 绿灯常亮 | 处理完成，当前空闲 |
| 绿灯长周期呼吸 | 对话结束 |
AI 状态差异
不同 AI 的 Hook 事件能力不同，所以不是每种灯效都会在每个 AI 中出现。
- Claude Code：状态覆盖最完整
- Codex：需要在项目内对话，并在 Settings -> Hooks 中点击信任
- Cursor：部分状态与 Codex 类似
- GitHub Copilot：通常没有等待确认黄闪
- Qoder：主要覆盖处理中、出错、完成空闲
这是 AI 工具事件能力差异，不代表设备故障。
连接与隐私
实体灯通过蓝牙与电脑连接。Hook 只把开始、处理中、等待、完成、出错等状态事件发给本机 PromLight 程序，不读取对话或文件内容，也不经过云端。