∴ GitHub / 趋势仓库

mbillow / localthings

让 Home Assistant 通过本地网络控制三星家电,无需云端账号

语言
Python
Star
1.1k
Fork
115
当日新增(11-08)
+186
累计在榜
2 天
最高名次
第 12 名
首次上榜
2026-11-07
去 GitHub 查看 ↗

∴ 是什么

LocalThings 是一个 Home Assistant 自定义集成,用于通过家庭网络控制三星洗衣机、烘干机、冰箱、空调等支持 SmartThings 的家电。它使用 OCF 标准、CoAP over DTLS 协议与设备通信,并通过声明式设备映射将设备资源转换为 Home Assistant 实体。

∴ 解决什么问题

  • 消除对三星云服务器的依赖,实现本地控制
  • 避免家电数据发送到三星服务器
  • 解决部分旧家电无法通过本地接口控制的问题
  • 支持无网络或互联网受限环境下的家电控制

∴ 怎么上手

  1. 01在 HACS 中进入 Integrations,搜索 LocalThings 并下载;或手动复制 custom_components/localthings/ 到 Home Assistant 配置目录的 custom_components/ 文件夹
  2. 02重启 Home Assistant
  3. 03进入 Settings > Devices & Services > Add Integration > LocalThings
  4. 04输入家电的 IP 地址
  5. 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 名。

[object Object]2026-11-07 +1842026-11-08 +186
每日新增 Star · 2026-11-07 至 2026-11-08 · 共 2 个在榜日峰值 +186
日期名次当日新增总 Star
#12+1861,130
#12+184948