网站首页 收藏本站
广告位联系

APP正在开发中...
返回顶部
您的位置： 主页 > Ai >

收藏
分享到

Hermes Desktop极简安装教程

Ai 来源：互联网 作者：佚名 发布时间：2026-07-02 22:12:18 人浏览
摘要

Hermes Desktop 初体验：极简安装指南 Hermes Desktop 是 Hermes Agent 的桌面客户端和终端里用的hermes是同一个 agent术语解释Agent具备自主性、能调用工具以完成目标的 AI 程序。Agent 是一种基于大语言模

Hermes Desktop 初体验：极简安装指南

Hermes Desktop 是 Hermes Agent 的桌面客户端——和终端里用的 hermes 是同一个 agent术语解释Agent具备自主性、能调用工具以完成目标的 AI 程序。Agent 是一种基于大语言模型的智能程序，能够感知环境、做出决策、调用工具执行操作，并自主推进任务。，共享配置、API Key、会话、技能和记忆。你在终端开的会话，桌面端能接着聊；桌面端的设置，终端也能看到。

支持 Windows、macOS、Linux 三大平台。本文以 Windows 原生安装为例。

前置条件

在安装 Desktop 之前，需要先完成 Hermes CLI 的安装（详见《Hermes CLI Windows 安装与模型配置指南》）：

项目 要求
Hermes CLI 已安装，hermes --version 正常输出
Node.js ≥ 18（CLI 安装时已自动配备）
模型配置 已配置至少一个模型提供商（DeepSeek / MiMo 等）

第一步：设置国内镜像下载

安装前先设置环境变量，让 Electron 直接从国内镜像下载，绕过 GitHub：

1

2

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"

$env:CSC_IDENTITY_AUTO_DISCOVERY = "false"
环境变量 作用
ELECTRON_MIRROR 指定 Electron 国内镜像地址（npmmirror），约 114MB 从此下载
CSC_IDENTITY_AUTO_DISCOVERY 设为 false 跳过 Windows 代码签名（个人使用无需签名）

???? 建议写入 PowerShell profile 永久生效，以后每次打开终端自动生效：

1

2

Add-Content $PROFILE "`$env:ELECTRON_MIRROR = 'https://npmmirror.com/mirrors/electron/'"

Add-Content $PROFILE "`$env:CSC_IDENTITY_AUTO_DISCOVERY = 'false'"

第二步：构建桌面应用

设置好镜像后，直接运行：

1

hermes desktop --force-build

如果之前安装失败过，加 --force-build 强制重新构建，会清除缓存重新下载。首次安装也建议加上此参数。

构建过程的四个步骤

步骤 操作 预期耗时 说明
1 安装 npm 依赖 约 1 分钟 安装 1295+ 个 npm 包
2 构建前端（Vite） 约 20 秒 打包 React 界面，生成 dist/
3 下载 Electron 二进制 约 1-3 分钟 约 114MB，从国内镜像下载
4 electron-builder 打包 约 1 分钟 生成 Hermes.exe 可执行文件

全部完成后，桌面应用会自动启动。

构建产物路径

桌面应用构建完成后，可执行文件位于：

1

%LOCALAPPDATA%\hermes\hermes-agent\apps\desktop\release\win-unpacked\Hermes.exe

目录中包含 Electron 外壳、依赖库（DLL）、资源文件等，总共约 204 MB（其中 Hermes.exe 本身约 200+ MB）。

启动桌面应用

方式一：从 CLI 启动

1

hermes desktop

如果已经构建过，后续启动不需要 --force-build，直接运行即可。

方式二：双击桌面快捷方式（推荐）

创建桌面快捷方式，以后双击即开：

1

2

3

4

5

6

7

8

$hermesExe = "$env:LOCALAPPDATA\hermes\hermes-agent\apps\desktop\release\win-unpacked\Hermes.exe"

$desktopPath = [Environment]::GetFolderPath("Desktop")

$wsh = New-Object -ComObject WScript.Shell

$shortcut = $wsh.CreateShortcut("$desktopPath\Hermes Desktop.lnk")

$shortcut.TargetPath = $hermesExe

$shortcut.WorkingDirectory = "$env:LOCALAPPDATA\hermes\hermes-agent\apps\desktop\release\win-unpacked"

$shortcut.Description = "Hermes Agent 桌面客户端"

$shortcut.Save()

快捷方式创建后，也可以右键 →「固定到任务栏」，以后一键打开。

方式三：开始菜单启动

运行上面的快捷方式创建命令后，开始菜单中也会出现 Hermes Desktop，直接搜索即可。

常见问题排查

问题 解决方案
构建卡在 “Build desktop app” 设置 ELECTRON_MIRROR 后 --force-build 重建
报错 “ENOENT rename electron → Hermes” 清除 Electron 缓存 + 半成品，重新构建
构建成功后白屏 重置 .hermes-bootstrap-complete，或重建 venv
桌面端与 CLI 配置不一致 运行 hermes doctor 检查配置状态
npm install 很慢 切换 npm 镜像源到 npmmirror
如何更新 hermes update + hermes desktop
如何卸载 hermes uninstall --gui

Q1: 构建卡在 “Build desktop app” 步骤

原因：Electron 二进制下载被 GitHub 网络限制。

解决：确保已设置 ELECTRON_MIRROR，然后强制重建：

1

2

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"

hermes desktop --force-build

Q2: 报错 “ENOENT … rename ‘…/win-unpacked/electron’ -> ‘…/win-unpacked/Hermes’”

原因：之前下载的 Electron zip 文件损坏，解压后缺少二进制文件。

