Hermes Desktop極簡安裝教程
我要評論Hermes Desktop 初體驗(yàn)：極簡安裝指南
Hermes Desktop 是 Hermes Agent 的桌面客戶端——和終端里用的 hermes 是同一個 agent術(shù)語解釋Agent具備自主性、能調(diào)用工具以完成目標(biāo)的 AI 程序。Agent 是一種基于大語言模型的智能程序，能夠感知環(huán)境、做出決策、調(diào)用工具執(zhí)行操作，并自主推進(jìn)任務(wù)。，共享配置、API Key、會話、技能和記憶。你在終端開的會話，桌面端能接著聊；桌面端的設(shè)置，終端也能看到。
支持 Windows、macOS、Linux 三大平臺。本文以 Windows 原生安裝為例。
前置條件
在安裝 Desktop 之前，需要先完成 Hermes CLI 的安裝（詳見《Hermes CLI Windows 安裝與模型配置指南》）：
| 項(xiàng)目 | 要求 |
|---|---|
| Hermes CLI | 已安裝，hermes --version 正常輸出 |
| Node.js | ≥ 18（CLI 安裝時已自動配備） |
| 模型配置 | 已配置至少一個模型提供商（DeepSeek / MiMo 等） |
第一步：設(shè)置國內(nèi)鏡像下載
安裝前先設(shè)置環(huán)境變量，讓 Electron 直接從國內(nèi)鏡像下載，繞過 GitHub：
$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/" $env:CSC_IDENTITY_AUTO_DISCOVERY = "false"
| 環(huán)境變量 | 作用 |
|---|---|
ELECTRON_MIRROR | 指定 Electron 國內(nèi)鏡像地址（npmmirror），約 114MB 從此下載 |
CSC_IDENTITY_AUTO_DISCOVERY | 設(shè)為 false 跳過 Windows 代碼簽名（個人使用無需簽名） |
?? 建議寫入 PowerShell profile 永久生效，以后每次打開終端自動生效：
Add-Content $PROFILE "`$env:ELECTRON_MIRROR = 'https://npmmirror.com/mirrors/electron/'" Add-Content $PROFILE "`$env:CSC_IDENTITY_AUTO_DISCOVERY = 'false'"
第二步：構(gòu)建桌面應(yīng)用
設(shè)置好鏡像后，直接運(yùn)行：
hermes desktop --force-build
如果之前安裝失敗過，加
--force-build強(qiáng)制重新構(gòu)建，會清除緩存重新下載。首次安裝也建議加上此參數(shù)。
構(gòu)建過程的四個步驟
| 步驟 | 操作 | 預(yù)期耗時 | 說明 |
|---|---|---|---|
| 1 | 安裝 npm 依賴 | 約 1 分鐘 | 安裝 1295+ 個 npm 包 |
| 2 | 構(gòu)建前端（Vite） | 約 20 秒 | 打包 React 界面，生成 dist/ |
| 3 | 下載 Electron 二進(jìn)制 | 約 1-3 分鐘 | 約 114MB，從國內(nèi)鏡像下載 |
| 4 | electron-builder 打包 | 約 1 分鐘 | 生成 Hermes.exe 可執(zhí)行文件 |
全部完成后，桌面應(yīng)用會自動啟動。
構(gòu)建產(chǎn)物路徑
桌面應(yīng)用構(gòu)建完成后，可執(zhí)行文件位于：
%LOCALAPPDATA%\hermes\hermes-agent\apps\desktop\release\win-unpacked\Hermes.exe
目錄中包含 Electron 外殼、依賴庫（DLL）、資源文件等，總共約 204 MB（其中 Hermes.exe 本身約 200+ MB）。
啟動桌面應(yīng)用
方式一：從 CLI 啟動
hermes desktop
如果已經(jīng)構(gòu)建過，后續(xù)啟動不需要 --force-build，直接運(yùn)行即可。
方式二：雙擊桌面快捷方式（推薦）
創(chuàng)建桌面快捷方式，以后雙擊即開：
$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()
快捷方式創(chuàng)建后，也可以右鍵 →「固定到任務(wù)欄」，以后一鍵打開。
方式三：開始菜單啟動
運(yùn)行上面的快捷方式創(chuàng)建命令后，開始菜單中也會出現(xiàn) Hermes Desktop，直接搜索即可。
常見問題排查
| 問題 | 解決方案 |
|---|---|
| 構(gòu)建卡在 “Build desktop app” | 設(shè)置 ELECTRON_MIRROR 后 --force-build 重建 |
| 報錯 “ENOENT rename electron → Hermes” | 清除 Electron 緩存 + 半成品，重新構(gòu)建 |
| 構(gòu)建成功后白屏 | 重置 .hermes-bootstrap-complete，或重建 venv |
| 桌面端與 CLI 配置不一致 | 運(yùn)行 hermes doctor 檢查配置狀態(tài) |
| npm install 很慢 | 切換 npm 鏡像源到 npmmirror |
| 如何更新 | hermes update + hermes desktop |
| 如何卸載 | hermes uninstall --gui |
Q1: 構(gòu)建卡在 “Build desktop app” 步驟
原因：Electron 二進(jìn)制下載被 GitHub 網(wǎng)絡(luò)限制。
解決：確保已設(shè)置 ELECTRON_MIRROR，然后強(qiáng)制重建：
$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/" hermes desktop --force-build
Q2: 報錯 “ENOENT … rename ‘…/win-unpacked/electron’ -> ‘…/win-unpacked/Hermes’”
原因：之前下載的 Electron zip 文件損壞，解壓后缺少二進(jìn)制文件。
解決：清除緩存后重建：
# 清除 Electron 下載緩存 Remove-Item "$env:LOCALAPPDATA\electron\Cache\electron-*.zip" -Force -ErrorAction SilentlyContinue # 清除半成品構(gòu)建 Remove-Item "$env:LOCALAPPDATA\hermes\hermes-agent\apps\desktop\release\*unpacked" -Recurse -Force -ErrorAction SilentlyContinue # 重新構(gòu)建 $env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/" hermes desktop --force-build
Q3: 構(gòu)建成功但啟動后白屏
原因：通常是首次啟動引導(dǎo)狀態(tài)異常，或 Python 虛擬環(huán)境損壞。
解決：
# 第一步：查看桌面應(yīng)用日志，定位具體錯誤 hermes logs gui -f # 第二步：重置首次啟動狀態(tài) Remove-Item "$env:LOCALAPPDATA\hermes\hermes-agent\.hermes-bootstrap-complete" -Force -ErrorAction SilentlyContinue # 第三步：如果日志報 Python 相關(guān)錯誤，重建虛擬環(huán)境 Remove-Item "$env:LOCALAPPDATA\hermes\hermes-agent\venv" -Recurse -Force -ErrorAction SilentlyContinue hermes desktop --force-build
Q4: 桌面端與 CLI 配置不一致
原因：Desktop 和 CLI 共享 %LOCALAPPDATA%\hermes\ 下的同一套配置。如果配置在 Desktop 構(gòu)建后被修改過，可能出現(xiàn)不一致。
解決：
hermes doctor # 檢查當(dāng)前配置狀態(tài) hermes config check # 檢查缺失配置項(xiàng)
然后在桌面端 Settings 中檢查模型選擇是否與 CLI 一致。
Q5: npm install 很慢
原因：npm 默認(rèn)從 registry.npmjs.org 下載，國內(nèi)訪問較慢。
解決：切換 npm 鏡像源：
npm config set registry https://registry.npmmirror.com
Q6: 如何更新 Desktop
hermes update # 更新 CLI 和核心代碼到最新版 hermes desktop # 重新構(gòu)建桌面應(yīng)用（自動檢測新版本）
Q7: 如何卸載 Desktop
hermes uninstall --gui # 移除 GUI 構(gòu)建產(chǎn)物和 node_modules
如果需要完全移除 Hermes（包括 CLI）：
Remove-Item "$env:LOCALAPPDATA\hermes" -Recurse -Force
從源碼開發(fā)模式運(yùn)行（可選）
如果你需要修改桌面應(yīng)用本身，可以從源碼啟動開發(fā)服務(wù)器：
# 進(jìn)入桌面應(yīng)用目錄 cd "$env:LOCALAPPDATA\hermes\hermes-agent\apps\desktop" # 啟動開發(fā)模式（Vite 熱更新 + Electron 實(shí)時預(yù)覽） npm run dev
開發(fā)模式下代碼修改會自動熱更新，適合調(diào)試和定制界面。
讓你的 Agent 自動完成配置
如果你電腦上已經(jīng)有其他 Agent術(shù)語解釋Agent具備自主性、能調(diào)用工具以完成目標(biāo)的 AI 程序。Agent 是一種基于大語言模型的智能程序，能夠感知環(huán)境、做出決策、調(diào)用工具執(zhí)行操作，并自主推進(jìn)任務(wù)。 了（如 Claude Code、Trae、Cursor、Qoder 等），可以讓它按照本文檔的步驟自動幫你構(gòu)建 Desktop。
方式一（最簡單）：把本文檔的文件路徑或鏈接發(fā)給你的 Agent，讓它自己閱讀并執(zhí)行。
方式二（更精準(zhǔn)，推薦）：直接把下面這段話復(fù)制給你的 Agent：
請根據(jù)這篇 Hermes Desktop 安裝指南幫我完成桌面應(yīng)用的構(gòu)建和配置： 文檔路徑：D:\筆記\Agent工具搭建\Hermes Desktop 桌面應(yīng)用安裝指南.md 需要完成的內(nèi)容： 1. 設(shè)置 ELECTRON_MIRROR 國內(nèi)鏡像環(huán)境變量 2. 運(yùn)行 hermes desktop --force-build 構(gòu)建桌面應(yīng)用 3. 創(chuàng)建桌面快捷方式 4. 驗(yàn)證構(gòu)建產(chǎn)物是否存在（release\win-unpacked\Hermes.exe） 5. 啟動桌面應(yīng)用 注意：構(gòu)建過程中 Electron 二進(jìn)制約 114MB，從 npmmirror 國內(nèi)鏡像下載。
?? 如果你的 Agent 支持 MCP術(shù)語解釋MCPModel Context Protocol，Anthropic 提出的開放標(biāo)準(zhǔn)，用于將 AI 應(yīng)用連接到外部數(shù)據(jù)源與工具。，也可以先接入 Hermes 中文文檔 MCP Server（
https://mcp.hermesagent.org.cn/v1），讓 Agent 直接檢索最新文檔來指導(dǎo)構(gòu)建。
快速參考：完整 TL;DR
# 1. 設(shè)置國內(nèi)鏡像
$env:ELECTRON_MIRROR = "https://npmmirror.com/mirrors/electron/"
$env:CSC_IDENTITY_AUTO_DISCOVERY = "false"
# 2. 構(gòu)建桌面應(yīng)用
hermes desktop --force-build
# 3. 創(chuàng)建桌面快捷方式
$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. 啟動（雙擊桌面圖標(biāo)，或在終端運(yùn)行）
hermes desktop參考與延伸閱讀
Hermes Agent 桌面版安裝部署完全指南：一步步安裝自進(jìn)化Agent智能體
Windows本地部署Hermes Agent實(shí)錄
到此這篇關(guān)于Hermes Desktop極簡安裝教程的文章就介紹到這了,更多相關(guān)Hermes Desktop安裝內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！
相關(guān)文章
Hermes Agent 桌面版安裝部署完全指南：一步步安裝自進(jìn)化Agent智能體
Hermes Agent 是由 Nous Research 開發(fā)的開源自主 AI 智能體（MIT 協(xié)議），這篇文章給大家介紹Hermes Agent 桌面版安裝部署完全指南：一步步安裝自進(jìn)化Agent智能體，感興趣2026-07-02
Ollama 一條推文直接炸了 AI 圈 ——Ollama 0.21 版本原生支持 Hermes Agent，這次 Ollama 直接把門檻砍到了地板上，真一行命令一鍵完成，零基礎(chǔ)小白也能 5 分鐘擁有自己的2026-06-25
Hermes Agent 是當(dāng)前最前沿的開源 AI 智能體框架之一,這篇文章主要介紹了Hermes從裸版到AI Agent天花板配置的相關(guān)資料,文中通過圖文以及代碼介紹的非常詳細(xì),需要的朋友可以2026-06-25
Docker部署Hermes Agent的踩坑與最佳實(shí)踐
本文基于 M5 MacBook Air 32G 上使用 Colima 運(yùn)行 Docker 虛擬機(jī)的實(shí)戰(zhàn)經(jīng)驗(yàn)，介紹如何在 Docker 中部署 Hermes Agent，解決數(shù)據(jù)持久化、權(quán)限隔離、工具環(huán)境保留等關(guān)鍵問題2026-06-24
Hermes Agent代碼倉庫打包工具repomix-rs的使用指南
repomix-rs 是一款將整個代碼庫打包為 AI 友好單文件的工具,它能同時適用于 Hermes Agent、Claude、ChatGPT、Gemini 等主流大模型應(yīng)用場景,下面小編就和大家詳細(xì)講講具體如2026-06-15
最近在開源 Agent 圈里，Hermes Agent 的名字反復(fù)出現(xiàn)在各種討論中,有人戲稱它為愛馬仕 Agent，這篇文章將從零開始部署 Hermes Agent 并接入飛書的完整過程做一個系統(tǒng)梳理2026-06-14
Hermes Agent接入QQ的超詳細(xì)實(shí)戰(zhàn)指南
Hermes Agent 可通過 QQ Bot 官方接口接入，實(shí)現(xiàn)一個具備記憶、工具調(diào)用與自動執(zhí)行能力的智能 QQ 機(jī)器人,通過 Gateway 轉(zhuǎn)換消息協(xié)議，將 QQ 消息接入 Agent 與大模型處理，2026-06-11
Windows本地部署Hermes Agent實(shí)錄
文章瀏覽閱讀856次，點(diǎn)贊13次，收藏4次。Windows本地部署Hermes Agent最新實(shí)錄，附WSL+Python部署路線詳細(xì)步驟，Docker路線待嘗試_wsl安裝hermes2026-06-05
Hermes Agent響應(yīng)速度從15秒到2.6秒的優(yōu)化實(shí)戰(zhàn)
如果你在用 Hermes Agent（由Nous Research開發(fā)的開源 AI 智能體），尤其是在飛書、Telegram 等平臺通過Gateway 模式使用，很可能遇到過這個問題：發(fā)一條消息，等 10-15 秒2026-06-04
Hermes Agent 4 大核心模塊 + 3 種開箱即用配置(最新收藏版)
Hermes Agent 是由 Nous Research 開發(fā)的開源自主 AI Agent 框架，核心理念為“The agent that grows with you”（一個會隨著使用不斷成長的 Agent），本文從快速配置、核2026-06-01
