∴ GitHub / 趋势仓库
mbillow / localthings
让 Home Assistant 通过本地网络控制三星家电,无需云端账号
- 语言
- Python
- Star
- 1.1k
- Fork
- 115
- 当日新增(11-08)
- +186
- 累计在榜
- 2 天
- 最高名次
- 第 12 名
- 首次上榜
- 2026-11-07
∴ 是什么
LocalThings 是一个 Home Assistant 自定义集成,用于通过家庭网络控制三星洗衣机、烘干机、冰箱、空调等支持 SmartThings 的家电。它使用 OCF 标准、CoAP over DTLS 协议与设备通信,并通过声明式设备映射将设备资源转换为 Home Assistant 实体。
∴ 解决什么问题
- 消除对三星云服务器的依赖,实现本地控制
- 避免家电数据发送到三星服务器
- 解决部分旧家电无法通过本地接口控制的问题
- 支持无网络或互联网受限环境下的家电控制
∴ 怎么上手
- 01在 HACS 中进入 Integrations,搜索 LocalThings 并下载;或手动复制 custom_components/localthings/ 到 Home Assistant 配置目录的 custom_components/ 文件夹
- 02重启 Home Assistant
- 03进入 Settings > Devices & Services > Add Integration > LocalThings
- 04输入家电的 IP 地址
- 05LocalThings 连接并读取设备类型和型号,自动添加一个 Home Assistant 设备
∴ 适合谁
适合使用 Home Assistant 且拥有 2022 年左右及以后的三星家电用户,以及部分支持旧版本地接口的早期机型用户。
∴ 要点
- 支持多种家电类型:空调、洗衣机、烘干机、冰箱、烤箱、微波炉等
- 更新快:支持推送的家电实时更新,其他每 30 秒检查一次
- 完全本地:设置完成后不联系三星服务器,数据不出家庭网络
- 使用 OCF 和 CoAP over DTLS 开放标准,基于 smartthings-local 库实现协议层
- 支持 DHCP 发现,自动跟踪家电 IP 地址变化
- 提供诊断报告功能,帮助维护者添加新型号支持
许可证 MITcoap-protocolcoap-servercustom-componentdtlshacshacs-integrationhome-assistanthome-automationsamsungsmartthings
解读由 AI 依据项目 README 生成,生成于 2026-11-07,以 GitHub 原文为准。
∴ 在榜记录
GitHub Trending 今日榜的每日存档,日期按北京时间。2026-11-07 首次上榜,累计在榜 2 天,最高第 12 名。