Homey CLI 是用于控制 Homey 家庭自动化中枢的命令行工具，强调对智能体友好与操作安全。
用途：控制智能家居设备（灯、温控、插座等）、查看设备状态、列出设备与分区、触发流程，并获取中枢整体清单。
主要能力：设备控制（开关、调光、变色、设定温度）、设备检查（列表、状态、读取能力值）、分区管理（按分区列出设备）、流程控制（列出与触发流程）、完整清单获取（inventory）。
使用方式：进入 skills/homey-cli 后执行 npm install；在 https://tools.developer.homey.app/tools/app 创建应用，回调地址为 http://localhost:8787/callback，记录 Client ID 与 Client Secret；在 .env 中配置 HOMEY_CLIENT_ID、HOMEY_CLIENT_SECRET、HOMEY_REDIRECT_URL；执行 bash run.sh auth login 完成 OAuth 登录，令牌存于 ~/.config/homey-cli/。常用命令包括 bash run.sh homey list、bash run.sh homey use <homeyId>、bash run.sh devices list（可加 --json）、bash run.sh devices get <deviceId>、bash run.sh devices read <deviceId> onoff，以及 bash run.sh devices on/off/dim/color/temperature、bash run.sh flows list、bash run.sh flows trigger <flowId>、bash run.sh inventory --json。
安全与限制：写操作采用能力白名单，默认允许 onoff、dim、light_hue、light_saturation、light_temperature、target_temperature，可通过 HOMEY_CLI_ALLOWED_CAPABILITIES 覆盖；不支持删除设备、修改流程、更改应用设置等破坏性操作。令牌存于 ~/.config/homey-cli/credentials.json，当前中枢存于 config.json。认证失败可重新运行登录命令；能力不被允许时需加入白名单或确认是否为只读能力。价格、平台支持范围等资料暂未提供。