PromLight 开箱教程
本文旨在带领大家快速上手使用 PromLight.
AI一键安装（推荐）
对 Claude Code / Codex 等支持 Hook 的 AI 说：
根据 `light.ghostyu.com/ai.txt` 帮我装好 PromLight
配置完成后，AI 会自动启动 PromLight PC程序。该程序在后台运行、并已设置开机自启动，可在浏览器打开 PromLight控制台
http://127.0.0.1:7800查看更多。
此时，需要设备开机和蓝牙配对：
- 开机： 长按机身按键约 3 秒，红🔴 → 黄🟡 → 绿🟢 依次点亮，绿灯开始闪烁即进入蓝牙广播。
- 蓝牙配对： 在系统蓝牙设置里找到
PromLight并连接，连接成功后，绿灯🟢常亮。
想自己动手、过程完全透明可控？见《手动安装》（含 PC 端软件下载地址与分步操作）。
默认灯效
| 指示灯 | 含义 |
|---|---|
| 🔴🟡🟢 三颗灯闪烁一下 → 🟢 绿灯常亮 | 新对话开始 |
| 🟡 黄灯常亮 | 正在处理（思考、修改文件、执行命令） |
| 🟡 黄灯闪烁 | 正在等待您确认或回复 |
| 🔴 红灯闪烁 | 本轮出现错误 |
| 🟢 绿灯常亮 | 处理完成，当前空闲 |
| 🟢 绿灯长周期呼吸 | 对话结束 |
自定义灯效、多设备路由等高级功能见《高级教程》。
完成与排错
日常使用：开机后 PromLight 自动在后台运行并连上设备 → 正常使用 AI，指示灯将自动反映 AI 状态。
若指示灯无反应时，依次确认：
- PromLight 程序正在运行（后台常驻；可在浏览器打开Web控制台
http://127.0.0.1:7800确认） - 已配置Hook，可以在 Web 控制台中点击 【AI接入】 按钮查看。
- AI对话是基于本地项目。如 Codex 是基于Project的对话，并且需要打开 设置 → 钩子 里手动点击信任
python已安装并可用，可以在终端中输入python --version如果返回版本号，表示可用。
若仍然无法联动，请与我们联系。