10HomeAssistant 中如何使用脚本，用通俗的语言讲解

admin

关于 Home Assistant（简称 HA）中的“脚本 (Script)”，我将用最通俗的大白话为你解释，并手把手教你创建一个实用的“观影模式”脚本。

一、 通俗大白话：什么是脚本？

把 Home Assistant 想象成一个智能管家。

• 设备 (Device/Entity)： 是管家手里的工具，比如灯、电视、窗帘。

• 自动化 (Automation)： 是你给管家下的死命令，格式是“如果……就……”。（例如：如果如果你回家，就打开灯）。它是被动触发的。

• 脚本 (Script)： 是你教管家的一套组合拳或技能包。

  
  

通俗比喻：
脚本就是**“宏”或者“一键宏”。脚本**。

脚本和自动化的最大区别：

• 自动化：自己动。需要条件触发（比如几点了、人来了）。

• 脚本：听你指挥。平时待命，你（或者自动化）点它一下，它才跑一遍。

  
  

---

二、 2025.12.2 版本脚本创建保姆级教程

我们来制作一个经典的**“观影模式”**脚本。
目标效果： 点击一下，客厅的主灯关闭，灯带亮度调到 30%，并打开电视。

第一步：进入创建界面

• 打开 Home Assistant 网页或 APP。

• 点击左侧菜单栏的 配置 (Settings)。

• 选择 自动化与场景 (Automations & Scenes)。

• 在顶部标签栏，点击 脚本 (Scripts)。

• 点击右下角的 创建脚本 (Create Script) 按钮。

• 选择 创建新脚本 (Create new script)。

  
  

第二步：设置脚本基本信息

在顶部的编辑器中：

• 名称 (Name)：输入 观影模式。

• 图标 (Icon)：可以选一个电视的图标，比如 mdi:movie-open。

• 模式 (Mode)：保持默认的 单次 (Single) 即可。（意思是如果脚本正在跑，再点它没反应，防止重复执行冲突）。

  
  

第三步：添加“动作” (这是核心！)

脚本就是一连串的动作 (Actions)。在 2025.12 版本中，界面更加直观。

动作 1：关闭客厅主灯

• 点击 添加动作 (Add Action) 按钮。

• 在搜索框输入 关 或者 turn off。

• 注意：HA 2025 版本中，“调用服务”已更名为“执行动作”或直接选择设备。

• 最简单的方法：直接点击 设备 (Device)，然后在“设备”下拉框中找到你的 客厅主灯。

• 在“动作”区域，选择 关闭 (Turn off)。

  
  

动作 2：打开灯带并调暗（可选）

• 再次点击 添加动作 (Add Action)。

• 这次我们用“动作”查找：搜索 light.turn_on 或者中文 灯光: 开启。

• 点击 灯光: 开启 (Light: Turn on)。

• 点击 选择目标 (Choose entity)，勾选你的 客厅灯带。

• 在下方会出现详细参数，勾选 亮度 (Brightness)，拉动滑块到 30%。

• (可选) 勾选 颜色 (Color)，选择一个暖黄色或红色。

  
  

动作 3：打开电视

• 再次点击 添加动作 (Add Action)。

• 选择 设备 (Device) -> 找到 客厅电视。

• 动作选择 开启 (Turn on)。

  
  

第四步：保存与测试

• 点击右下角的 保存脚本 (Save Script) 按钮。

• 保存后，点击右上角的 三个点 图标，选择 运行 (Run)。

• 验证： 看看你家的灯是不是关了，电视是不是开了？如果是，恭喜你，脚本成功了！

  
  

---

三、 如何使用这个脚本？

脚本做好了，怎么用它呢？通常有两种用法：

用法 A：放到仪表盘（手动点）

• 回到你的 HA 首页 (概览)。

• 点击右上角笔形图标 编辑仪表盘。

• 点击右下角 添加卡片。

• 选择 按钮 (Button) 卡片。

• 在实体 (Entity) 里，搜索 script.guan_ying_mo_shi (就是你刚才建的脚本，通常是 script. 加上你起的名字拼音)。

• 点击保存。
  现在，你桌面上就有了一个开关，一点它，家里就进入观影模式。

  
  

用法 B：配合自动化（自动跑）
你可以创建一个自动化：

• 触发条件： 当 智能插座 检测到电视功率大于 50W 时（说明电视开了）。

• 执行动作： 选择 动作 (Action) -> 搜索 script.turn_on -> 选择 观影模式。
  这样，每次你用遥控器开电视，HA 就会自动帮你把灯调好。

  
  

四、 进阶小贴士 (针对 2025.12+ 版本)

• YAML 语法变化：如果你是进阶用户喜欢看代码，注意 2025 版本中，脚本底层的 YAML 键名推荐使用复数形式 actions:，虽然旧的 action: 还能用，但新标准是复数。

• 在此等待 (Wait)：如果你的电视开机很慢，可以在“开电视”动作后，加一个 等待时间 (Wait for time to pass) 动作，设置 5 秒，然后再加一个“关闭窗帘”的动作。这样脚本执行起来更有节奏感。

• 大模型辅助：2025.12 版本对 AI 集成更好。你可以把这个脚本暴露给 Assist（语音助手），然后对着手机说：“嘿，启动观影模式”，它就会运行这个脚本。

  
  

希望这个教程能帮你轻松搞定 Home Assistant 脚本！如有报错，请检查设备实体的名字是否选对。