homey-cli

核心用法

homey-cli 是一个面向 Homey 智能家居中枢的纯文档型 CLI 控制指南，旨在帮助用户通过命令行安全地管理智能设备。用户需先完成 OAuth 应用注册与本地环境配置，随后即可执行设备开关、调光调色、温控调节、区域管理及流程触发等操作。所有交互均通过 bash run.sh 命令完成，支持 JSON 格式输出便于脚本集成。

显著优点

安全设计突出：采用能力白名单机制，默认仅允许 onoff、、dim、、light_hue 等基础操作，明确禁止删除设备、修改流程等破坏性动作，大幅降低误操作风险。来源可信：作者 Felix Krause 为知名 iOS 安全研究员及 fastlane 创始人，技术背景扎实。隐私友好：OAuth Token 完全本地存储于 ~/.config/homey-cli/，无云端数据上传。功能覆盖全面：涵盖设备控制、状态查询、区域管理、流程触发及完整库存导出，满足日常自动化需求。零代码侵入：Skill 本身为纯 Markdown 文档，无可执行代码，用户完全掌控执行时机。

潜在缺点与局限性

纯文档依赖：Skill 不直接执行任何操作，所有功能需用户手动运行外部命令，自动化程度受限。配置门槛较高：需自行注册 Homey 开发者应用、配置 OAuth 回调地址及环境变量，对非技术用户不够友好。功能边界受限：明确不支持删除设备、修改系统设置等高级操作，复杂场景需借助官方工具。外部工具依赖：实际功能依赖用户自行安装的 homey-cli 工具，版本兼容性需自行维护。无实时反馈机制：文档型设计意味着无内置错误处理或状态监控，问题排查依赖用户手动诊断。

适合的目标群体

技术型智能家居用户：熟悉命令行操作、希望批量管理设备的进阶用户。开发者与集成工程师：需要将 Homey 控制集成到脚本、CI/CD 或自定义应用中的技术人员。隐私敏感用户：偏好本地凭据存储、拒绝云端授权方案的安全意识群体。自动化爱好者：希望通过脚本实现定时任务、场景联动的智能家居玩家。

使用风险

OAuth 凭据泄露风险：Client ID/Secret 若保管不当或误提交至版本控制，可能导致未授权访问。Token 本地存储风险：~/.config/homey-cli/credentials.json 文件权限配置不当可能被其他应用读取。操作误执行风险：虽有能力白名单保护，但用户手动输入命令时仍可能选错设备 ID。外部工具供应链风险：homey-cli 工具本身的安全更新、依赖漏洞需用户自行跟踪。环境配置漂移：多 Homey 设备切换或配置变更时，可能因状态文件混乱导致操作对象错误。