SKILL.md universal-smarthome 通用智能家居支配Skill Dominate your smart home with seamless control across Home Assistant and Tuya Smart. 通过Home Assistant（首选）和涂鸦智能（备选）操控全球品牌家电，支持模糊名称匹配。

Setup 设置 Option 1: Config File (Recommended) 选项1：配置文件（推荐） Create /.config/universal-smarthome/config.json: 创建/.config/universal-smarthome/config.json：

{ "homeassistant": { "url": "http://homeassistant.local:8123", "token": "your-long-lived-access-token" }, "tuya": { "access_id": "your-access-id", "access_secret": "your-access-secret", "endpoint": "https://openapi.tuyacn.com" } } Option 2: Environment Variables 选项2：环境变量 export HA_URL="http://homeassistant.local:8123" export HA_TOKEN="your-long-lived-access-token" export TUYA_ACCESS_ID="your-access-id" export TUYA_ACCESS_SECRET="your-access-secret" Getting Home Assistant Token 获取Home Assistant令牌 Open Home Assistant → Profile (bottom left) 打开Home Assistant → 个人资料（左下角） Scroll to "Long-Lived Access Tokens" 滚动到“长期访问令牌” Click "Create Token", name it (e.g., "Clawdbot") 点击“创建令牌”，将其命名（例如，“Clawdbot”） Copy the token immediately (shown only once) 立即复制令牌（仅显示一次） Getting Tuya Credentials 获取涂鸦凭据 Log in to Tuya Smart Platform (https://iot.tuya.com/) 登录涂鸦智能开放平台（https://iot.tuyacn.com/） Create a cloud project or navigate to "Cloud Development" 创建云项目或进入“云开发” Get access_id and access_secret from the project credentials 从项目凭据中获取access_id和access_secret Quick Reference 快速参考 Discovery 设备发现 python3 scripts/smart.py discovery Sync all devices from Home Assistant and Tuya to local cache. 从Home Assistant和涂鸦同步所有设备到本地缓存。

Control Devices 控制设备

Turn on device by name

python3 scripts/smart.py control "device_name" on

Turn off device by name

python3 scripts/smart.py control "device_name" off

The script automatically identifies the platform (HA or Tuya) based on device ID

脚本根据设备ID自动识别平台（HA或涂鸦）

Device Name Matching 设备名称匹配 The script supports fuzzy name matching: 脚本支持模糊名称匹配：

If device_cache.json contains:

{"id": "light.living_room", "name": "客厅灯", "platform": "homeassistant"}

User can say: "打开客厅灯" or "打开灯"

用户可以说：“打开客厅灯”或“打开灯”

Priority: Exact name match → ID match → Fuzzy match 优先级：精确名称匹配 → ID匹配 → 模糊匹配 CLI Wrapper CLI包装器 The scripts/smart.py CLI provides smart home control: scripts/smart.py CLI提供智能家居控制：

Discovery - sync all devices

python3 scripts/smart.py discovery

Control device by name

python3 scripts/smart.py control "客厅灯" on python3 scripts/smart.py control "卧室灯" off