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> 或别名(如 fridgewasher)查询实时状态

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
请选择文件