lg-thinq

🧊 LG 智能家电一站式远程管家

LG 官方 API 驱动的家电控制工具,支持冰箱、洗衣机状态监控与温度调节,让技术用户命令行管理智能设备。

收藏
5.3k
安装
1.9k
版本
v1.0.0
CLS 安全性认证2026-05-07
点击查看完整报告 >

使用说明

核心用法

LG ThinQ Skill 是一款基于 Python 的命令行工具,通过调用 LG 官方 ThinQ Connect API,实现对 LG 智能家电的远程控制。用户需先从 LG 官网获取 Personal Access Token 并完成本地配置,即可通过简单的命令行指令管理支持 ThinQ 协议的冰箱、洗衣机、烘干机及空调等设备。

核心功能包括:实时查询设备运行状态(如冰箱温度、门状态、洗衣机剩余时间)、精确调节冰箱温区(0-6°C 冷藏,-24 至 -14°C 冷冻)、切换特殊模式(Express 快速制冷/冻、Eco 节能模式)以及控制空调温度和风速。所有脚本均封装在虚拟环境中,通过 thinq.py 主程序统一调用,支持设备别名简化操作。

显著优点

官方接口保障:底层采用 LG 官方提供的 thinqconnect Python SDK,通过 HTTPS 加密与云端通信,避免使用非官方逆向工程方案带来的封号风险。

完善的输入验证:对温度参数实施严格的范围限制(如冷冻室禁止设置高于 -14°C),对命令格式进行预校验,有效防止因误操作导致的设备故障。

轻量级架构:纯 CLI 设计,资源占用极低,适合集成到 Home Assistant、Cron 定时任务或其他自动化脚本中,满足极客用户的批量管理需求。

本地化配置:敏感凭证(Token)仅存储在用户主目录的隐藏配置文件中,不上传至任何第三方服务器,隐私可控。

潜在局限

功能覆盖不全:目前对 WashTower 洗衣机/烘干机的支持仅限于状态查看,无法远程启动或修改洗涤程序;空调控制功能虽已支持,但部分高端机型的特殊模式可能无法识别。

来源可信度限制:由个人开发者(kaiofreitas)维护,非 LG 官方项目,长期更新维护存在不确定性,且需用户自行承担使用第三方库的风险。

技术门槛:要求用户具备命令行操作基础,需手动申请 Token 并配置 Python 虚拟环境,对普通消费者不够友好。

适用人群

适合拥有 LG ThinQ 系列智能家电的技术爱好者、智能家居集成商以及习惯使用命令行效率工具的极客用户。特别适用于需要通过脚本实现自动化场景(如夜间自动切换冰箱节能模式、离家时检查所有家电状态)的进阶玩家。

使用风险

凭证泄露风险:Personal Access Token 拥有设备控制权限,若未妥善设置文件权限(建议 chmod 600)或被恶意软件窃取,可能导致家电被非法控制。

云服务依赖:所有指令需经由 LG 云端中转,网络中断或 LG 服务器维护时将无法本地局域网控制;同时需信任 thinqconnect 库不会滥用 Token 数据。

物理安全风险:raw 命令允许直接发送原始 JSON 指令,若构造不当可能触发设备异常状态(如压缩机频繁启停),建议普通用户避免使用此高级功能。

API 变更风险:LG 可能随时调整 ThinQ Connect API 接口规范,个人维护项目可能存在响应滞后,导致功能突然失效。

安全解读

核心用法

LG ThinQ Skill 通过官方 ThinQ Connect API 实现对 LG 智能家电的远程控制。用户需先在 LG 开发者平台 获取 Personal Access Token,并配置本地文件存储 token 和国家代码。

基础操作流:
1. 激活虚拟环境后,使用 thinq.py devices 列出绑定设备

2. 通过 status <device_id> 或别名(如 fridge、washer)查询实时状态

3. 执行具体控制指令,如 fridge-temp 3 设置冷藏室温度、express-freeze on 开启速冻模式

支持设备矩阵:

| 设备 | 监控能力 | 控制能力 |
|------|---------|---------|
| 智能冰箱 | 温度、门状态、运行模式 | 冷藏/冷冻温度、速冻、节能模式 |
| WashTower 洗衣机/干衣机 | 运行状态、剩余时间 | ⚠️ 有限支持 |
| 空调 | 温度、模式 | 温度、模式、风速 |

温度范围严格遵循官方规范:冷藏室 0-6°C,冷冻室 -24°C 至 -14°C。脚本内置错误码映射,可识别设备离线、命令格式错误、功能不支持等常见异常。

显著优点

  • 官方 SDK 接入:基于 LG 官方 thinqconnect 库,非逆向工程或第三方破解方案,API 稳定性与兼容性有保障
  • 极简配置模式:仅需两步文件写入即可完成认证,无需复杂 OAuth 流程或持久化服务
  • 自然语言友好:内置丰富的用户意图映射("check my fridge" → 状态查询,"set fridge to 5 degrees" → 温度设置)
  • 本地化安全架构:Token 存储于用户家目录 ~/.config/,符合 XDG 规范,支持文件权限精细化管控
  • 零外部数据泄露:网络通信仅限于 thinqconnect.lgthinq.com 官方域名,无遥测或广告追踪

潜在缺点与局限性

  • 地域限制明显:需指定国家代码(如 MX),部分功能可能因地区服务策略差异而受限
  • 设备覆盖不全:WashTower 洗烘套装目前仅支持状态监控,远程启停等高级控制暂未实现
  • 依赖外部服务可用性:LG 云服务中断或 API 变更将直接影响功能,无本地局域网 fallback 方案
  • 温度档位离散:仅支持整数温度设定,无法精细到 0.5°C 调节
  • 学习成本:非 LG 生态用户需额外注册开发者账号获取 PAT,相比消费级 App 门槛略高

适合人群

  • 已部署 LG 智能冰箱、WashTower、空调的深度用户
  • 追求自动化工作流的技术爱好者(可集成 Home Assistant、cron 定时任务)
  • 注重数据隐私、不愿将家电控制权完全托付给云端 App 的敏感型用户
  • 需要批量查询多设备状态的家庭 IT 管理员

常规风险

  • Token 泄露风险:PAT 文件若权限设置不当(建议 chmod 600)可能被同系统其他进程读取
  • API 速率限制:高频调用可能触发 LG 服务端限流,导致临时封禁
  • 固件兼容性:LG 设备固件更新可能变更状态字段,需关注技能版本更新
  • 配置单点故障:Token 过期或文件误删将导致全功能失效,建议备份或设置监控

lg-thinq 内容

scripts文件夹
手动下载zip · 4.3 kB
thinq.pytext/plain
请选择文件