Home Assistant 上手指南：晚上到家，玄关灯为什么会自己亮

Home Assistant 上手指南：晚上到家，玄关灯为什么会自己亮

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

你刚推开家门，玄关灯已经亮起来了，没碰遥控器、也没掏手机。这正是 Home Assistant 想帮你做到的事：把散落各品牌的智能设备收进同一个系统，让它们认得你的家、听得出变化，然后自己干活。下面沿着"到家开灯"这一个瞬间，走完它背后的 5 个关卡。

第1关 连得上：给 Home Assistant 添第一个集成

这一关解决"设备怎么被系统看见"。Home Assistant 通过集成（integration）和具体品牌或协议对话，官方已覆盖一千多个品牌。打开设置 > 设备和集成，页面顶部的"已发现"会列出局域网里自动探测到的设备，直接点"添加"即可；没被发现的，点右下角"添加集成"，输入品牌名，按向导填好凭据。

官方教程用的是不需要硬件的 Workday 集成，跟着 source/getting-started/integration.markdown 走一遍最稳。所有品牌的配置手册都在 source/_integrations/ 目录，比如 source/_integrations/mqtt.markdown 就讲清了 MQTT 这类消息队列协议怎么接传感器。

第2关 认得它：分清"设备"和"实体"

这一关解决"系统里每个东西叫什么名"。集成接好后，硬件会被抽象成两层：设备是实物，实体是设备上的一件件"能干的事"。一只人体传感器进来，会带出三个实体：是否有人移动、温度、照度，各自带独立状态。

实体是系统里最小的数据单元，有唯一 ID（如light.entrance）、当前状态和属性。你后面写的规则、摆的卡片，操作的全是实体，不是设备本身。

第3关 听得出：状态一变，就是信号

这一关解决"系统怎么知道家发生了变化"。每次实体状态更新，Home Assistant 都会把它记下来并广播出去——手机 App 报回位置、MQTT 主题上来一条新报文，最终都落成某个实体的状态变更。

light/entrance/state → {"state": "on"}

这行示意 MQTT 设备用主题发状态报文，Home Assistant 收到后更新对应实体。对自动化来说，"有人从 not_home 变成 home"就是一个值得响应的信号，位置检测的搭法见 source/getting-started/presence-detection.markdown。概念词典（集成/设备/实体/区域/自动化）都在 source/getting-started/concepts-terminology.markdown。

第4关 自己会做：把"当……则……"写成自动化

这一关解决"谁来把信号变成动作"。自动化就是三段式：当（触发器）+ 若（条件，可选）+ 则（动作）。在设置 > 自动化和场景里点"创建自动化"，全程图形化，不用写代码。

"到家开灯"写成 YAML 大致长这样——触发器盯人的位置实体，条件限定是晚上，动作打开玄关灯：

alias: 晚上到家开玄关灯 trigger: - trigger: state entity_id: person.you to: "home" condition: - condition: time after: "19:00:00" action: - action: light.turn_on target: entity_id: light.entrance

保存后整条链就通了：App 报位置 → 实体状态变 home → 自动化命中条件 → 集成把指令发给灯泡 → 实体状态更新为 on → 仪表盘卡片跟着刷新。官方教程还演示了日落触发、按"区域"批量开灯等玩法，见 source/getting-started/automation.markdown。

第5关 看得见：把结果摆上仪表盘

这一关解决"你每天看的那块屏幕"。仪表盘由视图（页签）和卡片组成，卡片显示实体状态，还能直接点按控制。新设备被添加后，默认 Overview 仪表盘会自动给它生成卡片，天气卡、家人位置卡也会在初始化后出现。

想动手排版时，先新建一个仪表盘再编辑，方法在 source/getting-started/onboarding_dashboard.markdown。卡片种类（实体、场景、历史曲线等）在 source/_dashboards/ 里都有对应说明。

常见误区

• 把设备当实体用。规则里填的是实体 ID（light.entrance），不是设备名；一台设备拆出的多个实体要分开引用。
• 以为自动化必须写代码。图形编辑器能覆盖日常场景，YAML 只是它的另一种写法，新手先别碰。
• 直接编辑默认 Overview 仪表盘。一旦点了"接管"，它就不再自动为新设备加卡片，而且无法撤销——要么不动它，要么自己新建一个。

动手小任务

三步内可验证：

1. 在设置 > 设备和集成添加 Workday 集成，选一个国家，提交。
2. 点进该集成，找到它的"是否工作日"实体，记下当前状态。
3. 在设置 > 自动化和场景新建一条：触发器选"固定时间"（定在几分钟后），动作选"灯开"，保存后到点看它自动执行。

速览对照

你要做的事	去哪儿改	一句话作用
接入新品牌设备	设置 > 设备和集成	让系统多认识一种"语言"
查设备能干什么	点进集成看实体列表	一行就是一个可操作实体
写"当……则……"规则	设置 > 自动化和场景	触发器 + 条件 + 动作三段
改每天看的界面	仪表盘编辑模式	实体状态上墙、可点按
查某品牌接入方法	source/_integrations/	每个 .markdown 是一份品牌手册

一句话记住核心

接入靠集成，状态挂在实体上，变化驱动自动化，仪表盘负责呈现——四句话就是 Home Assistant 的全部骨架。

想深入，把官方文档仓库拉到本地，git clone https://gitcode.com/GitHub_Trending/ho/home-assistant.io，从 source/getting-started/concepts-terminology.markdown 开始读，每个概念都有原文对照。

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io