Skip to content

.NET 10 · WINDOWS 10 / 11 · 支持简体中文

HASS.Agent .NET10

现代、轻量的 Home Assistant 联动 Windows 客户端:通知、媒体控制、传感器、指令和一键更新。

下载 快速入门(英文) GitHub

或 winget install v1k70rk4.HASSAgentNET10

功能一览

在 Home Assistant 中查看和控制 Windows 设备。客户端在托盘运行,也可通过安装 Windows 服务以处理无用户登录时也需要运行的功能。

  • 通知


    Home Assistant 的通知可以转发至 Windows 原生通知,也可显示在独立、始终可见的窗口中。支持图片、按钮和文字回复,回复将传回 Home Assistant。

  • 媒体播放


    设备上播放媒体的状态会同步到 Home Assistant 中。可控制设备播放、暂停、切歌、进度条、音量,可显示标题、封面。即使设备静音,也可临时调整音量使用户听到 TTS 语音播报。

  • 传感器


    拥有内置的系统状态传感器,也可添加自定义进程、服务、磁盘、脚本输出,以及外部 LibreHardwareMonitor 的数值。

  • 指令


    锁屏、睡眠、关机、重启,以及自定义按钮:程序、PowerShell 脚本、按键、链接。可接入自动化或仪表盘使用。

  • 仪表盘


    点击一下,Home Assistant 仪表盘就会显示在托盘上方的小窗口中。也可把任意页面显示在此独立窗口里,比如门铃响起时弹出摄像头画面。

  • 组合键


    设置一组按键并添加定义,它就会成为 Home Assistant 中的一个事件,用键盘即可触发任意自动化。

  • 在 Home Assistant 中更新


    更新实体可直接点击 安装 按钮。在设备安装系统服务后,点击 Home Assistant 中的安装按钮,客户端更新就会在后台静默完成,并且只运行带有发布者签名的安装包。

  • 安全


    设备与Home Assistant连接,无需管理员账号下的令牌:它使用自行创建的、非管理员的 Home Assistant 用户。客户端每个版本都经过签名,不含任何遥测。

支持简体中文

应用界面提供简体中文。在中文环境下的 Windows 会自动以中文启动,也可以在 常规 页面的 语言(language) 中手动指定。另外Home Assistant 中实体名称的语言也可以单独设置(HA集成使用的语言)。

HASS.Agent .NET10 的“常规设置”页面(简体中文)

简体中文的“常规”页面

三步完成安装

需要 Windows 11 或 Windows 10(2004 或更高版本,x64)、Home Assistant 2026.6 或更高版本,以及 MQTT 代理服务器 或 Home Assistant 的 WebSocket API。使用 API 则不需要代理服务器,在公网也可访问,例如通过 Nabu Casa。

  1. 集成。 在 Home Assistant 的 设置 中打开 Marketplace(2026.11 之前的 Home Assistant 中是 HACS),搜索 HASS.Agent 集成,下载并重启 Home Assistant。

    在 Home Assistant 的 Marketplace 中打开此集成。

  2. Windows 应用。 使用 winget 安装,或从发布页面下载已签名的安装包:

    winget install v1k70rk4.HASSAgentNET10
    

    应用常驻系统托盘,点击图标即可打开设置。

  3. 连接。 在 MQTT 页面填写代理服务器地址和登录信息,或者在 HA API 页面填写 Home Assistant 地址和长期访问令牌。使用 MQTT 时,电脑会自动出现在 Home Assistant 的 设备与服务 页面的已发现设备中。使用 HA API 时,第一台电脑需要通过添加集成来加入(HASS.Agent → HA API (WebSocket)),之后的设备则会被 Home Assistant 自动发现。

更多内容

详细文档为英文:

本应用免费、开源(MIT 许可证),与 Home Assistant 项目没有关联。