##方案：Hermes Agent 完全安装到 D 盘（含数据迁移）

一、准备条件

请提前安装好这 3 个工具，并确保已添加到系统 PATH：

• Python 3.11+（安装时勾选“Add Python to PATH”）
• Git for Windows（默认选项即可）
• Node.js（LTS 版本）

检查是否已安装：在终端分别执行 python --version、git --version、node --version，能正常显示版本号即可。

二、彻底清理旧安装（可选，但建议执行）

如果你之前安装过 Hermes Agent（不论 C 盘还是其他位置），先完全卸载：

1. 打开任务管理器，结束所有 python.exe、hermes.exe、node.exe 进程。
2. 删除 C 盘数据目录：C:\Users\<你的用户名>\AppData\Local\hermes（整个文件夹删掉）。
3. 如果使用过 WSL，在 PowerShell 中执行 wsl --unregister <发行版名称>（可选）。
4. 从系统环境变量 PATH 中，移除所有指向旧 Hermes 目录的条目（如果存在）。

---

三、将 Hermes Agent 程序本体安装到 D 盘

我们放弃自动安装脚本，采用手动克隆源码 + 本地安装依赖的方式，直接安装到 D:\hermes\hermes-agent。

1. 创建 D 盘工作目录并克隆仓库

打开 PowerShell（建议用 Windows 终端，权限问题更少）：

D:
mkdir D:\hermes -Force
cd D:\hermes
git clone https://github.com/NousResearch/hermes-agent.git

如果克隆失败（网络问题），可尝试以下任一方法：

• 使用 SSH：git clone git@github.com:NousResearch/hermes-agent.git（需提前配置好 SSH Key）
• 使用镜像：git clone https://gitee.com/mirrors/NousResearch-hermes-agent.git
• 手动下载 ZIP：浏览器打开 GitHub 仓库，Code → Download ZIP，解压到 D:\hermes\hermes-agent

2. 创建 Python 虚拟环境

cd D:\hermes\hermes-agent
python -m venv venv
.\venv\Scripts\activate

激活后命令行前会出现 (venv) 前缀。

3. 安装 Python 依赖

pip install -e ".[all]"

若需升级 pip 可先执行 python -m pip install --upgrade pip。

4. 安装 Node.js 依赖以及浏览器工具（Playwright）

npm install
npx playwright install chromium

5. 初始化配置文件

copy .env.example .env

用记事本编辑 .env，填入你的 API Key 或留待后续配置（目前有 .env 即可）。

6. 将程序路径加入系统环境变量 PATH

为了让 hermes 命令在任何位置都能使用，我们需要把 虚拟环境的 Scripts 目录 加入 PATH：

1. 按 Win+R → 输入 sysdm.cpl → 确定。
2. 打开“高级”选项卡 → 环境变量。
3. 在 系统变量 中找到 Path，双击编辑。
4. 新建一条，填入：D:\hermes\hermes-agent\venv\Scripts
5. 再新建一条，填入：D:\hermes\hermes-agent（用于直接访问项目目录）。
6. 全部确定保存。

验证程序是否从 D 盘运行：

• 重新打开一个终端（必须新终端，否则环境变量不生效）
• 执行：where hermes
• 若看到两行路径包含 D:\hermes\hermes-agent\...，即表示成功。

---

四、运行初始化并配置基础功能

---

重要的事情说三遍，三遍，三遍… 因为创建了 Python 虚拟环境所以要进入到虚拟环境去运行

cd D:\hermes\hermes-agent 
.\venv\Scripts\activate

---

在新终端中依次执行：

hermes doctor        # 检查所有依赖，应全部显示 ✓
hermes setup         # 完成首次引导设置

此后可根据需要配置模型/API Key，例如：

hermes config set OPENCODE_ZEN_API_KEY "sk-你的密钥"
hermes config set model.provider opencode-zen
hermes config set model.default minimax-m2.5-free

---

五、将数据目录迁移到 D 盘（完全脱离 C 盘）

注意：Hermes 程序虽在 D 盘，但数据（配置、日志、缓存）仍会默认写入 C:\Users\<用户名>\AppData\Local\hermes。我们需要把该文件夹迁移到 D 盘，并在原位置创建一个“符号链接”指向新位置。

1. 完全退出 Hermes Agent

打开任务管理器，确保无任何 python.exe、hermes.exe、node.exe 进程残留。

2. 剪切数据文件夹到 D 盘

• 打开文件资源管理器，进入 C:\Users\<你的用户名>\AppData\Local
• 找到 hermes 文件夹（整个文件夹，而不是快捷方式）
• 右键 → 剪切（Ctrl+X）
• 在 D 盘的目标位置粘贴，例如：D:\hermes\hermes
  （最终路径就是 D:\hermes\hermes）

如果 D:\hermes 目录还不存在，请先手动创建。

3. 以管理员身份打开命令提示符（CMD）

重要：不能使用 PowerShell！

• 按 Win → 输入 cmd → 右键选择“以管理员身份运行”。

4. 创建目录符号链接

在管理员 CMD 中执行以下命令（请将 hyman 替换为你的 Windows 用户名）：

mklink /D "C:\Users\hyman\AppData\Local\hermes" "D:\hermes\hermes"

成功后会出现类似提示：

为 C:\Users\hyman\AppData\Local\hermes <<===>> D:\hermes\hermes 创建的符号链接

---

六、最终验证

重新打开一个普通终端（无需管理员），执行：

hermes doctor

如果输出中仍然显示类似：

✓ ~/AppData\Local\hermes/.env file exists

则说明符号链接工作正常，程序实际读写的是 D:\hermes\hermes 下的数据，C 盘仅保留一个“快捷方式”，不再占用额外空间。

你也可以直接检查 D:\hermes\hermes 文件夹，如果里面有 .env、config.yaml 等文件，则迁移彻底完成。

---

七、日常使用

以后使用 hermes 命令时，直接打开普通终端即可。所有程序和数据的读写都位于 D 盘，C 盘彻底得到解放。 更新时只需在 D:\hermes\hermes-agent 目录下执行 git pull 并重新 pip install -e ".[all]" 即可（更新后建议再跑一次 hermes doctor）。