universal-smarthome 是一个通用智能家居控制技能（Skill），旨在通过统一的接口实现对全球主流智能设备的无缝操控。它优先采用 Home Assistant 作为核心控制平台，利用其本地化的快速响应能力和基于实体的设备管理架构；当主平台不可用或设备不支持时，自动回退至 Tuya Smart 云端 API，确保广泛的设备兼容性。该工具支持模糊名称匹配，用户可以通过自然语言如“打开客厅灯”或简短的“打开灯”来精准定位并控制家中设备，极大提升了交互的灵活性和便捷性。
核心功能特点
- 支持 Home Assistant（首选）和 Tuya Smart（备用）双平台控制
- 提供模糊名称匹配功能，支持自然语言设备识别
- 具备本地设备缓存机制，提升响应速度和离线可用性
- 通过 CLI 脚本实现一键设备发现与控制
- 配置文件与环境变量双重配置方式，适配不同部署场景
适用场景
universal-smarthome 特别适合希望整合多品牌智能设备的家庭用户。无论您使用的是小米、美的、海尔等接入涂鸦生态的设备，还是运行着自定义自动化规则的 Home Assistant 系统，该工具都能将其纳入统一的控制体系。例如，用户可以在语音助手的指令中直接说“关闭卧室灯”，系统会先在本地缓存中查找设备 ID，优先尝试通过 Home Assistant 发送指令，若失败则自动切换至 Tuya 云端完成操作。这种设计既保证了控制效率，又扩展了设备覆盖范围。此外，对于需要远程访问或集成到第三方应用（如 Clawdbot 聊天机器人）中的开发者而言，该工具提供了安全可靠的 API 封装，无需关心底层协议差异即可实现跨平台设备联动。