Home Assistant app

Home Assistant App是开源智能家居控制平台Home Assistant的移动端访问控制App，用户在完成Home Assistant服务器的搭建后，即可通过Home Assistant App来实现跨品牌的高度整合能力与隐私优先的本地控制智能家居体验。也就是说Home Assistant App能够打破生态壁垒，将米家、苹果生态、HomeKit及各种DIY设备统一接入，同时，Home Assistant App不仅是控制中心，更是一个移动传感器集散地，能将手机的地理位置、电量、Wi-Fi状态等精确数据回传，用于触发如“到家前自动开启空调”等复杂的自动化场景。另外，对于安卓开发者或系统折腾玩家而言，Home Assistant App高度的开放性支持桌面小部件与快捷磁贴自定义，配合其简洁的Lovelace界面引擎，能够实现极具个人风格的仪表盘，有需要的用户可以在本站免费下载使用。

功能特色

【万物归一的控制中心】

它能打破生态壁垒，将米家、涂鸦、Apple HomeKit、Google Home甚至众多的 DIY 设备（如 ESPHome、WLED）整合进同一个面板。

【极致的自定义看板】

你可以利用 Lovelace 界面引擎，像搭积木一样设计你的控制面板，从实时气象雷达图到服务器运行状态，皆可一屏掌握。

【强大的传感器集成】

App 不仅能控物，还能将手机变成一个“超级传感器”。它能将手机的地理位置、电池状态、当前 Wi-Fi、甚至是步数实时回传给你的私人服务器，从而触发精细的自动化（例如：当你进入家附近 500 米且室温高于 26°C 时，自动开启空调）。

【隐私与安全】

所有数据优先在本地局域网传输，无需经过云端，极大地降低了隐私泄露风险并提升了响应速度。

Home Assistant搭建教程

一、方案推荐

Home Assistant搭建方式有很多，一般根据用户实际需求进行选择，比如用户需要让Home Assistant接入米家，建议按照以下优先级选择：

1、最推荐：HAOS (Home Assistant OS)

这是官方专门为跑 HA 设计的系统。无论你是用旧电脑（x86）、树莓派还是闲置的瘦客户机，直接刷入这个系统。

接入米家的优势：自带 Supervisor。你可以极其方便地安装 Samba（用于传输文件）和 SSH 插件，这是国内安装 HACS（第三方插件商店）并进而安装米家插件的“高速公路”。

适用人群：追求稳定、省事，且有独立硬件运行 HA 的用户。

2、次选：NAS 的 Docker 部署

如果你已经有群晖、威联通或极空间。

接入米家的挑战：纯 Docker 版 HA 没有 Supervisor 商店。

怎么接入：你需要手动下载 Xiaomi Miot Auto 的代码包，通过文件管理器放到 NAS 的 /config/custom_components 文件夹里，然后重启。虽然步骤多几步，但效果是一样的。

适用人群：不想额外买硬件，且具备一定文件管理和目录配置基础的用户。

二、核心步骤

不管你选哪种搭建方式，接入米家的逻辑都是一致的：

1、安装 HACS 商店

这是所有国内设备的“大门”

HACS 是 Home Assistant 的第三方应用市场。国内用户建议使用“一键安装脚本”，通过终端命令行快速部署，解决 GitHub 连接不稳定的问题。

2、搜索并下载 Xiaomi Miot Auto

目前最强的小米接入插件

在HACS中搜索 Xiaomi Miot Auto。这个插件由国内开发者维护，支持“集成模式”，可以自动同步你米家 App 里几乎所有的 Wi-Fi、蓝牙、Zigbee 设备。

3、登录小米账号

完成最后的同步

安装完成后，在 HA 的“配置”->“设备与服务”里添加集成，选择小米。输入你的米家账号密码，勾选你需要同步的设备，几秒钟后，你的小爱同学、传感器、灯具就会出现在 HA 面板上。

温馨提示：如果你的米家设备很多是 蓝牙/蓝牙 Mesh 协议（比如小米蓝牙温湿度计、部分新款灯泡），你需要确保运行 HA 的设备自带蓝牙，或者额外插一个兼容的蓝牙适配器，否则这些设备只能通过“云端”控制，反应会稍慢。

Home Assistant app使用教程

1、服务器环境搭建：

参考以上关于Home Assistant搭建教程

2、设备配对：

安装后打开App，它会自动扫描局域网内的服务器。输入账号密码登录后，你就能在手机上看到与网页端完全一致的 Lovelace 仪表盘，直接控制所有接入的灯光、窗帘和传感器。

3、启用移动传感器：

在 App 设置中开启“管理传感器”，手机的电量、地理位置、步数、当前 Wi-Fi 名等信息会实时上传。你可以以此设置自动化，例如“手机连接家里的 Wi-Fi 时，自动撤防安防模式”。

4、桌面增强：

利用安卓系统的特性，你可以将常用的开关添加为桌面小部件（Widgets），或者在下拉快捷设置栏中添加磁贴按钮，无需打开App即可一键控物。

