概述特点
AgentCore-Light 是放在电脑旁的 AI 运行指示灯。AI-Light 客户端接收本机 AI 编程工具的任务事件，再通过 BLE 蓝牙驱动灯光与提示音。你可以通过不同灯效了解任务正在工作、等待回应还是已经完成；支持相应失败事件的工具还可触发错误提示。灯光含义由主题定义，三个灯共同表达当前状态。
任务状态，留在视线里
用灯光表达工作、等待回应和任务完成，减少反复切回任务窗口查看状态的操作。
等你确认，亮灯提醒
支持相应本机 Hook 的工具在等待输入或授权时，将状态同步到桌面灯牌。
六套主题，按习惯选择
内置经典、极简、专注、自然、极光与霓虹主题，可调整颜色、亮度、动效与提示音。
先试听，再接入任务
用客户端「试听」验证实体灯效，再运行一次真实任务，确认工具、软件与灯牌已经连通。
看懂灯光，也能定义灯光
灯光颜色和动效由 AI-Light 主题决定。以 Default 经典主题为例：
| 状态 | 灯光与声音 |
|---|---|
| 空闲 | 熄灭 |
| 工作中 | 三灯依次蓝色呼吸 |
| 等你回复 | 琥珀色慢呼吸 |
| 已完成 | 绿色常亮 |
| 出错了 | 红色闪烁并提示一声 |
具体可同步状态取决于所用工具及其本机 Hook 能力。Default 的完成与错误状态会保留到下一次状态事件；三个灯共同表达当前状态。
六套主题，选择适合你的节奏
| 主题 | 灯效风格 |
|---|---|
| Default 经典 | 均衡，便于识别 |
| Minimal 极简 | 白灰灯效，减少视觉干扰 |
| Focus 专注 | 低亮度、单灯表达 |
| Nature 自然 | 柔和，变化缓慢 |
| Aurora 极光 | 三灯异色流动 |
| Neon 霓虹 | 高饱和，节奏醒目 |
在「主题」中点击「使用此主题」即可切换，也可以以现有主题创建个人灯效。颜色、亮度、动效、灯光顺序与声音都可调整。用户主题支持导入与导出 .ailight-theme.json 文件，方便备份和分享。
典型应用
- AI 辅助编程时查看任务进度。
- 等待工具请求输入或授权时获得桌面提醒。
- 在安静工作环境中选择柔和或无声灯效。
- 为个人桌面配置不同的状态灯主题。
规格参数
| 产品型号 | AgentCore-Light |
|---|---|
| 产品类型 | AI 运行指示灯 |
| 连接方式 | BLE 蓝牙，连接 AI-Light 桌面客户端 |
| 灯光输出 | 3 颗可寻址 RGB 灯 |
| 声音输出 | 提示音，可按主题设置 |
| 标准状态 | 空闲、工作中、等你回复、已完成、出错了；具体可同步状态取决于接入工具 |
| 内置主题 | Default 经典、Minimal 极简、Focus 专注、Nature 自然、Aurora 极光、Neon 霓虹 |
| 个性化设置 | 颜色、亮度、动效、灯光顺序和声音；支持用户主题导入与导出 |
| 配套客户端 | AI-Light，提供 Windows、macOS 和 Linux 安装包 |
| 工具接入环境 | Node.js 20 或更高版本、npm、兼容的 AI-Light Adapter |
| 本机工具接入 | Claude Code、Codex、Qoder、TraeCode、WorkBuddy；按工具的 Hook 能力同步 |
| 外观配色 | 粉色、乳白色 |
上位机使用
安装并启动 AI-Light
下载与你的操作系统匹配的客户端安装包，按系统提示完成安装并允许蓝牙访问。
在「设备」中连接灯牌
给 AgentCore-Light 供电，开启电脑蓝牙。将灯牌放在电脑附近，在「设备」页点击「重新查找设备」，找到兼容设备后点击「连接」。
用「试听」验证灯光
依次选择工作、等待、完成等状态，确认实体灯牌有反应。「停止灯效」可以停止灯光与蜂鸣。
在「接入」中连接 AI 工具
确认运行环境就绪，选择正在使用的工具并点击「连接」。缺少或需要升级 Adapter 时，根据应用提示检查并确认安装。
完成工具侧 Hook 设置
Codex 需要在「设置 → Hooks」审核并信任新 Hook；TraeCode 需要开启全局 Hook。其他工具按卡片中的下一步操作。
跑一次真实任务
保持 AI-Light 运行，在接入工具中发起任务，检查应用状态与实体灯牌同步变化。完成后可前往「主题」选择或创建喜欢的效果。
资料下载
尚未检查最新版本，以下为已保存的发布资料 0.5.6。启用 JavaScript 后将自动检查最新正式版。
AI-Light v0.5.6。请选择与你的操作系统和芯片架构对应的软件包，下载按钮均已接入 GitHub 加速下载。
Windows x64
Windows x64 · EXE 安装包
适用于 Windows 64 位电脑，下载后按安装向导完成安装。
文件校验
0458039deb2a26992447cfe82c9236b635300c756f25e76f20ce6b9704c037adWindows x64 · MSI 安装包
适用于需要 MSI 安装方式的 Windows 64 位电脑。
文件校验
1cc2c40165e3526010052e54c2fedd3520edb4ea7bbbc35b0a18432363699944macOS · Apple Silicon
Apple Silicon · DMG 安装包
适用于 Apple Silicon 芯片的 Mac；首次安装优先选择 DMG。
文件校验
acca7185b352a6d30b9b4ff8706dfd1121f77bc46e84570d0e40a016036b534eApple Silicon · 应用压缩包
macOS ARM64 应用压缩包，供高级用户按需使用；常规首次安装请选择同架构的 DMG 安装包。
文件校验
e28e4ecf46c139147a89cd2b65b988bf2a5a9c0846bea3453c2098e7c365c42fmacOS · Intel
Intel Mac · DMG 安装包
适用于 Intel 芯片的 Mac；首次安装优先选择 DMG。
文件校验
49367fbe7f8eb4127a0f882acfec39a7786524c126d21997468bcc546c224d9bIntel Mac · 应用压缩包
macOS x64 应用压缩包，供高级用户按需使用；常规首次安装请选择同架构的 DMG 安装包。
文件校验
bbcff7ecd11594c2fe3f681126d7363b48122b20a0321cad1625611c495fc754Linux x64
Linux x64 · DEB 软件包
适用于使用 DEB 软件包的 Linux 64 位系统。
文件校验
7bf11f431d77d490570b5bbfe20ce6340e0b6df13195ec82ee2d03555f8b80edLinux x64 · RPM 软件包
适用于使用 RPM 软件包的 Linux 64 位系统。
文件校验
dbc38c3f716b353318434b3049357d589c9ff468d05f28b3005d8536864a8977Linux x64 · AppImage 应用包
适用于 Linux 64 位系统的 AppImage 应用包，使用前需按系统要求允许执行。
文件校验
564b7902f1d66430cfe5032127a4db077bdcbe2cbe5092359dad906ec4441466版本说明与帮助
AI-Light v0.5.6 · 版本说明
查看本页安装包对应的版本说明与发布资源。
v0.5.5 → v0.5.6 完整更新记录
查看两个版本之间的完整变更。
主题场景预览改进
查看固定状态标签替换为主题场景预览的变更记录。
AI-Light v0.5.6 发布记录
查看本次客户端版本发布的变更记录。
在线快速上手
查看设备连接、试听、AI 工具接入和第一次真实任务验证步骤。
订购与支持
咨询 AgentCore-Light
了解产品供应、配套资料或接入方式，请联系红旭无线技术支持，并注明产品型号与使用需求。
常见问题
为什么没有找到状态灯？
请检查灯牌供电、电脑蓝牙和 AI-Light 的蓝牙权限，靠近电脑后点击「重新查找设备」。
工具运行了，灯牌为什么没有变化？
先在「设备」确认已连接，再用「试听」验证灯效。试听正常后，检查「接入」的运行环境和配置状态，并完成 Codex 的 Hook 信任或 TraeCode 的全局 Hook 设置。
可以关闭 AI-Light 窗口吗？
可以关闭主窗口并保留系统托盘运行。状态同步需要客户端继续运行，退出应用后将无法继续接收工具状态。
三个灯可以分别显示三个 AI 工具吗？
当前由最后上报状态的工具接管整体灯效，三个灯共同呈现当前状态。
灯光颜色的含义固定吗？
灯光颜色、动效与提示音由主题定义。Default 经典主题以蓝色表示工作、琥珀色表示等待、绿色表示完成、红色表示错误；切换主题后效果会变化。
为什么任务完成后灯光一直亮着？
完成或错误状态是否自动回到空闲由主题决定。Default 经典主题会保留这两种状态，直到收到下一次状态事件。