HASS.Agent自动化脚本：如何结合Quick Actions和传感器实现智能场景联动

【免费下载链接】HASS.Agent Windows-based client for Home Assistant. Provides notifications, quick actions, commands, sensors and more. 项目地址: https://gitcode.com/gh_mirrors/ha/HASS.Agent

HASS.Agent是一款基于Windows的Home Assistant客户端，提供通知、快速操作、命令和传感器等功能，通过它可以轻松实现Windows设备与智能家居系统的联动。本文将详细介绍如何利用HASS.Agent的Quick Actions和传感器功能，打造个性化的智能场景自动化脚本，让你的家庭更智能、更便捷。

一、认识HASS.Agent的核心功能模块

HASS.Agent作为连接Windows设备与Home Assistant的桥梁，主要通过两大核心功能实现智能联动：传感器系统和快速操作（Quick Actions）。

1.1 传感器系统：实时监控设备状态

传感器是HASS.Agent的"感知器官"，能够实时采集Windows设备的各种状态信息并同步到Home Assistant。通过SensorsManager.cs可以看到，系统支持丰富的传感器类型，包括：

• 硬件监控：CPU负载、内存使用率、GPU温度等
• 系统状态：最后活动时间、登录用户、网络状态等
• 设备状态：摄像头活动、麦克风使用、电池电量等

HASS.Agent传感器配置界面，显示已添加的传感器列表及其实时数值

传感器数据通过MQTT协议定期发送到Home Assistant，默认每30秒更新一次基础信息，关键状态（如摄像头活动）则实时推送，为自动化场景提供精准的触发条件。

1.2 Quick Actions：一键执行智能指令

Quick Actions是HASS.Agent的"执行器官"，允许用户创建一键式操作，直接控制Home Assistant中的实体。在QuickAction.cs中定义了其核心属性：

• Domain：操作所属领域（如Light、Switch、Climate等）
• Entity：目标实体ID
• Action：执行动作（如On、Off、Toggle等）
• HotKey：可选的键盘快捷键

新建Quick Action界面，可选择操作领域、目标实体和执行动作

通过组合不同的Domain和Action，用户可以创建控制灯光、调节温度、启动场景等各种快捷操作，这些操作不仅可以通过界面点击执行，还能绑定到键盘快捷键或通过Home Assistant自动化调用。

二、从0到1配置传感器与Quick Actions

2.1 配置传感器：捕捉设备状态

添加传感器的步骤非常简单，在HASS.Agent主界面点击"Sensors"进入配置页面：

1. 点击"Add new"按钮打开传感器类型选择窗口
2. 从左侧列表选择需要的传感器类型（如CPU Load、Webcam Active等）
3. 在右侧设置传感器名称、更新频率等参数
4. 点击"Store sensor"保存并激活

新建传感器界面，可选择多种传感器类型并配置更新频率

以"Webcam Active"传感器为例，配置后它会实时检测摄像头是否被使用，并将状态（On/Off）发送到Home Assistant，这可以作为安防自动化的重要触发条件。

2.2 创建Quick Actions：定义智能操作

创建Quick Action同样直观，在主界面点击"Quick Actions"进入配置：

1. 点击"Add new"按钮打开新建窗口
2. 选择领域（Domain），如"Light"
3. 选择目标实体（Entity），如"hallway-light"
4. 选择动作（Action），如"On"
5. 可选：设置描述和快捷键
6. 点击"Store quick action"保存

命令配置界面，显示已创建的各类Quick Actions

建议为常用操作设置快捷键，例如将"客厅灯开关"绑定到Ctrl+Alt+L，实现一键控制。创建完成的Quick Actions会显示在主界面的快捷面板上，方便随时手动触发。

三、3个实用智能场景联动案例

3.1 离开自动关窗：基于用户活动状态

场景描述：当检测到用户离开电脑（LastActive传感器超过5分钟无活动），自动关闭房间窗户。

实现步骤：

1. 配置传感器：添加"LastActive"传感器，设置更新频率为10秒
2. 创建Quick Action：添加控制窗户的Quick Action，Domain选择"Cover"，Entity选择"room_window"，Action选择"Close"
3. 在Home Assistant中设置自动化：
   • 触发条件：LastActive传感器数值大于300秒
   • 执行动作：调用HASS.Agent的Quick Action关闭窗户

3.2 会议模式自动静音：基于摄像头活动

场景描述：当摄像头启动（WebcamActive传感器状态为On）时，自动开启麦克风静音并关闭房间灯光。

实现步骤：

1. 配置传感器：添加"WebcamActive"和"MicrophoneActive"传感器
2. 创建Quick Actions：
   • 麦克风静音：Domain选择"MediaPlayer"，Action选择"VolumeMute"
   • 关闭灯光：Domain选择"Light"，Entity选择"room_light"，Action选择"Off"
3. 在Home Assistant中设置自动化：
   • 触发条件：WebcamActive传感器状态变为On
   • 执行动作：依次调用麦克风静音和关闭灯光的Quick Actions

3.3 低电量自动提醒：基于电池状态

场景描述：当笔记本电脑电池电量低于20%（Battery传感器数值≤20），自动发送通知到手机并开启省电模式。

实现步骤：

1. 配置传感器：添加"Battery"传感器，设置更新频率为30秒
2. 创建Quick Action：添加启动省电模式的Quick Action，可通过调用系统命令实现
3. 在Home Assistant中设置自动化：
   • 触发条件：Battery传感器数值≤20
   • 执行动作：发送通知到手机并调用省电模式Quick Action

四、高级技巧：自定义传感器与脚本扩展

对于进阶用户，HASS.Agent支持通过Powershell和WMI查询创建自定义传感器，实现更复杂的状态监控。例如，通过Powershell脚本监控特定应用程序的运行状态：

# 检查Teams是否在运行的Powershell传感器脚本
if (Get-Process -Name "Teams" -ErrorAction SilentlyContinue) { "Running" } else { "Stopped" }

将此脚本添加为Powershell类型传感器，即可在Home Assistant中获取Teams的运行状态，进而创建"当Teams运行时自动开启会议模式"的高级自动化。

五、总结：打造无缝的智能生活体验

通过HASS.Agent的传感器和Quick Actions功能，我们可以将Windows设备完全融入智能家居生态系统，实现从状态感知到自动执行的完整闭环。无论是简单的一键控制，还是复杂的多条件自动化，HASS.Agent都能提供灵活而强大的支持。

开始尝试吧！根据自己的生活习惯配置个性化的智能场景，让科技真正服务于生活，创造更舒适、更高效的居住环境。

【免费下载链接】HASS.Agent Windows-based client for Home Assistant. Provides notifications, quick actions, commands, sensors and more. 项目地址: https://gitcode.com/gh_mirrors/ha/HASS.Agent