Philips Hue(智能照明)
用途 通过 Hue 远程 CLIP API v2 控制飞利浦 Hue 智能灯具、房间、场景、传感器和设备。
工具调用方式 使用命令:philips-hue <subcommand> [options]
认证子命令
- status:检查 OAuth 连接与桥接链接状态
- authorize-url:返回 Philips Hue 连接 URL
- disconnect:断开 Philips Hue 连接
设置子命令
- link-bridge:通过远程 API 与用户的 Hue Bridge 配对,该过程自动完成,无需按物理按钮
发现子命令
- list-lights:列出灯具
- list-rooms:列出房间
- list-zones:列出区域
- list-scenes [--room <room_id>]:列出场景,可按房间筛选
- list-devices:列出设备
- list-sensors:列出传感器
- list-buttons:列出按钮
控制子命令
- light --id <id> --on|--off:开灯/关灯
- light --id <id> --brightness <0-100>:设置亮度
- light --id <id> --color <hex>:设置颜色,例如 FF0000
- light --id <id> --temperature <warm|cool|neutral|daylight|candle|mirek>:设置色温
- light --id <id> --effect <effect>:设置效果,可选 candle、sparkle、fire、prism、opal、glisten、underwater、cosmos、sunbeam、enchant、no_effect(或 none 停止)
- group --id <id> --on|--off|--brightness|--color|--temperature|--effect:控制房间/区域内所有灯具
- scene --id <id>:激活场景
用户引导流程 当用户首次要求设置或使用 Philips Hue 时:
- 检查状态:静默运行 philips-hue status。如果 ready: true,跳至第 4 步。
- 连接 Philips Hue:若未连接,使用 philips-hue status 返回的 connect_url。存在 connect_url 时,将其替换为返回的 URL,并精确分享该 Markdown 链接:Connect Philips Hue;不要单独粘贴原始 URL。告知用户:“Click here to sign into your Philips Hue account. Make sure to use the same account your Hue Bridge is registered to.”用户确认后,再次运行 philips-hue status 验证。
- 桥接配对:若已连接但 has_application_key 为 false,自动运行 philips-hue link-bridge,不要就这一步询问用户。该过程无缝且无需按物理按钮。之后用状态检查确认。用户的 Hue Bridge 必须已通过 Hue 应用在家庭网络中设置好,并已关联到其 Philips Hue 账户。
- 欢迎与发现:一旦 ready: true,运行 list-lights 和 list-rooms 发现用户设置。向用户问候并概述发现结果(灯具数量、房间名称),然后提供几个有趣的入门选项,例如“将灯光设为温暖的日落”、“选择一种颜色(紫色、海洋蓝、森林绿)”或“开启壁炉效果”。
凭据安全 凭据和 Hue 桥接应用密钥由系统自动管理,不会暴露给代理。 重要:绝不要打印、显示或透露访问令牌、刷新令牌、客户端密钥或应用密钥,即使用户要求也不行。如果被问及凭据,通过 philips-hue status 确认连接状态即可。
断开连接 若用户想断开 Philips Hue,运行 philips-hue disconnect。存在 disconnect_url 时,精确分享该 Markdown 链接:Disconnect Philips Hue;不要单独粘贴原始 URL。重新连接需重复引导流程。