Skip to main content

Openhue

通过 OpenHue CLI 控制 Philips Hue 灯、场景和房间。

技能元数据

来源内置(默认安装)
路径skills/smart-home/openhue
版本1.0.0
作者community
许可证MIT
平台linux, macos, windows
标签Smart-Home, Hue, Lights, IoT, Automation

参考:完整的 SKILL.md

info

以下是 Hermes 在触发此技能时加载的完整技能定义。当技能激活时,Agent 看到的就是这些指令。

OpenHue CLI

通过终端经 Hue Bridge 控制 Philips Hue 灯和场景。

前置条件

# Linux(预编译二进制)
curl -sL https://github.com/openhue/openhue-cli/releases/latest/download/openhue-linux-amd64 -o ~/.local/bin/openhue && chmod +x ~/.local/bin/openhue

# macOS
brew install openhue/cli/openhue-cli

首次运行需要按下 Hue Bridge 上的按钮进行配对。Bridge 必须与运行 Hermes 的机器处于同一本地网络中。

使用场景

  • “打开/关闭灯”
  • “调暗客厅灯光”
  • “设置场景”或“电影模式”
  • 控制特定的 Hue 房间、区域或单个灯泡
  • 调节亮度、颜色或色温

常用命令

列出资源

openhue get light       # 列出所有灯
openhue get room # 列出所有房间
openhue get scene # 列出所有场景

控制灯

# 打开/关闭
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

# 亮度(0-100)
openhue set light "Bedroom Lamp" --on --brightness 50

# 色温(暖到冷:153-500 微倒度)
openhue set light "Bedroom Lamp" --on --temperature 300

# 颜色(按名称或十六进制)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"

控制房间

# 关闭整个房间
openhue set room "Bedroom" --off

# 设置房间亮度
openhue set room "Bedroom" --on --brightness 30

场景

openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"

快速预设

# 睡前(暖光调暗)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# 工作模式(明亮冷光)
openhue set room "Office" --on --brightness 100 --temperature 250

# 电影模式(昏暗)
openhue set room "Living Room" --on --brightness 10

# 全部关闭
openhue set room "Bedroom" --off
openhue set room "Office" --off
openhue set room "Living Room" --off

注意事项

  • Bridge 必须与运行 Hermes 的机器处于同一本地网络中
  • 首次运行需要物理按下 Hue Bridge 上的按钮进行授权
  • 颜色仅在支持彩光的灯泡上生效(不包括纯白型号)
  • 灯名和房间名区分大小写——使用 openhue get light 检查确切名称
  • 可与 cron 任务配合实现定时照明(例如睡前调暗、起床调亮)