LIFX 灯光控制

通过 LIFX HTTP API，使用自然语言控制 LIFX 智能灯具。

参考资料

• lifx-api.sh — 封装全部 LIFX API 调用的 Bash 脚本
• scene-status.py — 场景匹配与当前激活状态检测
• setup.sh — 设备发现与技能配置

配置

设置您的 LIFX API Token（可在 https://cloud.lifx.com/settings 获取）：

bash setup.sh 

该命令将自动发现您所有的灯具、群组和场景，并生成一份个性化的 SKILL.md 文件，其中包含您设备的实际上下文信息。

设备上下文

运行 bash setup.sh 以在本节中填充您的灯具、房间和场景信息。
配置脚本会调用 LIFX API 并重写本文件，填入您个人的设备上下文。

位置：（未配置）

房间与灯具

（由 setup.sh 自动填充）

场景

（由 setup.sh 自动填充）

多区域设备

（由 setup.sh 自动填充）

如何控制灯光

发现灯具

bash lifx-api.sh discover

以房间为单位列出所有灯具，并显示其开关状态、颜色与亮度。

切换灯具开关

bash lifx-api.sh toggle 

选择器支持以下格式：

• 单个灯具：id:
• 群组/房间：group_id:
• 全部灯具：all

设置灯具状态（颜色、亮度、开关）

bash lifx-api.sh state  '{"power":"on","color":"blue","brightness":0.75,"duration":1.0}'

颜色支持以下格式：

• 命名色：red、blue、green、white、warm white、purple、orange
• 十六进制：#ff6b35
• 色温（Kelvin）：kelvin:2700（暖白）至 kelvin:6500（冷日光）
• HSB 格式：hue:240 saturation:1.0

设置颜色时务必包含 "power":"on" 和亮度值，否则亮度为 0 的灯具将不可见。

启用场景

bash lifx-api.sh scene 

切换房间开关

bash lifx-api.sh group-toggle 

多区域渐变效果（Beam / Strip 设备）

多区域设备支持对各个区域独立寻址。可通过为不同区域范围设置不同状态来创建渐变效果：

bash lifx-api.sh state 'id:|0-4' '{"power":"on","color":"purple","brightness":1.0,"duration":1.0}'
bash lifx-api.sh state 'id:|5-9' '{"power":"on","color":"red","brightness":1.0,"duration":1.0}'

区域选择器中的竖线字符（|）将由脚本自动进行 URL 编码。

检查场景状态

python3 scene-status.py all    # 显示所有当前激活的场景
python3 scene-status.py check   # 检查指定场景是否激活

列出当前灯具状态

bash lifx-api.sh list    # 输出完整 JSON
bash lifx-api.sh groups  # 按房间汇总显示

行为规范

• 当用户提及房间名称时，请匹配上方“设备上下文”中列出的对应群组 ID。
• 设置颜色时，默认亮度设为 1.0（100%），除非用户明确指定其他值。
• 过渡动画默认持续时间为 1.0 秒，以确保平滑变化。
• 处理“关闭”指令时，应使用 {"power":"off"}，而非 toggle（toggle 行为存在歧义）。
• 处理“开启”指令时，应使用 {"power":"on","brightness":1.0}，以确保灯具可见。
• 当被问及“哪些灯开着”或“当前启用的是哪个场景”时，应调用 scene-status 工具或 discover 命令获取实时状态。
• 结果反馈需采用自然对话风格，例如：“已完成，卧室灯光已设为 75% 亮度的蓝色”，而非“API 返回 207”。