# TCLimate：重建选定的 TCL Home 云端控制

> 在原生 macOS 菜单栏应用中实现选定的 TCL Home 空调控制与用电量报告。项目改编既有社区协议实现，并记录通过调查 Android 模块恢复另一条统计请求的过程。报告的验证检查云端状态，不等于独立核实设备实际运行或完整设备等价性。

- 类型：案例
- 目标：应用 · 协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-18
- 收录于：2026-10-18
- 原始资源：<https://github.com/umarz317/TCLimate>
- 一手来源：<https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Docs/Investigation.md>
- 目录页面：<https://awesomerea.org/zh/resources/tclimate-cloud-controls-case/>
- 记录 JSON：<https://awesomerea.org/resources/tclimate-cloud-controls-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/tclimate-cloud-controls-case/index.md)

## 使用条件与局限

- **前提条件：**审阅版本为 v0.1.6 beta，需要 macOS 14+、互联网连接及已配对空调的 TCL 账号。构建需要 Swift 6.0+、Xcode Command Line Tools，以及供应用打包使用的固定签名证书。配对仍通过 TCL Home 完成；未实现局域网控制或直接使用 Google 登录。
- **署名：**协议实现明确归功于 nemesa 的 MIT 许可 Home Assistant 集成。文档报告通过检查 Android Flutter 模块及一次成功请求的抓包确定用电量 API；原始安装包、抓包及详细调查日志未收录在仓库中。
- **范围：**源码根据设备上报的型号／状态字段限制命令，将目标温度限定为 16–30°C 的整数，并在发送后核对上报状态。未确认的命令会被标记。额外控制项取决于可用字段与模式。
- **测试证据：**作者验证覆盖一个巴基斯坦账号和两台 Split AC-1：认证、发现、上报状态、电源、温度及每日用电量。模式、风速、风向和其他可选控制缺少实物验证；其他地区／型号仍未经验证。
- **范围：**用电量解析保留真实零值、排除无效读数，并将缺失日期留为空缺；七日总量需具备全部七天的读数。未实现持久用电历史或费用估算。文档报告了离线测试，但所审阅文件树／包目标未包含这些测试。
- **许可：**MIT 覆盖项目代码，并保留既有集成的署名。官方服务及第三方材料保留各自条款。这是依赖云端的非官方客户端，并非恢复 TCL 源码或固件；API 可独立于应用发生变化。

## 一手来源

1. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Docs/Investigation.md>
2. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/README.md>
3. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Docs/Releases/v0.1.6.md>
4. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Package.swift>
5. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Scripts/build-app.sh>
6. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Sources/TCLCore/ACControls.swift>
7. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Sources/TCLCore/CloudClient.swift>
8. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Sources/TCLCore/EnergyReport.swift>
9. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/Sources/TCLMenuBar/AppStore.swift>
10. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/LICENSE>
11. <https://github.com/umarz317/TCLimate/blob/2a33c2013dbf3f297238131ca9eb6e287b2beb67/THIRD_PARTY_NOTICES.md>
12. <https://github.com/nemesa/ha-tcl-home-unofficial-integration/blob/fdba4d7a0b8213f4f68a74b4ce0f932343802b6b/LICENSE>

## 同分区更多条目：应用

- [Browserbase 插件：将 Claude in Chrome 浏览器桥接转接到云端](https://awesomerea.org/zh/resources/browserbase-claude-chrome-bridge-case/index.md) · 案例
- [Visor：独立的 Ray-Ban Meta 眼镜客户端](https://awesomerea.org/zh/resources/visor-ray-ban-meta-client-case/index.md) · 案例
- [wine-uwp：在修改版 Wine 上运行打包的 Windows 商店应用](https://awesomerea.org/zh/resources/wine-uwp-store-apps-case/index.md) · 案例
- [RKD Telemetry Extractor：解读 Race-Keeper 赛道日录制数据](https://awesomerea.org/zh/resources/rkd-telemetry-extractor-case/index.md) · 案例
- [Elgato HDR：为 Elgato 4K X 的 10 位模式提供用户态采集通路](https://awesomerea.org/zh/resources/elgato-hdr-uvc-capture-case/index.md) · 案例
- [LGwebOS-menubar：LG webOS 电视的原生 macOS 遥控器](https://awesomerea.org/zh/resources/lgwebos-menubar-remote-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。