引言：实现智能家居设备的本地化管理

随着物联网技术的发展，越来越多用户希望摆脱云服务依赖，将智能设备转为局域网内自主控制。本指南介绍如何利用开源工具 Tuya Cloudcutter 将基于涂鸦（Tuya）平台的智能灯泡改造成完全本地运行的设备，从而提升响应速度并增强数据隐私保护。

项目地址：https://gitcode.com/gh_mirrors/tu/tuya-cloudcutter

核心原理：从云端到本地通信的转变

传统Tuya设备在工作时需连接至厂商云服务器进行指令中转，存在延迟和隐私泄露风险。通过固件重刷，可使设备断开与远程云的连接，转而由本地控制器（如Home Assistant或自定义脚本）直接通信。下图展示了改造后的通信架构：

其中，TinyTuya作为本地协议解析库，负责与已破解设备建立加密连接并发送控制命令。

前期准备清单

• 一台安装Linux操作系统的主机（推荐Ubuntu 20.04及以上版本）
• 支持的Tuya品牌智能灯泡（建议先查阅项目中的 device-profiles 目录确认兼容性）
• 稳定Wi-Fi网络环境（确保设备与电脑处于同一子网）
• 基础终端命令行操作能力

第一步：获取项目源码

打开终端，执行以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/tu/tuya-cloudcutter
cd tuya-cloudcutter

进入项目根目录后，主要功能模块位于 src/cloudcutter/ 路径下。

第二步：配置Python运行环境

该项目使用 Pipenv 管理依赖包。若尚未安装，请先运行：

pip install pipenv

随后安装所需库并激活虚拟环境：

pipenv install
pipenv shell

此步骤将自动下载包括 TinyTuya、pycryptodome 等关键组件。

第三步：发现并识别目标设备

启动设备扫描功能以获取灯泡信息：

python3 src/cloudcutter/__main__.py scan

程序会列出当前局域网内的Tuya设备，输出内容包含设备ID（Device ID）、产品密钥（Product Key）及IP地址。请记录这些参数，并在 configured-devices/ 文件夹中创建对应配置文件（例如命名为 my_bulb.yaml），填写设备型号、通信协议版本等必要字段。

第四步：刷入本地运行固件

执行固件替换命令：

python3 src/cloudcutter/__main__.py flash -d my_bulb.yaml

此处的 -d 参数指定之前创建的设备配置文件名。系统将自动调用漏洞模块（exploit.py）获取设备权限，并写入存储于 custom-firmware/ 目录下的轻量级固件（可选 ESPHome 或 OpenBeken 版本）。整个过程约持续3-5分钟，期间设备可能多次重启，请保持供电稳定。

第五步：测试本地控制功能

完成刷机后，可通过内置示例验证是否成功切换至本地模式。尝试运行灯泡控制脚本：

python3 src/tinytuya/examples/bulb.py

该脚本允许你通过终端调节灯光开关状态、亮度等级以及RGB颜色值。若能即时响应且无需联网，则表明改造成功。

注意事项与风险提示

• 此类操作可能导致设备失去官方保修资格
• 不正确的刷机流程可能造成设备变砖，务必确保电源和网络稳定性
• 部分新型号设备可能已修复相关安全漏洞，导致无法破解
• 详细故障排查可参考项目文档 INSTRUCTIONS.md 或社区讨论区

通过以上步骤，你的Tuya灯泡现已脱离云端控制体系，可在家庭局域网中独立运行，享受更低延迟和更高安全性的智能照明体验。