解决：清除缓存后重建：

1

2

3

4

5

6

7

# 清除 Electron 下载缓存

Remove-Item "$env:LOCALAPPDATA\electron\Cache\electron-*.zip" -Force -ErrorAction SilentlyContinue

# 清除半成品构建

Remove-Item "$env:LOCALAPPDATA\hermes\hermes-agent\apps\desktop\release\*unpacked" -Recurse -Force -ErrorAction SilentlyContinue

# 重新构建

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"

hermes desktop --force-build

Q3: 构建成功但启动后白屏

原因：通常是首次启动引导状态异常，或 Python 虚拟环境损坏。

解决：

1

2

3

4

5

6

7

# 第一步：查看桌面应用日志，定位具体错误

hermes logs gui -f

# 第二步：重置首次启动状态

Remove-Item "$env:LOCALAPPDATA\hermes\hermes-agent\.hermes-bootstrap-complete" -Force -ErrorAction SilentlyContinue

# 第三步：如果日志报 Python 相关错误，重建虚拟环境

Remove-Item "$env:LOCALAPPDATA\hermes\hermes-agent\venv" -Recurse -Force -ErrorAction SilentlyContinue

hermes desktop --force-build

Q4: 桌面端与 CLI 配置不一致

原因：Desktop 和 CLI 共享 %LOCALAPPDATA%\hermes\ 下的同一套配置。如果配置在 Desktop 构建后被修改过，可能出现不一致。

解决：

1

2

hermes doctor          # 检查当前配置状态

hermes config check    # 检查缺失配置项

然后在桌面端 Settings 中检查模型选择是否与 CLI 一致。

Q5: npm install 很慢

原因：npm 默认从 registry.npmjs.org 下载，国内访问较慢。

解决：切换 npm 镜像源：

1

npm config set registry https://registry.npmmirror.com

Q6: 如何更新 Desktop

1

2

hermes update              # 更新 CLI 和核心代码到最新版

hermes desktop             # 重新构建桌面应用（自动检测新版本）

Q7: 如何卸载 Desktop

1

hermes uninstall --gui     # 移除 GUI 构建产物和 node_modules

如果需要完全移除 Hermes（包括 CLI）：

1

Remove-Item "$env:LOCALAPPDATA\hermes" -Recurse -Force

从源码开发模式运行（可选）

如果你需要修改桌面应用本身，可以从源码启动开发服务器：

1

2

3

4

# 进入桌面应用目录

cd "$env:LOCALAPPDATA\hermes\hermes-agent\apps\desktop"

# 启动开发模式（Vite 热更新 + Electron 实时预览）

npm run dev

开发模式下代码修改会自动热更新，适合调试和定制界面。

让你的 Agent 自动完成配置

如果你电脑上已经有其他 Agent术语解释Agent具备自主性、能调用工具以完成目标的 AI 程序。Agent 是一种基于大语言模型的智能程序，能够感知环境、做出决策、调用工具执行操作，并自主推进任务。 了（如 Claude Code、Trae、Cursor、Qoder 等），可以让它按照本文档的步骤自动帮你构建 Desktop。

方式一（最简单）：把本文档的文件路径或链接发给你的 Agent，让它自己阅读并执行。

方式二（更精准，推荐）：直接把下面这段话复制给你的 Agent：

1

2

3

4

5

6

7

8

9

请根据这篇 Hermes Desktop 安装指南帮我完成桌面应用的构建和配置：

文档路径：D:\笔记\Agent工具搭建\Hermes Desktop 桌面应用安装指南.md

需要完成的内容：

1. 设置 ELECTRON_MIRROR 国内镜像环境变量

2. 运行 hermes desktop --force-build 构建桌面应用

3. 创建桌面快捷方式

4. 验证构建产物是否存在（release\win-unpacked\Hermes.exe）

5. 启动桌面应用

注意：构建过程中 Electron 二进制约 114MB，从 npmmirror 国内镜像下载。

???? 如果你的 Agent 支持 MCP术语解释MCPModel Context Protocol，Anthropic 提出的开放标准，用于将 AI 应用连接到外部数据源与工具。，也可以先接入 Hermes 中文文档 MCP Server（https://mcp.hermesagent.org.cn/v1），让 Agent 直接检索最新文档来指导构建。

快速参考：完整 TL;DR

1

2

3

4

5

6

7

8

9

10

11

12

13

# 1. 设置国内镜像

$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"

$env:CSC_IDENTITY_AUTO_DISCOVERY = "false"

# 2. 构建桌面应用

hermes desktop --force-build

# 3. 创建桌面快捷方式

$hermesExe = "$env:LOCALAPPDATA\hermes\hermes-agent\apps\desktop\release\win-unpacked\Hermes.exe"

$wsh = New-Object -ComObject WScript.Shell

$shortcut = $wsh.CreateShortcut("$([Environment]::GetFolderPath('Desktop'))\Hermes Desktop.lnk")

$shortcut.TargetPath = $hermesExe

$shortcut.Save()

# 4. 启动（双击桌面图标，或在终端运行）

hermes desktop

版权声明 : 本文内容来源于互联网或用户自行发布贡献，该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权， 违法违规的内容， 请发送邮件至2530232025#qq.cn(#换@)举报，一经查实，本站将立刻删除。

您可能感兴趣的文章 :

原文链接 :
相关文章
推荐阅读
最新更新
友情链接
  • 本站所有内容来源于互联网或用户自行发布，本站仅提供信息存储空间服务，不拥有版权，不承担法律责任。如有侵犯您的权益，请您联系站长处理！
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计