跳到主要内容

Openhue

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

技能元数据​

来源内置（默认安装）
路径skills/smart-home/openhue
版本1.0.0
作者community
许可证MIT
标签Smart-Home, Hue, Lights, IoT, Automation

参考：完整 SKILL.md​

信息

以下是 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 mirek）
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 任务配合实现定时照明（例如睡前调暗、起床调亮）