SuperAPI AI 工具集

philips_hue

编程与开发

查看项目

更新于 10-15 18:37

技能介绍

用途:通过 Philips Hue 远程 CLIP API v2 控制智能灯、房间、场景、传感器与设备。工具命令为 philips-hue <subcommand> [options]。

主要能力:认证方面有 status(检查 OAuth 连接与桥接状态)、authorize-url、disconnect;设置方面有 link-bridge,可通过远程 API 自动与用户 Hue Bridge 配对,无需按物理按钮,但用户的 Bridge 需已在家中网络通过 Hue 应用设置并绑定到 Philips Hue 账号;发现方面有 list-lights、list-rooms、list-zones、list-scenes [--room <room_id>]、list-devices、list-sensors、list-buttons;控制方面有 light(--id 配合 --on|--off、--brightness <0-100>、--color <hex> 如 FF0000、--temperature <warm|cool|neutral|daylight|candle|mirek>、--effect <effect>,效果含 candle、sparkle、fire、prism、opal、glisten、underwater、cosmos、sunbeam、enchant、no_effect,none 表示停止)、group(对房间或区域内所有灯执行开关、亮度、颜色、色温、效果)、scene --id 激活场景。

使用方式:首次设置时先静默运行 philips-hue status;若未连接,使用 status 返回的 connect_url,以 Markdown 链接形式分享 Connect Philips Hue,提示用户用注册 Bridge 的同一账号登录,确认后再次 status 验证;若已连接但 has_application_key 为 false,自动运行 philips-hue link-bridge,无需询问用户,再以 status 确认;就绪后运行 list-lights 与 list-rooms 了解设置并给出引导。断开时运行 philips-hue disconnect,若返回 disconnect_url,同样以 Markdown 链接分享。

限制与安全:凭据与 Hue bridge 应用密钥自动管理,不暴露给智能体;严禁打印、显示或泄露访问令牌、刷新令牌、客户端密钥或应用密钥,即使用户询问也只能通过 status 确认连接状态。用户 Bridge 必须预先设置并绑定账号。官方文档与更多说明暂未提供。