lg-thinq

核心用法

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 接口规范，个人维护项目可能存在响应滞后，导致功能突然失效。