跳到主要内容

Openhue

通过 OpenHue CLI 控制 Philips Hue 灯光、房间和场景。开关灯光、调节亮度、颜色、色温以及激活场景。

技能元数据

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

参考:完整 SKILL.md

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。

OpenHue CLI

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

前提条件

# Linux (pre-built binary)
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 必须位于同一本地网络上。

何时使用

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

常用命令

列出资源

openhue get light       # List all lights
openhue get room # List all rooms
openhue get scene # List all scenes

控制灯光

# Turn on/off
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

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

# Color temperature (warm to cool: 153-500 mirek)
openhue set light "Bedroom Lamp" --on --temperature 300

# Color (by name or hex)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"

控制房间

# Turn off entire room
openhue set room "Bedroom" --off

# Set room brightness
openhue set room "Bedroom" --on --brightness 30

场景

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

快速预设

# Bedtime (dim warm)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# Work mode (bright cool)
openhue set room "Office" --on --brightness 100 --temperature 250

# Movie mode (dim)
openhue set room "Living Room" --on --brightness 10

# Everything off
openhue set room "Bedroom" --off
openhue set room "Office" --off
openhue set room "Living Room" --off

注意事项

  • Bridge 必须与运行 Hermes 的机器位于同一本地网络上
  • 首次运行需要物理按下 Hue Bridge 上的按钮以进行授权
  • 颜色仅适用于支持颜色的灯泡(不适用于仅白光型号)
  • 灯光和房间名称区分大小写 — 使用 openhue get light 检查确切名称
  • 与 cron 任务配合使用可实现定时照明(例如,就寝时调暗,醒来时调亮)