Homey 智能家居全能控制台

基于官方 Homey API 的 CLI 工具，支持本地/云端双模式控制 Athom 智能家居设备，实现灯光、温控、场景自动化等全屋智能管理。

基本信息

• 技能名称?homey
• 中文名称?Homey 智能家居全能控制台
• 作者?maxsumrall
• 分类?办公
• 版本?v1.1.2
• 标签?iot, smart-home, automation, cli, api, productivity

使用方法

使用说明
核心用法
Homey CLI 是一款专为 Athom Homey 智能家居平台设计的命令行控制工具，支持通过本地局域网（LAN/VPN）或云端 API 两种方式连接并操控智能设备。用户需先配置认证令牌（本地 API Key 或云 Token），即可执行设备查询、状态控制、场景触发等操作。核心命令包括 homeycli devices 查看设备列表、、 homeycli device on/off 开关设备、、 homeycli flow trigger > 触发自动化流程，以及 homeycli snapshot 获取全屋状态快照供 AI 解析。工具采用模糊匹配技术，支持设备名称的近似搜索，大幅降低语音或文本指令的识别门槛。
显著优点

1. 双模式灵活部署 ：本地模式延迟极低、隐私性佳，适合家庭内网；云模式支持远程 VPS 托管，满足 headless 场景需求。
2. AI 友好输出 ：所有命令支持 --json 参数，输出结构化数据便于 AI Agent 解析和自动化决策。
3. 模糊匹配体验 ：内置 Levenshtein 距离算法，容忍拼写错误和简称，如 "livng light" 可正确匹配 "Living Room Light"。
4. 官方 API 背书 ：底层依赖 Athom 官方 homey-api 包（v3.15.0），协议兼容性和长期维护有保障。
5. 细粒度控制能力 ：不仅支持开关操作，还可精确调节亮度、色温、目标温度、锁状态等数十种设备能力值。
   潜在缺点与局限性
6. 硬件生态绑定 ：仅兼容 Athom Homey 系列（Pro/Cloud/Bridge），无法对接米家、HomeKit 等其他平台。
7. Token 管理门槛 ：用户需自行从 Homey Web App 或 Developer Tools 获取 API 密钥，对非技术用户存在学习成本。
8. 网络依赖性强 ：本地模式要求运行环境与 Homey 同网络或 VPN 可达；云模式依赖 Athom 云服务可用性。
9. 无图形界面 ：纯 CLI 交互，虽适合自动化脚本，但临时调试不如官方 App 直观。
10. 社区维护风险 ：目前为个人开发者项目（T3 来源），长期更新承诺弱于企业级产品。
    适合的目标群体
    智能家居极客 ：偏好代码和自动化脚本管理全屋设备的用户。
    AI Agent 开发者 ：需要将 Homey 设备控制能力集成到自定义 AI 助手的工程师。
    远程运维场景 ：通过 VPS 或云服务器异地管理家庭设备的管理员。
    Homey 深度用户 ：已部署 Homey 生态，希望突破官方 App 功能边界的高级玩家。
    使用风险
11. Token 泄露风险 ：API 密钥以明文形式存储于 ~/.homey/config.json ，虽文件权限设为 0o600，但 root 用户或备份泄露仍可能导致未授权访问。
12. 网络中断影响 ：本地模式下 mDNS 发现失败或 IP 变更会导致连接中断；云模式受 Athom 服务稳定性制约。
13. 误操作风险 ：模糊匹配虽便利，但极端情况下可能误匹配相似名称设备（如 "Bedroom Light" 与 "Bedroom Light Strip"），建议关键操作前先用 --json 确认设备 ID。
14. 依赖项更新 ： homey-api 等依赖若出现破坏性更新，可能导致功能异常，需关注版本锁定状态。