Hermes Desktop 桌面版：安装、切换中文界面和国内网络注意点

Hermes Desktop 是什么

Hermes Desktop 是官方的原生桌面应用，从 v0.16（2026 年 6 月）开始提供。它不是另起炉灶的轻量版，而是和命令行、消息网关共用同一个 agent：同一份配置、同一套 API Key、同一批会话、技能和记忆。在桌面版里开的会话，回到命令行能接着聊，反过来也一样。

它支持 macOS（仅 Apple Silicon）、Windows 和 Linux。在 macOS 和 Windows 上，官方推荐的安装方式就是下载桌面版安装包，它会把命令行一起装好。

两种装法

还没装过 Hermes 的新用户，到官网的桌面版页面下载安装包，按提示装完即可。第一次启动会带你完成模型配置，几步就能发出第一条消息。

已经装了命令行的用户，直接运行：

hermes desktop

它会沿用你现有的配置、Key、会话和技能。第一次运行要安装 Node 依赖并构建当前系统的桌面应用，需要等几分钟；Linux 上还需要先装好 g++（Debian/Ubuntu 装 build-essential 即可）。只想构建、暂时不打开，可以加 --build-only；想让聊天会话默认在某个项目目录里工作，可以加 --cwd <路径>。

切换成中文界面

桌面版默认是英文界面，在设置的外观（Appearance）里可以切换界面语言，v0.21.5 带了英文、简体中文、繁体中文、日语、德语、法语、西班牙语、俄语和阿拉伯语。选择会保存在 config.yaml 的 display.language 里，简体中文对应的值是 zh。简体中文翻译由宝玉（JimLiu）贡献，覆盖聊天窗口、侧边栏、设置、命令中心、定时任务和消息平台等所有界面。

国内网络下的几个注意点

• 构建桌面版要下载 Electron，默认从 GitHub 下载；下载失败时会自动改用国内的 npmmirror 镜像。想指定别的镜像，设置 ELECTRON_MIRROR 环境变量。
• 应用在后台检查更新时访问的是 GitHub API。匿名访问每个出口 IP 每小时只有 60 次，公司网络、代理或 VPN 共用出口时容易报 rate limit，国内访问 GitHub 也可能不稳。可以在启动应用的环境里设置 GITHUB_TOKEN，或者先用 gh auth login 登录 GitHub CLI，应用会自动用它的登录。
• 模型 Provider 选国内的就不需要梯子。桌面版设置里的 Providers 页列出的是 hermes model 知道的全部 Provider，MiniMax、Kimi 记得选带 China 的国内站选项，详见国内安装与使用。

桌面版里有什么

• 聊天：流式显示 agent 调用工具的过程，右侧预览栏可以并排看网页、文件和工具输出，文件可以直接拖进对话，长对话有时间线可以跳转。
• 文件浏览器和 Artifacts：跟着 agent 看它读写了哪些文件，生成的图片、文件和链接集中在一个画廊里。
• 内置终端、语音（听写、朗读回复、唤醒词）、定时任务、profile 和技能管理。
• 设置：在界面里管理 Provider、模型、工具、MCP 服务器和消息网关，不用手改 YAML。
• 底部状态栏：上下文用量、当前模型、审批状态等。注意每个会话都有一个 YOLO 开关，打开后会跳过危险命令审批，别随手开。

更新和卸载

应用会在后台检查更新，有新版时提示一键更新；命令行的 hermes update 照样可用。

卸载在设置的 About → Danger zone 里，分三档：只卸载桌面版、保留 agent 和数据（等同 hermes uninstall --gui）；卸载桌面版和 agent、保留配置和聊天记录（等同 hermes uninstall）；全部删除（等同 hermes uninstall --full）。

什么时候用桌面版，什么时候用命令行

• 桌面版：日常对话、想看清 agent 每一步在做什么、在界面里管理配置，或者给不熟悉终端的同事用。
• 命令行：服务器、脚本、定时任务和 SSH 远程场景。
• 网页控制台 hermes dashboard：在浏览器里管理，适合远程服务器。

三者共用同一份状态，可以在一个里开始、在另一个里接着做。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。