AwesomeREA.org

案例

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

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

使用条件与局限

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

关于此条目

类型
案例
类别
独立重建案例
关联
独立重建项目
目标
应用 · 协议

来源复核于

说明已依据一手来源复核；这不代表已运行验证、经过安全审计或确认兼容。

一手来源

  1. Docs/Investigation.md GitHub · umarz317/TCLimate · 修订 2a33c20
  2. README.md GitHub · umarz317/TCLimate · 修订 2a33c20
  3. Docs/Releases/v0.1.6.md GitHub · umarz317/TCLimate · 修订 2a33c20
  4. Package.swift GitHub · umarz317/TCLimate · 修订 2a33c20
  5. Scripts/build-app.sh GitHub · umarz317/TCLimate · 修订 2a33c20
  6. Sources/TCLCore/ACControls.swift GitHub · umarz317/TCLimate · 修订 2a33c20
  7. Sources/TCLCore/CloudClient.swift GitHub · umarz317/TCLimate · 修订 2a33c20
  8. Sources/TCLCore/EnergyReport.swift GitHub · umarz317/TCLimate · 修订 2a33c20
  9. Sources/TCLMenuBar/AppStore.swift GitHub · umarz317/TCLimate · 修订 2a33c20
  10. LICENSE GitHub · umarz317/TCLimate · 修订 2a33c20
  11. THIRD_PARTY_NOTICES.md GitHub · umarz317/TCLimate · 修订 2a33c20
  12. LICENSE GitHub · nemesa/ha-tcl-home-unofficial-integration · 修订 fdba4d7