SuperAPI AI 工具集

philips_hue

通用与其它

查看项目

更新于 10-26 18:14

技能介绍

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 时:

  1. 检查状态:静默运行 philips-hue status。如果 ready: true,跳至第 4 步。
  2. 连接 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 验证。
  3. 桥接配对:若已连接但 has_application_key 为 false,自动运行 philips-hue link-bridge,不要就这一步询问用户。该过程无缝且无需按物理按钮。之后用状态检查确认。用户的 Hue Bridge 必须已通过 Hue 应用在家庭网络中设置好,并已关联到其 Philips Hue 账户。
  4. 欢迎与发现:一旦 ready: true,运行 list-lights 和 list-rooms 发现用户设置。向用户问候并概述发现结果(灯具数量、房间名称),然后提供几个有趣的入门选项,例如“将灯光设为温暖的日落”、“选择一种颜色(紫色、海洋蓝、森林绿)”或“开启壁炉效果”。

凭据安全 凭据和 Hue 桥接应用密钥由系统自动管理,不会暴露给代理。 重要:绝不要打印、显示或透露访问令牌、刷新令牌、客户端密钥或应用密钥,即使用户要求也不行。如果被问及凭据,通过 philips-hue status 确认连接状态即可。

断开连接 若用户想断开 Philips Hue,运行 philips-hue disconnect。存在 disconnect_url 时,精确分享该 Markdown 链接:Disconnect Philips Hue;不要单独粘贴原始 URL。重新连接需重复引导流程。