HomeAssistant中文版

《HomeAssistant》是开源智能家居平台Home Assistant的移动端访问控制工具，在完成服务器搭建后，可实现跨品牌设备的高度整合与隐私优先的本地控制智能家居体验。它能打破生态壁垒，并将手机的地理位置、电量等数据回传，触发复杂自动化场景。

Home Assistant软件功能

跨品牌设备整合：打破生态壁垒，统一接入米家、涂鸦、Apple HomeKit、Google Home及ESPHome、WLED等DIY设备。

极致自定义看板：利用Lovelace界面引擎，像搭积木一样设计控制面板，可集成实时气象雷达图、服务器状态等。

手机作为传感器：将地理位置、电池状态、Wi-Fi信息、步数等回传至服务器，触发精细化自动化。

隐私与安全：数据优先在本地局域网传输，无需经过云端，降低泄露风险，提升响应速度。

开放性与自定义：支持桌面小部件、快捷磁贴自定义，满足开发者与折腾玩家的个性化需求。

Home Assistant入门教程

一.什么是Home Assistant？

简言之，HA是一个平台，能打通不同品牌、同品牌不同阶段智能家居之间的壁垒。

二.如何安装Home Assistant？

首先，你需要一台24小时连续运行的设备作为智能家居中枢，常见的有NAS[1]、树莓派[2]等。

[1].网络存储器，常见品牌有群晖、铁威马、威联通等。

[2].英文名为Raspberry Pi，一种基于Linux系统的微星电脑，只有信用卡大小。

但也有替代方案，那就是将所有设备接入HA后，可以直接在米家App中进行自动化设置，因为此时NAS相当于家庭中枢，HA又已经绑定了米家账号，所以智能设备状态可以实时同步到米家，因此，在米家中进行自动化设置一样可以完成自动化操作，而且界面直观简洁。

三.Home Assistant使用心得

1.登录方式

HA有两种登录方式，一种是网页端登录，另一种是移动端App登录，但移动端登录有缺陷，只有当手机和NAS处于同一局域网时才能登录，也就是说，不在家时，无法实现外部访问和控制智能家居，这就违背了我安装HA的初衷，所以我选择网页端登录。

之所以网页端能实现外网登录，是因为我之前注册了域名，原本为了同步照片、视频时速度能快一些，没想到现在也派上了用场。安装完毕后，只需在浏览器地址栏输入：https://XXX:8123（XXX为域名）即可登录HA。

2.浏览器登录的缺点及优化

虽然实现了外部访问，但每次在浏览器中输入地址很麻烦，最重要的是，在外面和在家里输入的网址是不一样的，在家中需要输入局域网IP，而在外面，如上述所说，需要输入域名。折腾了几天后，我发现「快捷指令」可以很好的解决这个难题。

首先，让其获取当前手机的局域网名称（即wifi名称），如果当前名称与家里的wifi名称相同（图中第二步），说明我现在在家，就用局域网IP访问HA（我这里直接打开了以前的快捷指令，其实只要采用「打开url」指令，在url栏内填入HA的局域网IP即可），否则，执行图中第三步，即访问域名：https://XXX:8123（XXX为域名）。设置后，将快捷指令以小组件方式添加到主屏幕上，这样就能实现无论是否在家，点一下即可进入HA界面，比每次都在地址栏中输入网址方便得多。

Home Assistant手机版入门指南

系统

iOS 应用程序需要 iOS 15 或更高版本，这意味着支持的最旧设备是 iPhone 6s。

Android 应用程序有 2 种不同的风格full或minimal.两种版本都需要 Android 5.0 或更高版本。full版是通过 Play 商店提供的，需要 Google Play 服务才能正常运行。

您需要运行 Home Assistant 0.104.0 或更高版本。

移动应用程序需要在您的 Home Assistant 实例中启用以下集成configuration.yaml：

default_config:

如果由于某种原因您已禁用default_config: 请确保您configuration.yaml至少包含：

mobile_app:

对于某些功能，还需要启用以下集成：

cloud:用于通过远程 UI 和云 webhooks 通过 Nabu Casa 订阅安全地连接到您的 Home Assistant

ios:如果您需要高级通知（例如可操作的通知和类别），则使用iOS系统

如果您的 Home Assistant 实例已正确设置为远程访问，您应该能够从任何位置设置配套应用程序。

如果您与 Home Assistant 连接到同一网络，则在设置过程中会自动检测到它。

1、下载安装好 Home Assistant Companion App 。

2、当您第一次打开应用程序时，系统将引导您完成连接到 Home Assistant 实例的过程。请按照步骤操作。

系统会要求您授予将手机与 Home Assistant 集成所需的权限。

请求的权限之一是位置访问。

如果此权限被拒绝，那么您将无法获得为该设备创建的实体device_tracker或任何实体sensor。

3、完成第一个屏幕后，选择继续。

该应用程序将开始检查您的网络中是否有 Home Assistant 实例。

如果找到实例，请点击该实例并按照提示连接并登录您的 Home Assistant。

如果您未连接到与 Home Assistant 实例相同的本地网络，请点击手动输入地址，然后输入用于远程连接到 Home Assistant 实例的地址（建议但不要求使用Home Assistant 云远程 UI）。

4、连接并登录 Home Assistant 实例后，系统会要求您授予应用程序与您的 iOS 设备配合使用的权限，而不仅仅是对 Home Assistant 实例进行基本浏览。

您无需授予这些权限即可使用该应用程序。

但是，它们在您的设备和家庭助理之间提供了更大程度的集成。

请求的权限如下：

位置：允许您的设备向 Home Assistant 提供位置，device_tracker将创建一个可在 Home Assistant 内的自动化和条件中使用的实体。如上所述，由于 iOS 13 中的更改，在登录 Home Assistant 之前需要请求此权限。对于 Android，当您首次登录时，会在登录过程中请求此权限。如果此权限被拒绝device_tracker，sensor则不会创建实体。

运动和计步器： iOS系统允许家庭助理从您的 iOS 设备访问计步器数据，这将创建传感器来记录今天的步数、上升和下降的楼层、今天行走的距离以及当前的活动。它不提供对健康应用程序中保存的数据或设备运动芯片中基本运动数据之外的任何其他数据的任何访问。

通知：允许家庭助理将通知发送到您的设备。除了普通通知外，家庭助理还可以发送重要通知；这些用于高优先级消息，即使设备处于静音模式，也会始终播放声音（iOS系统）。系统将要求您授予这两种通知类型的许可。检查以了解 Android 设备当前支持的内容。您可能需要在登录后重新启动 Home Assistant 才能注册通知操作。

5、一旦您授予或拒绝权限，该应用程序将创建与您的 Home Assistant 实例所需的连接，然后将您带到 Home Assistant 主屏幕。

根据应用程序版本，您可能会在设置结束和进入主屏幕之间看到“新增功能”屏幕。

当您看到主屏幕时，安装就完成了。

注意：

请记住使用您的凭据登录，并且不要使用受信任的网络（如果您启用了该功能），否则该应用程序将仅在受信任的网络上运行。

Home Assistant兼容设备

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 通知。