Light v2 Docs

AgentCore-Light v2 使用说明

无线蓝牙 AI 状态灯,支持 Windows / macOS 后台程序、AI Hook 状态同步、多设备路由和本地 Web 控制台。

AgentCore-Light v2 产品图

AgentCore-Light v2 使用说明

AgentCore-Light v2 是一款可充电的无线蓝牙 AI 状态灯。电脑端 PromLight 程序在后台运行,通过 AI Hook 接收 Claude Code、Codex、Cursor、GitHub Copilot、Qoder 等工具的状态事件,再把状态同步到实体灯。

主要能力

  • 蓝牙无线连接,Type-C 仅用于充电
  • Windows / macOS PC 端后台程序,支持开机自启动
  • 本地 Web 控制台,默认访问 http://127.0.0.1:7800
  • Hook 通信默认端口 47800
  • 支持 正在处理等待确认完成空闲出错对话结束 等状态
  • 支持自定义灯效、多设备命名、多设备路由、按项目或按 AI 分灯
  • 本地状态通信,不上传对话或代码内容

快速入口

推荐首次流程

  1. 长按设备按键约 3 秒开机,确认绿灯闪烁进入蓝牙广播。
  2. 在 Windows 或 macOS 蓝牙设置里配对 PromLight
  3. 启动 PromLight PC 端程序,打开 http://127.0.0.1:7800 测试灯控。
  4. 在 Web 控制台执行 setup all 写入 AI Hook 配置。
  5. 新开 AI 对话;Codex 还需要在设置里的 Hooks 列表逐条点击信任。

默认灯效

指示灯含义
红黄绿三颗灯闪烁一下,然后绿灯常亮新对话开始
黄灯常亮正在处理、思考、修改文件或执行命令
黄灯闪烁正在等待用户确认或回复
红灯闪烁本轮出现错误
绿灯常亮处理完成,当前空闲
绿灯长周期呼吸对话结束