Hermes Desktop 保姆级安装指南 —— 桌面端、CLI、远程连接，一篇讲完
Desktop 版就是来解决这个的：原生界面，装好打开就能聊。而且它和 CLI 共用同一套配置、同一套 session、同一套技能——不是一个阉割版。
安装方式：两种入口
方式一：下载 Desktop 安装器（macOS/Windows，推荐）
从 hermes-agent.nousresearch.com/desktop 下载安装器，双击运行。安装器自动搞定 Python、Node.js、ffmpeg、ripgrep 等全部依赖，开箱即用。
装完后打开桌面应用，跟着 onboarding 流程走一遍：配 provider、选模型、说第一句话。
如果先装了 CLI 版本，后续想试试桌面端，直接运行：
hermes desktop
它会复用你已有的配置、API key、会话和技能。CLI 和 Desktop 的数据互通——你在桌面端开始的会话，可以在终端里继续；反过来也一样。
方式二：CLI 安装 + 启动桌面
如果你已经在用 hermes 命令行，不需要重新下载安装器。一条命令就能打开桌面：
hermes desktop
默认会自动安装依赖并构建桌面端。首次启动会花一两分钟构建 Electron 应用，之后秒开。
常用启动参数：
| 参数 | 作用 |
|---|---|
--cwd PATH | 设置初始项目目录 |
--skip-build | 跳过构建，直接启动（已有构建产物时） |
--force-build | 强制重新构建 |
--hermes-root /path/to/clone | 指向特定源码目录 |
桌面端里有什么
Chat — 主界面
流式输出，工具调用过程实时显示。支持拖拽文件到聊天区域上传。右侧预览栏可以边聊边看网页渲染、文件内容、工具输出。
会话历史与 CLI/TUI 完全同步——终端里开的 session，在桌面端可以继续聊。
File Browser
不需要离开应用就能浏览和预览工作目录的文件。用 hermes desktop --cwd <path> 或者设 HERMES_DESKTOP_CWD 环境变量来指定初始目录。
Voice
对着 Hermes 说话，它用语音回你。macOS 上系统会弹一次麦克风权限请求。
Settings & Onboarding
在界面里管理 provider、模型、工具、凭据——不再需要手写 YAML。首次启动的 onboarding 几分钟内走到第一句话。
管理面板
桌面端还集成了整套 Hermes 管理功能：
- Skills — 浏览、安装、管理技能
- Cron — 查看和管理定时任务
- Profiles — 切换不同配置/技能/会话的独立环境
- Messaging — 配置 Telegram、Discord 等消息通道
- Agents / Command Center — 多 agent 编排
远程连接：把 Desktop 连到远程服务器
默认 Desktop 启动本地后端。你也可以把它指向另一台机器上运行的 hermes dashboard——比如家里的 NAS 或者一台 Mini PC。
后端（远程机器上）
# 1. 设置登录凭据
cat >> ~/.hermes/.env <<'EOF'
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=admin
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=your-password-here
HERMES_DASHBOARD_BASIC_AUTH_SECRET=$(openssl rand -base64 32)
EOF
chmod 600 ~/.hermes/.env
# 2. 启动 Dashboard（监听非本地地址自动开启认证）
hermes dashboard --no-open --host 0.0.0.0 --port 9119
保持这个 hermes dashboard 进程持续运行（用 systemd、tmux 或你的进程管理器）。
桌面端连接
Settings → Gateway → Remote gateway：
- Remote URL 填
http://<远程IP>:9119 - 点击 Sign in，输入刚才设的用户名密码
- 保存并重连——会话立即切换到远程后端
也可以设环境变量 HERMES_DESKTOP_REMOTE_URL，启动时自动连远程。
⚠️ 用户名/密码方式适合局域网或 VPN 内使用。要暴露到公网，建议用 OAuth（Nous Portal）认证。
远程连接故障排查
| 问题 | 原因 | 解决 |
|---|---|---|
| 登录失败 401 | 用户名/密码不匹配 | 检查 .env 里的凭据，确认 HERMES_DASHBOARD_BASIC_AUTH_USERNAME 和 PASSWORD 都设了 |
| 没有 Sign in 按钮 | Basic auth provider 未激活 | 确认 .env 中同时设了 username 和 password，且 dashboard 进程重启过 |
| 每次重启被登出 | 未设签名密钥 | 加 HERMES_DASHBOARD_BASIC_AUTH_SECRET 到 .env |
| 连接超时 | Dashboard 绑了 127.0.0.1 | 绑定 0.0.0.0 或 Tailscale IP |
升级
Desktop 应用后台自动检查更新，有新版时一键升级。
手动升级也兼容：
# 如果在 CLI 安装的环境里
hermes update
日志与重置
启动日志在 ~/.hermes/logs/desktop.log：
hermes logs gui -f # 实时查看日志（类似 tail -f）
常用重置命令：
# 重置首次启动标记
rm "$HOME/.hermes/hermes-agent/.hermes-bootstrap-complete"
# 重建 Python 虚拟环境
rm -rf "$HOME/.hermes/hermes-agent/venv"
# 重置 macOS 麦克风权限
tccutil reset Microphone com.nousresearch.hermes
支持平台
macOS（Apple Silicon + Intel）、Windows、Linux。
macOS/Windows 建议用 Desktop 安装器，Linux 目前优先走 CLI 安装后 hermes desktop。
如果你还没试过 Hermes Desktop，这是最好的时机——不用再输出还是终端，桌面端是完整的产品界面。
📢 关注我，获取最新开源更新日志和开发者工具动态。
#HermesAgent #HermesDesktop #AI终端 #安装指南 #开源