Hermes Agent遷移到外部硬盤的完整教程(2026)

發(fā)布時間：2026-07-24 11:35:45 作者：Learning_By Doing

Hermes Agent 默認(rèn)將所有數(shù)據(jù)存儲在 ~/.hermes/，包括程序本體（venv、node_modules）和用戶數(shù)據(jù)（sessions、memories、skills 等）,隨著使用，這個目錄會持續(xù)增長,本教程記錄了如何將其遷移到外部硬盤以節(jié)省內(nèi)置 SSD 空間,感興趣的小伙伴可以了解下

背景

Hermes Agent 默認(rèn)將所有數(shù)據(jù)存儲在 ~/.hermes/，包括程序本體（venv、node_modules）和用戶數(shù)據(jù)（sessions、memories、skills 等）。隨著使用，這個目錄會持續(xù)增長。本教程記錄如何將其遷移到外部硬盤以節(jié)省內(nèi)置 SSD 空間。

前提條件

外部硬盤格式為 APFS 或 Mac OS Extended (HFS+)（不支持 NTFS/exFAT，因為需要符號鏈接和 Unix 權(quán)限）
外部硬盤有足夠可用空間（當(dāng)前 Hermes 占 ~1 GB，隨使用會增長）

遷移步驟

Step 1: 停止 Hermes

# 檢查 Hermes 是否在運行
ps aux | grep -i hermes | grep -v grep
# 如果在運行，停止它
hermes stop
# 或者強(qiáng)制終止
pkill -f hermes

重要：必須在 Hermes 完全停止后再操作，否則可能導(dǎo)致數(shù)據(jù)損壞。

Step 2: 確認(rèn)外部硬盤狀態(tài)

# 查看已掛載的外部卷
ls /Volumes/

# 確認(rèn)文件系統(tǒng)類型（必須是 APFS 或 HFS+）
diskutil info /Volumes/你的硬盤名 | grep "File System"

# 確認(rèn)可用空間
df -h /Volumes/你的硬盤名

Step 3: 移動數(shù)據(jù)到外部硬盤

# 將 ~/.hermes 整體移動到外部硬盤（目錄名可自定義）
mv ~/.hermes /Volumes/你的硬盤名/.hermes

為什么用 mv 而不是 cp？

mv 在同一文件系統(tǒng)上是瞬間完成的（只改指針）?？缥募到y(tǒng)時等同于 cp + rm，但更簡潔。

Step 4: 創(chuàng)建符號鏈接

# 在原位置創(chuàng)建指向外部硬盤的符號鏈接
ln -s /Volumes/你的硬盤名/.hermes ~/.hermes

為什么用符號鏈接而不是 HERMES_HOME 環(huán)境變量？

Hermes 的 Python 虛擬環(huán)境（venv）中所有腳本的 shebang 都硬編碼了#!/Users/你的用戶名/.hermes/hermes-agent/venv/bin/python3 這樣的路徑。

如果用 HERMES_HOME 指向新位置，venv 內(nèi)部的路徑全部斷裂，導(dǎo)致 hermes 命令無法運行。

符號鏈接讓系統(tǒng)"以為"數(shù)據(jù)還在 ~/.hermes/，所有硬編碼路徑都能正常解析。

Step 5: 驗證

# 確認(rèn)符號鏈接正確
ls -la ~/.hermes
# 應(yīng)輸出: ~/.hermes -> /Volumes/你的硬盤名/.hermes

# 確認(rèn) hermes 命令可用
hermes --version

# 確認(rèn)配置文件可訪問
cat ~/.hermes/config.yaml

推出外部硬盤前的操作

必須先停止 Hermes 再推出硬盤！ 否則會導(dǎo)致：

進(jìn)程崩潰或掛起（無法讀寫數(shù)據(jù)文件）
macOS 可能拒絕推出硬盤（提示"磁盤正在使用中"）
最壞情況：數(shù)據(jù)庫文件（state.db）損壞

安全推出流程

# 1. 停止 Hermes
hermes stop 2>/dev/null
pkill -f hermes 2>/dev/null

# 2. 確認(rèn)沒有進(jìn)程在訪問外部硬盤
lsof +D /Volumes/你的硬盤名/.hermes 2>/dev/null

