使用限制

PromLight 正常工作的前提条件。请在使用前确认以下各项均已满足。

硬件要求

电脑必须具备蓝牙功能

• 电脑需配备蓝牙适配器，蓝牙版本 4.2 及以上。
• 如果电脑没有自带蓝牙，可购买 USB 蓝牙适配器插入后使用。

操作系统

• 仅支持 Windows 与 macOS。
• 暂不支持 Linux、手机或平板等移动端设备。

软件要求

仅支持具备 Hook 功能的 Agent

PromLight 通过监听 AI 的 Hook 事件来获取当前工作状态。目前已支持的 AI:

• Claude Code
• OpenAI Codex
• Cursor
• GitHub Copilot
• Qoder

不支持 Hook 机制的 AI 无法使用 PromLight。 各 AI 提供的事件不同，能点亮的状态略有差异（例如 Codex / Cursor 无「出错」红灯、Copilot 无「等待确认」黄闪、Qoder 仅有处理中 / 出错 / 完成空闲）。完整对照见高级教程「各 Agent 的状态覆盖」。

需要 Python 3 运行时

接入 AI 后，hook 通过命令 python agent_hook.py … 向 PromLight 程序上报状态，因此电脑上需安装 Python 3，且 python 命令在 PATH 中可直接调用。

• Windows：安装 Python 3 时勾选 “Add Python to PATH”。注意系统自带的 Microsoft Store python.exe 占位别名并非真正的 Python，命中它会导致 hook 失效——可在「设置 → 应用 → 应用执行别名」中关闭，或确认 python --version 返回真实版本号。
• macOS：系统通常只有 python3 而无 python，请确认 python 可调用（必要时建立链接或安装提供 python 的发行版）。

hook 客户端设计为任何失败都静默退出、不报错。因此一旦 python 不可用，指示灯会毫无反应且没有任何提示——若灯不亮，请优先核实这一项。

PromLight PC程序必须保持运行

PromLight PC程序通过监听 Hook 事件获取 AI 工作状态。程序双击运行后会在后台常驻并设置开机自启动，正常情况下开机即自动运行、无需手动维护；但若手动退出该程序，指示灯将停止响应。

物理与维护限制

蓝牙有效距离

蓝牙有效距离约 20 米（空旷无遮挡环境）。墙壁、家具等障碍物会缩短实际可用距离。

Type-C 口仅用于充电

PromLight 设备的 Type-C 接口仅用于充电，不具备数据通信功能。设备与电脑之间通过蓝牙无线通信，不依赖任何数据线。