平台支持

Hermes Agent 维护对众多平台和分发方式的支持，但我们无法支持每一种可能的安装方式。

Tier 1 {#tier-1}

我们力求绝不让这些平台的安装和更新坏掉。Tier 1 的问题与回归是我们的第一优先级，优先于其他平台。

OS / 架构安装方式备注
macOS（Apple Silicon）Hermes Desktop、install.sh
Windows 10 / 11（x86_64、aarch64）install.ps1、MSIX 桌面版MSIX 包需要 Windows 11 22H2 或更高。可选依赖有架构限制。
Linux / WSL2（x86_64、aarch64）install.sh我们在最新 Ubuntu 和 WSL2 上测试。若你的发行版有 glibc、systemd 并遵循文件系统层级标准，它很可能跑得不错。
Docker 容器（x86_64、aarch64）docker pullDocker 安装不支持 hermes update。更新通过运行新镜像完成。

Tier 2 {#tier-2}

这些平台仅在树内尽力维护。发布可能弄坏它们，我们不能承诺弄坏后立即修复。

修复它们问题的 PR 会被接受，但优先级排在修复 Tier 1 平台问题之后。

OS / 架构安装方式备注
Nix（macOS、Linux、NixOS）Nix flake 和模块Nix 拥有运行时安装和更新。
Android / Termux（aarch64）签名 APT 仓库，然后 pkg install hermes-agent预发布包，含 Python、Node 和 TUI。在 Termux 会话中跑网关；Android 可能终止后台进程。

构建目标与支持优先级 {#build-targets-and-support-priority}

原生 bundle 管线同时包含 Intel macOS（x64）和 Apple Silicon。它还为两种架构定义了签名包更新验收。该覆盖不改变分配给 Apple Silicon 的 Tier 1 优先级。Hermes-Setup.dmg 引导安装器是例外：它仅为 Apple Silicon（arm64）构建，因此在 Intel Mac 上报告"not supported on this Mac"。Intel Mac 改用 darwin-x64 桌面 bundle，或安装 CLI 后跑 hermes desktop。Linux 桌面打包在发布工作流中被禁用，尽管本地 AppImage 构建和原生 Linux PM bundle 检查仍然存在。

不支持 {#unsupported}

这些平台和分发方式不受支持。我们建议你迁移到受支持的分发方式或平台。它们现在可能已坏，将来可能坏得更多。修复它们的 PR _不会_被接受，任何为它们保持兼容的代码都可能随时被移除。

  • 非 aarch64 设备上的 Android / Termux（aarch64 经我们的 APT 包受支持）
  • 经 AUR 安装（若对你有帮助我们可能上游补丁 <3）
  • 32 位 x86 macOS。Intel x86_64 有原生 bundle 构建和包更新验收通道；这不改变 Apple Silicon 的 Tier 1 优先级。
  • 经 pypi 安装（例如 uv tool install hermes-agent、pip install hermes-agent 等）
  • 经 brew 安装（brew install hermes-agent）

若你在用一种不受支持的分发方式，请读安装指南了解如何切换到受支持的方式。