5、通知提醒：

支持推送高优先级的通知，当家中出现漏水或门窗异动时，App 会第一时间发出警报，甚至可以配置带有动作按钮的通知（如：收到门铃通知时，直接在通知栏点按钮开门）。

兼容设备

Airthings、Amazon Alexa、Amcrest、Android TV、Apple HomeKit、Apple TV、ASUSWRT、August、Belink WeMo、蓝牙、Bose SoundTouch、Broadlink、BTHome、deCONZ、Denon、Devolo、DLNA、Ecobee、Ecovacs、Ecowitt、Elgato、EZVIZ、Fritz、Fully Kiosk、GoodWe、Google Assistant、Google Cast、Google Home、Google Nest、Govee、Growatt、Hikvision、Hive、Home Connect、Homematic、HomeWizard、Honeywell、iCloud、IFTTT、IKEA Tradfri、Insteon、Jellyfin、LG 智能电视、LIFX、Logitech Harmony、Lutron Caseta、Magic Home、Matter、MotionEye、MQTT、MusicCast、Nanoleaf、Netatmo、Nuki、OctoPrint、ONVIF、Opower、Overkiz、OwnTracks、Panasonic Viera、Philips Hue Pi-hole、Plex、Reolink、Ring、Roborock、Roku、三星电视、Sense、Sensiba、Shelly、SmartThings、SolarEdge、Sonarr、Sonos、索尼 Bravia、Spotify、Steam、SwitchBot、群晖、Tado、Tasmota、特斯拉墙、Thread、Tile、TP-Link 智能家居、涂鸦智能、UniFi、UPnP、Verisure、Vizio、Wallbox、WebRTC、WiZ、WLED、Xbox、小米蓝牙、Yale、Yeelight、YoLink、Z-Wave、Zigbee

更新日志

v2026.4.3版本

一、版本与工作流

1、更新周度发布的 changelog_master.xml（涉及版本 2026.3.3 至 2026.4.3）。

2、在 PR 工作流中仅将 strings.zip 作为 Artifact 存储并恢复其使用。

3、强制使用代码库中的 English translation 而非 Lokalise 翻译。

4、优化发布流程：创建 Draft release 后立即上传文件并发布。

二、依赖项升级

1、更新 androidx.compose:compose-bom、androidx.、com.android. 及 wear.compose 等 Android 核心组件。

2、升级 Gradle 至 v9.4.1 及其 Wrapper，同步更新 ktlint 和 typesafe-conventions 插件。

3、升级 codeql-action、setup-ruby、android-emulator-runner、download-artifact 及 action-gh-release 等 GitHub Actions。

4、升级 Sentry、Firebase、LiteRT、Protobuf、aboutlibraries、json、addressable 及 Kotlin 等第三方依赖库。

三、功能改进

1、Assist 优化：在 Assist 会话中支持 Wake word detection 并移除相关硬件限制；新增 OpenAssistSettings 支持；启用闲置 30 秒后自动关闭 Assist 功能；避免将 AssistVoiceInteractionSessionService 作为识别服务使用。

2、交互增强：引入 HapticFeedbackPerformer 为 FrontendScreen 和 WebViewActivity 提供触感支持；引入 HADropdownMenu 组件；在新前端界面添加通知权限提示。

3、反馈机制：针对 Matter/Thread 非正常结果显示带有故障排除链接的 Snackbar；修复 Bottom sheet 在显示时从折叠到展开状态的跳变问题；更新 Screenshot tests。

4、核心逻辑：ConnectionViewModel 正确支持 Opaque URI；使用 PermissionManager 处理 WebView 权限；配置 mTLS 时使用 OkHttp；在 Wear 磁贴中添加缺失的受支持域；过滤并非来自前端 External bus 的消息。

四、修复与性能

1、异步处理：将 HighAccuracyLocationReceiver 和 TileReceiver改为异步执行模式；使用 goAsync 调用 WebSocketManager.start。

2、资源优化：移除 Widgets 和 WebViewActivity 中不必要的 Main 线程占用；优化 ComplicationReceiver 中的协程使用，并从 GMS tasks 调用协程。

3、稳定性修复：修复 LocationTrackingViewModel 因 Room InvalidationTracker 导致的内存泄漏；修复 coil RemoteViewsTarget 的竞争条件并随后将其移除；限制相机 Bitmap 大小以防内存超限。

4、逻辑修正：修复日志视图中帮助图标无法打开链接的问题；修复实体图标中无效 mdi 导致的崩溃防护；仅在已注册时注销 actionReceiver；确保 Manifest URL 检查时使用 Base URL。

5、其他优化：使用 Broadcast 代替 startService 发送命令；捕获并处理 WebView 实例化时的错误；移除 SettingsActivity 中 runBlocking 的使用；将 Custom Component 表述替换为 Community Integration；针对 非 Automotive 版本跳过 car_ui 通知。