Hermes Agent遷移到外部硬盤的完整教程(2026)
我要評(píng)論背景
Hermes Agent 默認(rèn)將所有數(shù)據(jù)存儲(chǔ)在 ~/.hermes/，包括程序本體（venv、node_modules）和用戶數(shù)據(jù)（sessions、memories、skills 等）。隨著使用，這個(gè)目錄會(huì)持續(xù)增長(zhǎng)。本教程記錄如何將其遷移到外部硬盤以節(jié)省內(nèi)置 SSD 空間。
前提條件
- 外部硬盤格式為 APFS 或 Mac OS Extended (HFS+)（不支持 NTFS/exFAT，因?yàn)樾枰?hào)鏈接和 Unix 權(quán)限）
- 外部硬盤有足夠可用空間（當(dāng)前 Hermes 占 ~1 GB，隨使用會(huì)增長(zhǎng)）
遷移步驟
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，但更簡(jiǎn)潔。
Step 4: 創(chuàng)建符號(hào)鏈接
# 在原位置創(chuàng)建指向外部硬盤的符號(hào)鏈接 ln -s /Volumes/你的硬盤名/.hermes ~/.hermes
為什么用符號(hào)鏈接而不是 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)行。
符號(hào)鏈接讓系統(tǒng)"以為"數(shù)據(jù)還在 ~/.hermes/，所有硬編碼路徑都能正常解析。
Step 5: 驗(yàn)證
# 確認(rèn)符號(hào)鏈接正確 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ù)庫(kù)文件（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)榉?hào)鏈接會(huì)重新生效），直接運(yùn)行 hermes 即可。
回滾（遷移回內(nèi)置硬盤）
如果需要將數(shù)據(jù)遷回內(nèi)置硬盤：
# 1. 停止 Hermes hermes stop 2>/dev/null && pkill -f hermes 2>/dev/null # 2. 刪除符號(hào)鏈接 rm ~/.hermes # 3. 移回?cái)?shù)據(jù) mv /Volumes/你的硬盤名/.hermes ~/.hermes # 4. 驗(yàn)證 hermes --version
目錄結(jié)構(gòu)參考
~/.hermes/ → 符號(hào)鏈接到外部硬盤
├── 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ì)增長(zhǎng))
├── sessions/ (會(huì)話歷史, 會(huì)增長(zhǎng))
├── memories/ (跨會(huì)話記憶, 會(huì)增長(zhǎng))
├── audio_cache/ (語(yǔ)音緩存, 會(huì)增長(zhǎng))
├── image_cache/ (圖片緩存, 會(huì)增長(zhǎng))
├── config.yaml (配置文件)
├── SOUL.md (Agent 人格定義)
├── auth.json (API 密鑰)
└── state.db (狀態(tài)數(shù)據(jù)庫(kù))
重命名外部硬盤上的目錄
如果你對(duì)外部硬盤上的目錄名不滿意（比如想從 hermes-data 改為 .hermes），可以隨時(shí)重命名：
# 1. 停止 Hermes hermes stop 2>/dev/null && pkill -f hermes 2>/dev/null # 2. 刪除舊的符號(hào)鏈接 rm ~/.hermes # 3. 重命名外部硬盤上的目錄 mv /Volumes/你的硬盤名/舊目錄名 /Volumes/你的硬盤名/新目錄名 # 4. 重新創(chuàng)建符號(hào)鏈接指向新名稱 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)
- 方案: 符號(hào)鏈接（
~/.hermes→ 外部硬盤） - 驗(yàn)證: rsync 復(fù)制后對(duì)比文件數(shù)量一致，hermes v0.10.0 正常運(yùn)行
目錄重命名 (2026-04-22)
- 操作: 將外部硬盤上的
hermes-data重命名為.hermes - 步驟: 刪除符號(hào)鏈接 → mv 重命名 → 重建符號(hào)鏈接
- 最終路徑:
~/.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 - 解決: 改用符號(hào)鏈接方案，讓所有硬編碼路徑透明解析到外部硬盤
以上就是Hermes Agent遷移到外部硬盤的完整教程(2026)的詳細(xì)內(nèi)容，更多關(guān)于Hermes Agent遷移的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
Hermes Agent全平臺(tái)部署運(yùn)維中文安裝配置手冊(cè)(2026)
本指南將教你全平臺(tái)部署Hermes-Agent,從銀河麒麟到macOS全覆蓋,手把手Docker化或原生安裝,智譜GLM與企業(yè)微信一鍵接入,MCP雙向集成實(shí)戰(zhàn),安全配置與避坑指南全都有,希望對(duì)大2026-07-20
本文主要介紹了Hermes多Agent實(shí)操,手把手教你配置YAML、Python派發(fā)任務(wù),并避坑多Agent實(shí)操的6個(gè)常見陷阱,省時(shí)又省token，感興趣的可以了解一下2026-07-17
Hermes Agent中多Profile實(shí)戰(zhàn)小結(jié)
本文主要介紹了Hermes Agent中多Profile實(shí)戰(zhàn)，學(xué)會(huì)Profile機(jī)制,就能輕松創(chuàng)建多個(gè)獨(dú)立AI實(shí)例,徹底告別配置沖突和角色混亂,立即掌握創(chuàng)建、切換和隔離AI角色的完整方案,讓你的2026-07-17
Hermes Agent 全棧安裝、配置與Web端架構(gòu)深度解析(官方命令版·最終優(yōu)化)
本文給大家介紹Hermes Agent 全棧安裝、配置與Web端架構(gòu)深度解析，結(jié)合實(shí)例代碼給大家介紹的非常詳細(xì)，感興趣的朋友跟隨小編一起看看吧2026-07-16
本文主要介紹了深入理解Hermes Agent Skill 機(jī)制，包含發(fā)現(xiàn)索引→觸發(fā)加載→預(yù)處理→Prompt注入→LLM響應(yīng)五個(gè)階段，下面就詳細(xì)了解這五種階段，感興趣的可以了解一下2026-07-16- Hermes Agent 的 CLI 并非一個(gè)簡(jiǎn)單的命令行包裝器，而是一個(gè)完整的終端用戶界面，掌握 CLI 的全部交互細(xì)節(jié)，你才能讓智能體在終端里真正"跑起來"，本文主要介紹2026-07-15
Hermes Agent開發(fā)了一套智能上下文壓縮系統(tǒng)，專門解決長(zhǎng)對(duì)話場(chǎng)景下的上下文窗口限制問題,本文就來詳細(xì)的介紹一下Hermes Agent 上下文壓縮機(jī)制，感興趣的 可以了解一下2026-07-15
Hermes Agent桌面版安裝部署完全指南(2026年最新)
本文是一份超詳細(xì)HermesAgent桌面版安裝部署指南,手把手帶你搞定Windows、macOS、Linux全平臺(tái)安裝,點(diǎn)擊獲取極速配置技巧、核心功能拆解與WevView2報(bào)錯(cuò)解決方案,別錯(cuò)過讓Age2026-07-14- 想要一個(gè)能直接在終端里聊天的AI助手嗎，HermesAgent本地命令行工具可以幫你連接多種大模型、執(zhí)行終端命令、分析文件,甚至寫代碼,立即掌握核心命令和配置技巧,提升你的工作2026-07-13
在Hermes Agent里搭建全中文 Honcho 記憶系統(tǒng)踩過的坑
我的Hermes Agent配置了多個(gè) profile，記憶系統(tǒng)選擇了基于 Honcho,但是Honcho的提示詞是英文的，它的API服務(wù)也是英文環(huán)境,我需要全中文流程,下面就來介紹一下搭建全中文 Ho2026-07-13
