之前发布的 Windows 安装 Hermes 教程中，不少朋友反馈：镜像方案与普通 Git 克隆常因网络问题失败。彻底避开网络卡顿、中断、超时问题。
# 一、安装 WSL（离线手动版）
在 Windows 上用**离线/手动方式安装 WSL**，是解决微软商店报错、网络差、系统版本兼容问题的最优方案。
**核心思路**：开启系统功能 → 安装 WSL2 内核 → 手动导入 Linux 发行版
## 1.1 开启系统底层功能
1.1.1**检查系统版本**
按 `Win + R`，输入 `winver` 回车。
- Windows 10 2004 及以上（内部版本 19041+）
- 或 Windows 11 任意版本
1.1.2**开启 WSL 与虚拟机平台（二选一）**
- **方法 A（命令行，推荐）**
右键开始菜单 → 打开 **Windows PowerShell（管理员）** 或 **终端（管理员）**，依次执行：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
- **方法 B（图形界面）**
`Win + R` 输入 `optionalfeatures`，勾选：
- 适用于 Linux 的 Windows 子系统
点击确定。
1.1.3.**必须重启电脑**
上述设置重启后才会生效。
## 1.2 安装 WSL2 内核更新包
- x64（绝大多数 Intel/AMD 电脑）：[WSL2 Linux kernel update package for x64 machines](
- ARM64（高通/Surface Pro X）：[WSL2 Linux kernel update package for ARM64 machines](
1.2.2 **安装**
- Ubuntu 22.04 LTS（稳定）
- Ubuntu 24.04 LTS（新版）
1.3.2**创建安装目录**
建议放在非系统盘，例如：
D:\WSL-Ubuntu
1.3.3 **解压得到 install.tar.gz**
-1. 将 `.appx` 后缀改为 `.zip`
-2. 用 7-Zip/WinRAR 解压
-3. 继续解压内层文件，**找到 `install.tar.gz`**
-4. 把它放到 `D:\WSL-Ubuntu`
1.3.4. **执行导入命令**
以管理员打开 PowerShell，执行：
cd D:\WSL-Ubuntu
wsl --import Ubuntu-22.04 D:\WSL-Ubuntu\ install.tar.gz --version 2
- `Ubuntu-22.04`：系统名称
- `D:\WSL-Ubuntu\`：安装位置
- `install.tar.gz`：根文件系统包
## 1.4 创建普通用户（必做）
手动导入默认是 root，必须建普通用户。
1. 4.1启动 Ubuntu
wsl -d Ubuntu-22.04
1.4.2. 添加用户并设置密码
adduser 你的用户名
usermod -aG sudo 你的用户名
1.4.3. **设置默认用户（推荐）**
sudo nano /etc/wsl.conf
default=你的用户名
保存：`Ctrl+O`，退出：`Ctrl+X`
1.4.4 重启 WSL 生效
wsl --shutdown
# 二、离线安装 Hermes（无网络失败）
2. **准备目录**
mkdir -p ~/.hermes
sudo rm -rf ~/.hermes/hermes-agent
mkdir -p ~/.hermes
3. **放入并解压源码**
推荐以下 3 种最简单方法 ：
方法 1：直接拖拽 / 资源管理器复制（最简单）
在 Windows 打开文件夹，把 hermes-agent-main.zip 复制。
在 WSL 终端输入以下命令打开 Linux 目录：explorer.exe ~/.hermes/
在弹出的 Windows 资源管理器窗口里 直接粘贴 即可。
方法 2：用 mv 命令从 Windows 移动到 WSL # 进入 WSL 的目标目录 cd ~/.zip ./
/mnt/d/ 对应 Windows 的 D 盘
/mnt/c/ 对应 Windows C 盘
方法 3：先解压再传入（更稳）
在 Windows 直接解压 hermes-agent-main.zip，得到文件夹 hermes-agent-main。
用方法 1 把整个文件夹粘贴到 ~/.hermes/。
4. 解压并移动文件夹
ZIP 传入后执行： # 如果是 zip 包，先解压 unzip hermes-agent-main.zip # 重命名移动到标准路径 mv hermes-agent-main ~/.hermes/hermes-agent
5. **进入目录**
cd ~/.hermes/hermes-agent
6. **创建虚拟环境（解决 Ubuntu pip 限制）**
python3 -m venv venv
source venv/bin/activate
7. **安装依赖**
pip install -r requirements.txt
8. **验证安装**
hermes --version
出现版本号（如 `hermes 0.12.0`）即安装成功。
# 三、安装 Hermes-WebUI（网页界面）
cd ~/.hermes
wget -O hermes-webui-master.zip
unzip hermes-webui-master.zip
mv hermes-webui-master hermes-webui
2. 启动 WebUI
cd hermes-webui
./start.sh
# 四、离线安装优势说明
1. **绕过 Git 协议**：只用 HTTP/HTTPS，公司/校园网不会拦截
全部评论