核心功能
Homey 技能通过封装官方 homey-api npm 包，为 AI Agent 提供对 Athom Homey 智能家居生态系统的完整控制能力。支持两种连接模式：本地 LAN/VPN 模式（使用 Homey Web App 生成的本地 API Key）和云端远程模式（使用 Developer Tools 的个人访问令牌）。
显著优点
1. 双模式架构：本地模式延迟低、隐私好，适合家庭网络部署；云端模式支持 VPS/无公网 IP 场景，灵活性极高
2. 模糊匹配与容错：设备/场景名称支持子串匹配和 Levenshtein 距离模糊匹配，对语音输入或自然语言查询友好
3. 标准化 JSON 接口：所有命令支持 --json 输出，便于 AI 解析和设备状态快照（snapshot 命令专为 Agent 设计）
4. 能力抽象统一：将不同协议（Zigbee/Z-Wave/Wi-Fi/Thread）的设备统一为 onoff、dim、target_temperature 等标准能力接口
5. 生态完整性：覆盖设备控制、传感器读取、场景触发（Flows）、区域（Zones）查询四大核心域
潜在局限
1. 认证配置门槛：需用户自行获取 Local API Key 或 Cloud Token，无 OAuth 简化流程
2. Node.js 依赖：要求运行环境 Node.js >= 18，对部分嵌入式/容器场景不够轻量
3. 无状态感知：CLI 为无状态工具，不缓存设备在线状态，频繁查询可能增加 Homey 负载
4. 并发控制缺失：未内置流量控制或重试机制，高频自动化场景需外部协调
适用人群
- 已拥有 Homey Pro/Cloud/Bridge 的技术型家庭用户
- 需在 VPS/云服务器上部署远程家庭自动化的进阶用户
- 希望将 Homey 接入自建 AI Agent 或语音助手的开发者
常规风险
- 令牌泄露：Cloud Token 具备完整设备控制权限，需妥善保管
- 网络暴露：本地模式若配置不当（如公网暴露 Homey IP），存在未授权访问风险
- 误操作：模糊匹配可能选中错误设备，建议关键操作前用
devices --match验证