常见问题
兼容与前提
支持哪些系统？
支持 Windows 与 macOS，不支持 Linux、手机或平板。
支持哪些 AI？
目前适配 Claude Code、OpenAI Codex、Cursor、GitHub Copilot 与 Qoder。不同 AI 能触发的状态不同。
为什么需要 Python？
AI Hook 会通过 python 调用 agent_hook.py。如果 Python 3 未安装，或 Windows 命中了 Microsoft Store 的占位别名，Hook 可能静默失败，灯不会有任何反应。
可以用下面命令确认：
python --version配对与连接
怎么开机？
长按机身按键约 3 秒。红、黄、绿依次点亮，绿灯开始闪烁后即可配对。
连不上怎么办？
先关闭电脑蓝牙约 10 秒，再重新打开连接。仍失败时，删除系统里的历史配对信息后重新配对。必要时重启电脑。
一盏灯能同时连接多台电脑吗？
不能。同一时间只建议连接一台电脑。一台电脑可以驱动多盏灯。
灯不亮或没反应
按顺序排查：
- 系统蓝牙里是否显示已连接。
- PromLight 程序是否正在后台运行。
http://127.0.0.1:7800是否能打开。- Web 控制台执行
led all blink是否能控制灯。 - AI 配置是否生效，Codex 是否已在 Settings -> Hooks 中点击信任。
python --version是否能返回真实版本号。- 安装路径是否简短固定，并避免中文、空格和同步盘路径。
Codex 配好了 Hook，为什么灯不亮？
Codex 桌面程序里的 Hook 通常只在项目内对话触发。需要先创建或打开一个本地项目，并在该项目里对话。
信任方式是在 Codex 的 Settings -> Hooks 中逐条点击信任。桌面版无法依赖 /hooks 命令完成信任。
端口被占用怎么办？
PromLight 默认使用：
- Web 控制台端口
7800 - Hook 通信端口
47800
修改 config.json 中的 web_port 或 port 后重启 PromLight。
续航和充电
内置 400mAh 锂电池，按每天 8 小时使用约 4 到 5 天。Type-C 接口仅用于充电，不传输数据。
会上传对话或代码吗？
不会。Hook 只发送状态事件到本机 127.0.0.1 的 PromLight 程序，不读取对话内容或代码文件，也不经过云端。