Homey - Home Automation — Homey - Home 自动化

Homey 命令行工具

Safe, 代理-friendly 命令行工具 for controlling Homey home 自动化 hubs.

What This 技能 Provides Device control: Turn devices on/off, dim lights, change colors, 设置 temperatures Device inspection: 列出 devices, 检查 状态, read capabilities Zone management: 列出 zones and devices per zone Flow control: 列出 and trigger flows Inventory: 获取 complete hub overview 设置up

• 安装 Dependencies

cd 技能s/homey-命令行工具 npm 安装

• 创建 Homey 应用 凭证s

Go to https://工具s.developer.homey.应用/工具s/应用 创建 a new 应用 with: Callback URL: http://localhost:8787/callback Note your 命令行工具ent ID and 命令行工具ent Secret

• 配置 环境

创建 .env file:

导出 HOMEY_命令行工具ENT_ID="your-命令行工具ent-id" 导出 HOMEY_命令行工具ENT_SECRET="your-命令行工具ent-secret" 导出 HOMEY_REDIRECT_URL="http://localhost:8787/callback"

• 记录in

bash 运行.sh auth 记录in

Follow the OAuth flow in your browser. 令牌s are stored in ~/.config/homey-命令行工具/.

Usage 列出 Homeys bash 运行.sh homey 列出

Select Active Homey bash 运行.sh homey use

Device Operations # 列出 all devices bash 运行.sh devices 列出

# 列出 devices as JSON bash 运行.sh devices 列出 --json

# 获取 specific device bash 运行.sh devices 获取

# Read capability value bash 运行.sh devices read onoff

# Control devices bash 运行.sh devices on bash 运行.sh devices off bash 运行.sh devices dim 0.4 bash 运行.sh devices color #FF8800 bash 运行.sh devices temperature 21.5

Flow Operations # 列出 flows bash 运行.sh flows 列出

# Trigger flow bash 运行.sh flows trigger

Complete Inventory bash 运行.sh inventory --json

Safety 模型

Write operations are capability-allow列出ed for safety:

Default allowed: onoff, dim, light_hue, light_saturation, light_temperature, tar获取_temperature Override via: 导出 HOMEY_命令行工具_ALLOWED_CAPABILITIES=onoff,dim,tar获取_temperature

Destructive operations (删除 devices, modify flows, change 应用 设置tings) are not supported.

Common Queries

When users ask:

"Turn on the kitchen lights" → 列出 devices, find match, use devices on "Dim living room to 50%" → Find device, use devices dim 0.5 "What's the temperature in the bedroom?" → Find device, use devices read measure_temperature "列出 all my lights" → Use devices 列出 --json and 过滤器 by class/capabilities Configuration Storage 令牌s: ~/.config/homey-命令行工具/凭证s.json Active Homey: ~/.config/homey-命令行工具/config.json Troubleshooting Auth errors: Re-运行 bash 运行.sh auth 记录in Device not found: 检查 device name/ID with bash 运行.sh devices 列出 Capability not allowed: 添加 to HOMEY_命令行工具_ALLOWED_CAPABILITIES or 检查 if it's a read-only capability