← 返回下载页

HydroAgent macOS 安装帮助

适用于 Apple Silicon(M 系列)和 Intel Mac。

当前 macOS 发行包已完成 Apple Developer ID 签名与 notarization,从官方下载页正常安装后可直接打开。若你使用的是较早的内测包,或系统仍提示“无法验证开发者”“已损坏,无法打开”,请先确认应用来自 HydroAgent 官方下载页,再按下面的步骤处理。这不等同于应用文件一定损坏。

正常安装

  1. 根据 Mac 芯片选择下载包:Apple Silicon 选择“macOS (Apple Silicon)”,Intel 选择“macOS (Intel)”。
  2. 打开下载的 .dmg 文件。
  3. 将 HydroAgent 拖入 Applications 文件夹。
  4. 关闭磁盘映像,然后从“应用程序”文件夹启动 HydroAgent。

首次启动被拦截

方法一:右键打开

  1. 在“应用程序”文件夹中找到 HydroAgent。
  2. 按住 Control 键点击,或右键点击应用,选择“打开”。
  3. 在确认对话框中再次选择“打开”。

方法二:隐私与安全性

  1. 打开“系统设置 → 隐私与安全性”。
  2. 向下滚动到安全性区域,找到关于 HydroAgent 被阻止的提示。
  3. 点击“仍要打开”,然后按系统提示确认。

显示“已损坏,无法打开”

已签名并公证的发行包不应出现该提示。若出现,请先重新下载并确认应用已完整复制到“应用程序”文件夹。只有在确认来源可信、且上述方法仍无法启动时,才使用下面的高级处理方式:

xattr -dr com.apple.quarantine /Applications/HydroAgent.app

该命令只移除这个应用包的下载隔离标记,不会修复文件,也不会关闭整个 macOS 安全机制。不要对来源不明的应用执行此命令,也不要随意使用 sudo。

常见问题

Apple Silicon 和 Intel 应该下载哪个?

点击左上角 Apple 菜单 →“关于本机”。如果显示 Apple 芯片,下载 Apple Silicon;如果显示 Intel,下载 Intel。Intel 应用在 Apple Silicon 上可能需要 Rosetta 2。

应用已经拖入“应用程序”,仍然打不开怎么办?

请先退出并重新打开 Finder,确认启动的是“应用程序”中的副本,而不是 DMG 内的副本。仍失败时,重新下载对应架构的安装包,并检查磁盘剩余空间。

如何卸载?

退出 HydroAgent,将“应用程序”中的 HydroAgent 拖到废纸篓即可。应用数据不会自动删除;如需清理数据,请先备份,再删除用户目录中的 HydroAgent 数据目录。

需要反馈问题时

请提供 Mac 芯片类型、macOS 版本、下载的文件名,以及系统提示的完整文字。请不要发送 API Key、证书私钥或其他敏感信息。