使用限制

系统范围

AgentCore-Light v2 支持 Windows 与 macOS。当前不支持 Linux、手机或平板。

蓝牙要求

电脑需要支持蓝牙 4.2 及以上。无内置蓝牙的台式机可以使用 USB 蓝牙适配器。

蓝牙受墙壁、家具、电脑蓝牙模块质量影响。空旷无遮挡距离约 20 米，实际使用距离可能更短。

Python 要求

电脑需要安装 Python 3，并确保 python 命令可直接调用。

python --version

如果该命令不可用，AI Hook 无法启动状态上报脚本，灯会没有反应。

安装路径要求

PromLight 程序目录建议简短、固定。

• Windows 推荐 D:/PromLight/
• macOS 推荐 ~/Applications/PromLight/
• 避免桌面、下载目录、OneDrive/iCloud 同步目录
• 避免中文、空格和经常移动的路径

Hook 配置会写入绝对路径，移动程序后需要重新执行 setup all。

Codex 使用限制

Codex 需要在本地项目内对话才会触发 Hook。普通非项目对话可能不会产生状态事件。

首次配置后，需要到 Codex 桌面程序的 Settings -> Hooks 页面逐条点击信任。

AI 状态覆盖差异

不同 AI 暴露的 Hook 事件不同，所以状态灯覆盖不完全一致。例如某些 AI 没有等待确认事件，某些 AI 不报告出错事件。

这属于 AI 工具能力边界，不是 AgentCore-Light v2 故障。

本机端口

PromLight 默认使用：

• 7800：Web 控制台
• 47800：Hook 通信

端口冲突时，需要修改 config.json 并重启程序。

隐私边界

PromLight 只接收状态事件，不读取对话正文、文件内容或代码。状态事件发送到本机回环地址 127.0.0.1，不经过云端。