Hermes Agent遷移到外部硬盤的詳細(xì)教程

發(fā)布時(shí)間：2026-04-23 14:39:29 作者：Learning_By Doing

本文詳細(xì)介紹了將OS系統(tǒng)HermesAgent將數(shù)據(jù)遷移到外部硬盤以節(jié)省內(nèi)置SSD空間的過程,步驟包括停止HermesAgent、確認(rèn)外部硬盤狀態(tài)、移動(dòng)數(shù)據(jù)、創(chuàng)建建建符號鏈接等確保遷移后的正常運(yùn)行,需要的朋友可以參考下

背景

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

前提條件

外部硬盤格式為 APFS 或 Mac OS Extended (HFS+)（不支持 NTFS/exFAT，因?yàn)樾枰栨溄雍?Unix 權(quán)限）
外部硬盤有足夠可用空間（當(dāng)前 Hermes 占 ~1 GB，隨使用會(huì)增長）

遷移步驟

Step 1: 停止 Hermes

# 檢查 Hermes 是否在運(yùn)行
ps aux | grep -i hermes | grep -v grep
# 如果在運(yùn)行，停止它
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: 移動(dòng)數(shù)據(jù)到外部硬盤

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

為什么用 mv 而不是 cp？
mv 在同一文件系統(tǒng)上是瞬間完成的（只改指針）?？缥募到y(tǒng)時(shí)等同于 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 命令無法運(yùn)行。

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

Step 5: 驗(yàn)證

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

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

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

推出外部硬盤前的操作

必須先停止 Hermes 再推出硬盤！ 否則會(huì)導(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 中點(diǎn)擊推出按鈕

重新插入硬盤后

插入硬盤后 Hermes 會(huì)自動(dòng)恢復(fù)可用（因?yàn)榉栨溄訒?huì)重新生效），直接運(yùn)行 hermes 即可。

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

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

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

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

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

# 4. 驗(yàn)證
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í)到的技能, 會(huì)增長)
├── sessions/                       (會(huì)話歷史, 會(huì)增長)
├── memories/                       (跨會(huì)話記憶, 會(huì)增長)
├── audio_cache/                    (語音緩存, 會(huì)增長)
├── image_cache/                    (圖片緩存, 會(huì)增長)
├── config.yaml                     (配置文件)
├── SOUL.md                         (Agent 人格定義)
├── auth.json                       (API 密鑰)
└── state.db                        (狀態(tài)數(shù)據(jù)庫)

重命名外部硬盤上的目錄

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

# 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. 驗(yàn)證
ls -la ~/.hermes
hermes --version

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

操作記錄

初次遷移 (2026-04-22)

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

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

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

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

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

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

Tag：Agent Hermes 外部硬盤遷移

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线