必须安装HASS.Agent使Windows PC成为Home Assistant可信节点：下载安装客户端，配置HA地址与Long-Lived Token，启用通知、快捷键及PC传感器功能，最后通过门磁触发通知验证联动生效。
要在Windows系统上连接智能家居网关并实现设备联动控制，必须先让PC成为Home Assistant生态中的可信节点，而非仅靠浏览器临时访问。HASS.Agent是目前唯一能将Windows桌面深度接入Home Assistant中枢的官方推荐客户端，它不依赖远程网页，而是以本地服务形式运行，直接响应通知、触发自动化、同步传感器数据。
确认Home Assistant中枢已就绪
确保你的Home Assistant已部署完成且可稳定访问：打开浏览器，输入http://your-ha-ip:8123（例如http://192.168.1.50:8123），能正常加载UI界面；在「设置 → 系统 → 信息」中确认「安装类型」为Home Assistant OS、Supervised或Container——【Home Assistant Core（纯Python安装）不支持HASS.Agent自动发现】；若使用Docker部署，请确保容器网络模式为host或已映射8123端口。
在Windows上安装并配置HASS.Agent
前往HASS.Agent GitHub Releases页面，下载最新版HASS.Agent-x.x.x-win-x64-installer.exe；双击运行安装程序，全程点击“下一步”，安装路径建议保留默认（如C:\Program Files\HASS.Agent）；安装完成后勾选“启动HASS.Agent”，点击完成。
首次启动会弹出配置向导：在「Home Assistant URL」栏输入完整地址，包括协议与端口（如http://192.168.1.50:8123）；点击「获取Long-Lived Access Token」→跳转至Home Assistant网页→登录后进入「用户 → 个人令牌 → 创建令牌」→命名（如HASS-Agent-PC）→勾选全部权限→生成→复制该Token粘贴回HASS.Agent配置框；点击「测试连接」，状态显示绿色“Connected”即成功。
这一步操作起来很简单，直接把文件拖进去就行。但注意：如果Home Assistant启用了SSL（即地址为https开头），必须在HASS.Agent配置中勾选「启用HTTPS验证」，否则连接将失败且无明确报错提示。
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。
启用关键功能实现联动控制
方法一：开启桌面智能通知
在HASS.Agent主界面点击「通知」标签页→开启「启用通知」开关→勾选「允许通知」→点击右下角「预留端口」按钮（自动注册Windows通知通道）→返回Home Assistant，在「设置 → 系统 → 集成」中找到HASS.Agent，点击右侧「配置」→开启「通知」→保存。此后，任意自动化触发的notify.windows服务调用，都会在Windows右下角弹出原生通知。
方法二：配置快捷键快速控制设备
点击HASS.Agent主界面「快速操作」标签页→点击「添加操作」→选择设备（如living_room_light）→设定动作（如toggle）→指定快捷键（默认Ctrl+Alt+Q呼上面板，再按数字键选择）；【快捷键必须在HASS.Agent窗口未被最小化时才有效，若设为全局热键需额外启用「始终在最前」选项】。
方法三：启用PC传感器供Home Assistant联动
点击「传感器」标签页→勾选需要同步的项（如CPU使用率、磁盘剩余空间、电池电量）→点击「应用」；回到Home Assistant，这些传感器将自动出现在sensor.pc_*实体下；你可在「自动化」中设置条件，例如「当sensor.pc_disk_c_free低于10GB时，关闭所有非必要智能插座」。
验证网关级联动是否生效
第一步：在Home Assistant中创建一个测试自动化，触发条件设为「设备触发」→选择任意已配对的Zigbee网关子设备（如Aqara门磁）→动作设为「调用服务」→服务选notify.windows→消息填“门已打开”。
第二步：物理开合该门磁，观察Windows桌面右下角是否弹出通知。
第三步：打开HASS.Agent日志窗口（主界面右上角「查看日志」），确认输出中包含Received event: state_changed及Notifying Windows字样。
第四步：若前三步均成功，说明Windows PC已作为联动执行端正式接入网关生态，后续所有基于Home Assistant的设备联动均可通过此PC参与执行。