# 如果有輸出，說明還有進(jìn)程在使用，需要逐一關(guān)閉或 kill
# 例如：kill <PID>

# 3. 安全推出
diskutil eject /Volumes/你的硬盤名
# 或者在 Finder 中點擊推出按鈕

重新插入硬盤后

插入硬盤后 Hermes 會自動恢復(fù)可用（因為符號鏈接會重新生效），直接運行 hermes 即可。

回滾（遷移回內(nèi)置硬盤）

如果需要將數(shù)據(jù)遷回內(nèi)置硬盤：

# 1. 停止 Hermes
hermes stop 2>/dev/null && pkill -f hermes 2>/dev/null

# 2. 刪除符號鏈接
rm ~/.hermes

# 3. 移回數(shù)據(jù)
mv /Volumes/你的硬盤名/.hermes ~/.hermes

# 4. 驗證
hermes --version

目錄結(jié)構(gòu)參考

~/.hermes/ → 符號鏈接到外部硬盤
├── hermes-agent/ (程序本體 ~1 GB)
│ ├── venv/ (Python 虛擬環(huán)境, ~538 MB)
│ ├── ui-tui/ (TUI 界面, ~191 MB)
│ ├── node_modules/ (Node.js 依賴, ~146 MB)
│ ├── skills/ (內(nèi)置技能)
│ └── agent/ (核心代理邏輯)
├── skills/ (自定義/學(xué)習(xí)到的技能, 會增長)
├── sessions/ (會話歷史, 會增長)
├── memories/ (跨會話記憶, 會增長)
├── audio_cache/ (語音緩存, 會增長)
├── image_cache/ (圖片緩存, 會增長)
├── config.yaml (配置文件)
├── SOUL.md (Agent 人格定義)
├── auth.json (API 密鑰)
└── state.db (狀態(tài)數(shù)據(jù)庫)

重命名外部硬盤上的目錄

如果你對外部硬盤上的目錄名不滿意（比如想從 hermes-data 改為 .hermes），可以隨時重命名：

# 1. 停止 Hermes
hermes stop 2>/dev/null && pkill -f hermes 2>/dev/null

# 2. 刪除舊的符號鏈接
rm ~/.hermes

# 3. 重命名外部硬盤上的目錄
mv /Volumes/你的硬盤名/舊目錄名 /Volumes/你的硬盤名/新目錄名

# 4. 重新創(chuàng)建符號鏈接指向新名稱
ln -s /Volumes/你的硬盤名/新目錄名 ~/.hermes

# 5. 驗證
ls -la ~/.hermes
hermes --version

注意：. 開頭的目錄在 Finder 中默認(rèn)隱藏。按 Cmd + Shift + . 可以切換顯示隱藏文件。

操作記錄

初次遷移 (2026-04-22)

源路徑: ~/.hermes/ (1.0 GB, 71213 個文件)
目標(biāo)路徑: /Volumes/WDBlueSN5000/hermes-data/
外部硬盤: WD Blue SN5000 (931 GB APFS)
方案: 符號鏈接（~/.hermes → 外部硬盤）
驗證: rsync 復(fù)制后對比文件數(shù)量一致，hermes v0.10.0 正常運行

目錄重命名 (2026-04-22)

操作: 將外部硬盤上的 hermes-data 重命名為 .hermes
步驟: 刪除符號鏈接 → mv 重命名 → 重建符號鏈接
最終路徑: ~/.hermes → /Volumes/WDBlueSN5000/.hermes
驗證: hermes v0.10.0 正常運行

踩坑記錄：為什么不能用 HERMES_HOME 環(huán)境變量

最初嘗試設(shè)置 export HERMES_HOME="/Volumes/WDBlueSN5000/hermes-data" 并直接 mv 整個目錄
結(jié)果: hermes 命令無法運行，因為 venv 內(nèi)腳本的 shebang 硬編碼了 #!/Users/cc/.hermes/hermes-agent/venv/bin/python3
解決: 改用符號鏈接方案，讓所有硬編碼路徑透明解析到外部硬盤

以上就是Hermes Agent遷移到外部硬盤的完整教程(2026)的詳細(xì)內(nèi)容，更多關(guān)于Hermes Agent遷移的資料請關(guān)注腳本之家其它相關(guān)文章！