hermes-desktop-applisted

# Hermes Desktop App (安装/启动/更新/排障) Hermes 桌面版 = 官方图形界面 App（用户可能叫它 "Hermes Studio"、"桌面版"、"GUI"）。它不是独立产品——与 CLI/gateway 共用同一套 config、API keys、sessions、skills、memory。装好 CLI 的机器不需要另外下载安装包，直接 `hermes desktop` 即可（首次运行自动装 Node 依赖并构建 Electron App���。 ## When to Use - 用户要求"装 Hermes Studio / 桌面版 / 图形界面版" - 桌面版打不开、更新、或者要固定入口（Dock/启动台） ## 本机关键路径（macOS, arm64） - 构建产物: `~/.hermes/hermes-agent/apps/desktop/release/mac-arm64/Hermes.app` - 正式安装位: `/Applications/Hermes.app`（已装 v0.17.0，2026-08-18） - 旧安装器备份: `/Applications/Hermes-old-installer.app`（6 月遗留的 v0.0.1 壳子，可删） - 启动命令: `hermes desktop`（构建+启动）/ `hermes desktop --skip-build`（跳过构建直接启动已有产物） ## 安装/启动步骤 1. 先确认 CLI 版本支持桌面版: `hermes desktop --help`（v0.20.0 起内置） 2. 检查是否已构建过: `ls ~/.hermes/hermes-agent/apps/desktop/release/mac-arm64/` - 已有构建产物 → 用 `--skip-build` 启动，别重复构建（构建要下载 Electron，慢） - 没有 → 跑 `hermes desktop`（无参数，自动构建） 3. 启动用后台进程: `hermes desktop --skip-build`（terminal background=true），等 30-60s 4. 装进 /Applications 供双击: ``` mv /Applications/Hermes.app /Applications/Hermes-old-installer.app # 旧壳子先备份，只移不删 cp -R ~/.hermes/hermes-agent/apps/desktop/release/mac-arm64/Hermes.app /Applications/Hermes.app ``` ⚠️ 6 月遗留的 /Applications/Hermes.app 可能只是安装器壳子（Info.plist 版本 0.0.1，MacOS/ 里是 Hermes-Setup），不是真 App——必须用 release 构建产物替换。 5. 验证: `open -a /Applications/Hermes.app` + `pgrep -fl "Hermes.app/Contents/MacOS/Hermes$"` + osascript 查进程名 ## 更新 - 终端跑 `hermes desktop`（无 --skip-build）→ 自动重装最新版 - 或 `hermes desktop --build-only`（只