HomeAssistant 添加涂鸦（Tuya）设备主要有两种方式：官方 Tuya 集成（云端，最简单）和 Tuya Local（本地化，响应快但配置稍繁琐）。
对于“小白”用户，强烈推荐使用官方 Tuya 集成。现在的版本（2025.12.x）已经极极大简化了步骤，不再需要像以前那样去注册开发者账号、申请 Access ID、担心开发者试用期过期了。现在只需要一个“用户代码”和手机 App 扫码即可。
以下是基于 HomeAssistant 2025.12.2 版本的详细小白教程。
🟢 方式一：官方 Tuya 集成（推荐新手）
这种方式最简单，配置好后，你在手机“涂鸦智能”或“智能生活”App 里能看到的设备，都会自动同步到 HomeAssistant。
1. 准备工作
- 手机 App：确保你手机上安装了 “涂鸦智能” (Tuya Smart) 或 “智能生活” (Smart Life) App。
- 账号：已注册登录，并且 App 里已经添加了你的智能设备（如插座、灯泡等）。
- 网络：手机和 HomeAssistant 最好在同一个局域网，但这对于云端集成不是强制的。
2. 获取“用户代码” (User Code)
这是新版集成最关键的一步，替代了以前复杂的开发者账号。
- 打开手机上的 涂鸦智能 或 智能生活 App。
- 点击右下角的 “我” (Me)。
- 点击右上角的 六边形设置图标 (⚙️)。
- 点击第一项 “账号与安全” (Account and Security)。
- 在页面中间，你会看到 “用户代码” (User Code)。
- 点击在这个代码旁边的“复制”按钮（或手动记下来）。
注意
：如果找不到“用户代码”，请确保你的 App 已经更新到最新版本。
3. 在 HomeAssistant 中添加集成
- 电脑浏览器打开 HomeAssistant 后台（通常是 http://homeassistant.local:8123）。
- 点击左侧侧边栏的 “设置” (Settings)。
- 选择 “设备与服务” (Devices & Services)。
- 点击右下角的蓝色按钮 “+ 添加集成” (+ ADD INTEGRATION)。
- 在搜索框输入 Tuya，点击出现的 Tuya 图标。
4. 进行配对
- HomeAssistant 弹出的窗口中，会要求你输入 用户代码。
- 将刚才在手机 App 里获取的 用户代码 粘贴进去，点击“提交”。
- 屏幕上会显示一个 二维码。
- 立刻拿起手机，打开涂鸦/智能生活 App：
- 回到 App 首页（“家庭”页面）。
- 点击右上角的 “+” 号，选择 “扫一扫”。
- 扫描电脑屏幕上的二维码。
手机上会弹出确认登录的提示，点击 “确认登录”。
5. 完成
- HomeAssistant 页面会自动刷新，提示“成功！”。
- 你可以将设备分配到具体的房间（建议选好区域，方便管理），然后点击“完成”。
- 现在去 “概览” (Overview) 面板，你应该能看到你的涂鸦设备已经出现了，并且可以控制开关！
🔵 方式二：Tuya Local（进阶，本地控制）
如果你发现官方集成响应慢，或者断网就不能用了，可以尝试这个方案。它通过 HACS 安装，能实现
简述流程（供参考）：
- 需要先安装 HACS（Home Assistant Community Store）。
- 在 HACS 中搜索并下载 Tuya Local（注意不是 LocalTuya，Tuya Local 配置更友好）。
- 重启 HomeAssistant。
- 在“设备与服务”里添加集成，搜索 Tuya Local。
- 新版优势：现在的 Tuya Local 也支持上述的“扫码”模式来自动获取 Key，不再需要去开发者平台抓包了，非常方便。
常见问题 (Q&A)
Q: 以前教程说要注册 iot.tuya.com 开发者账号，还需要 Access ID 和 Secret，还要每6个月延期一次，现在不用了吗？A:不用了！ 那是旧版（2024年初之前）的流程。现在的官方集成使用的是“智能家庭 PaaS”模式，普通用户只需要 App 扫码即可，完全避开了繁琐的开发者试用期问题。
Q: 设备在 HomeAssistant 里显示“不可用”怎么办？A:
- 检查物理设备是否通电且连网。
- 在 HA 的集成页面，找到 Tuya，点击三个小点，选择 “重新加载” (Reload)。
- 如果还是不行，尝试重启 HomeAssistant。
Q: 我在 App 里改了设备名字，HA 会同步吗？A: 不会实时同步。你需要去 HA 的 Tuya 集成页面点击“重新加载”，它才会更新最新的设备名称。
