# 策展 · X (Twitter) 🔥🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Nous Research (@NousResearch) · 平台：X (Twitter) · 日期：2026-06-01

> 原始來源：https://x.com/NousResearch/status/2061236625925886252

## 中文摘要

Hermes Agent 支援 Windows 原生環境。

**核心安裝方式**
Hermes Agent 針對 Windows 10 與 Windows 11 提供了原生的執行支援，使用者可透過以下兩種方式進行安裝：

- **PowerShell 快速安裝**：開啟 PowerShell 或 Windows Terminal，執行以下指令即可完成安裝，無需管理員權限：
  `iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)`
  安裝程式會將檔案部署至 `%LOCALAPPDATA%\hermes\` 並自動更新使用者的 PATH 環境變數。

- **桌面版安裝程式**：若偏好圖形化介面，可下載 Hermes Desktop 安裝檔。首次執行時，該程式會在背景呼叫 `install.ps1`，自動配置 Python (透過 uv)、Node.js 與 PortableGit 等必要依賴。

**依賴套件自動化配置**
Hermes 透過 `hermes_cli/dep_ensure.py` 進行依賴項的懶加載（Lazy Loading）管理，確保環境完整性。在 Windows 上，系統會自動處理以下關鍵組件：
- **PortableGit**：提供終端機所需的 `bash.exe` 及 Session 內的 Git 操作。
- **Node.js 22**：支援 Agent 瀏覽器工具、TUI 網頁橋接及 WhatsApp 橋接功能。
- **ffmpeg**：處理語音轉文字（TTS）或語音訊息的格式轉換。
- **ripgrep**：提供高效能檔案搜尋（若未偵測到則會降級使用 `grep`）。

**安裝流程細節**
安裝程式會依序執行以下步驟：
1. 部署 `uv`（Astral 的 Python 管理工具）至 `%USERPROFILE%\.local\bin`。
2. 透過 `uv` 安裝 Python 3.11。
3. 安裝 Node.js 22 與 PortableGit。
4. 將專案複製至 `%LOCALAPPDATA%\hermes\hermes-agent` 並建立虛擬環境。
5. 執行分層的 `uv pip install` 安裝必要套件。
6. 自動安裝並設定 `.env` 檔案中的訊息傳遞 SDK。
7. 設定 `HERMES_GIT_BASH_PATH` 環境變數。
8. 將 `%LOCALAPPDATA%\hermes\bin` 加入 User PATH。
9. 執行 `hermes setup` 完成初始化。

**功能相容性與技術調整**
除了儀表板中的嵌入式終端視窗外，Hermes 的所有功能均已實現 Windows 原生化。針對 Windows 特有的環境限制，開發團隊進行了以下技術處理：
- **字元編碼**：透過 `hermes_cli/stdio.py` 中的 `configure_windows_stdio()` 函式，將主控台代碼頁強制設為 `CP_UTF8` (65001)，確保 Unicode 內容（如橫槓指令、工具列表、Rich 面板）能正確顯示。
- **編輯器整合**：預設編輯器為 `notepad`，若使用者自訂編輯器為 VS Code，必須加上 `--wait` 旗標，否則編輯器會立即返回，導致 Hermes 接收到空白緩衝區。
- **背景執行**：執行 `hermes gateway install` 時，系統會透過排程工作（Scheduled Tasks）並以 `pythonw.exe` 啟動，確保閘道器在背景執行時不受 `CTRL_C_EVENT` 中斷影響。

**資料管理與移除**
Hermes 的資料結構明確，安裝路徑位於 `%LOCALAPPDATA%\hermes\`，而使用者的設定、認證、skill 與日誌則儲存在 `%USERPROFILE%\.hermes\`。若需移除程式，僅需在 PowerShell 執行 `hermes uninstall`，該指令會自動清除排程工作、捷徑與執行檔，同時保留使用者的個人資料。

## 標籤

Agent, Windows, 功能更新, 開源專案, Hermes Agent, NousResearch