1. 为什么 Hermes Agent 迁移到外部硬盘会踩 venv 路径的坑Hermes Agent 是一个把程序本体和用户数据都塞进~/.hermes/的本地智能体工具它自带 Python 虚拟环境、Node 依赖、会话历史、跨会话记忆和技能库。默认安装后这个目录会随着你聊天、跑任务、装技能持续膨胀我见过从 1GB 涨到十几 GB 的情况。对于内置 SSD 只有 256GB 或 512GB 的机器来说系统盘被吃掉一大块空间是很现实的问题尤其是 macOS 用户系统盘写满之后连系统更新都做不了。把 Hermes Agent 迁移到外部硬盘核心要解决的不是「复制文件」这么简单而是venv 里硬编码的绝对路径。Python 虚拟环境在创建时bin/下的可执行脚本 shebang 会写死成类似#!/Users/你的用户名/.hermes/hermes-agent/venv/bin/python3这样的路径。你如果只是把目录挪走、再用HERMES_HOME环境变量指过去venv 内部的路径全部断裂hermes命令直接跑不起来。这就是很多人迁移失败的根本原因。所以正确思路是数据物理上搬到外部硬盘但逻辑上仍然让系统认为它在~/.hermes/。实现这个效果最稳的手段就是符号链接symlink。符号链接让所有硬编码路径透明解析到外部硬盘venv 感知不到任何变化hermes命令照常工作。这篇教程会给出可复制的目录结构、ln -s命令、HERMES_HOME的正确用法与禁用场景以及迁移后的启动自检和回滚验证动作适合想把 Hermes Agent 从系统盘迁到外部硬盘、又不想重装环境的用户。需要提前说明的是外部硬盘的文件系统必须是 APFS 或 Mac OS Extended (HFS)因为符号链接和 Unix 权限在 NTFS/exFAT 上支持不完整跨平台盘符挂载后经常出现权限丢失、链接失效的问题。这一点在动手前就要确认否则后面会白折腾。2. 迁移前的前置检查与 TaoToken 配置备份在动任何文件之前先把 Hermes Agent 彻底停下来并且确认外部硬盘状态。这一步看起来啰嗦但跳过它导致state.db损坏的案例非常多。Hermes 运行时会持续写会话和记忆数据库迁移过程中如果有进程还在读写数据库文件很容易写坏恢复起来很麻烦。先检查进程ps aux | grep -i hermes | grep -v grep如果有输出说明 Hermes 还在跑用官方命令停hermes stop停不掉就强制终止pkill -f hermes然后确认外部硬盘挂载情况和文件系统类型ls /Volumes/ diskutil info /Volumes/你的硬盘名 | grep File System df -h /Volumes/你的硬盘名File System那一行必须显示 APFS 或 HFS。如果是 exFAT 或 NTFS先备份数据再重新格式化为 APFS否则符号链接会失效。接下来是很多人忽略的一步备份你的 API 配置。Hermes Agent 的~/.hermes/auth.json里存着模型服务的密钥config.yaml里存着 Base URL 和默认模型。如果你用的是 TaoToken 这类聚合接入服务配置通常长这样{ base_url: https://taotoken.net/api, api_key: sk-你的密钥, model: claude-sonnet-4-5 }迁移前把auth.json和config.yaml单独复制一份到安全位置比如~/Desktop/hermes-backup/。这样即使迁移过程中出问题你也能快速恢复接入配置不用重新去控制台生成密钥。TaoToken 的密钥可以在控制台的 API Keys 页面管理接入文档里有完整的 Base URL 和模型 ID 对照表迁移后如果发现模型调用报 401多半是auth.json没跟着搬过去或者权限变了。确认外部硬盘可用空间足够。当前 Hermes 本体大约 1GB但sessions/、memories/、audio_cache/、image_cache/会持续增长建议预留至少 20GB。用df -h看一眼可用空间别等到搬到一半空间不够。最后记录一下当前版本方便迁移后对比hermes --version把版本号记下来比如v0.10.0迁移完成后要确认版本一致说明环境没被破坏。3. 可复制的迁移配置mv 搬数据 ln -s 建符号链接这一步是整篇教程的核心。先给出目标目录结构让你心里有数~/.hermes/ → 符号链接到 /Volumes/你的硬盘名/.hermes ├── hermes-agent/ (程序本体 ~1 GB) │ ├── venv/ (Python 虚拟环境, ~538 MB) │ ├── ui-tui/ (TUI 界面, ~191 MB) │ ├── node_modules/ (Node.js 依赖, ~146 MB) │ ├── skills/ (内置技能) │ └── agent/ (核心代理逻辑) ├── skills/ (自定义/学习到的技能, 会增长) ├── sessions/ (会话历史, 会增长) ├── memories/ (跨会话记忆, 会增长) ├── audio_cache/ (语音缓存, 会增长) ├── image_cache/ (图片缓存, 会增长) ├── config.yaml (配置文件) ├── SOUL.md (Agent 人格定义) ├── auth.json (API 密钥) └── state.db (状态数据库)搬数据用mvmv ~/.hermes /Volumes/你的硬盘名/.hermes为什么用mv而不是cp在同一文件系统上mv只改指针瞬间完成跨文件系统时它等价于cp rm但语义更简洁也不会留下两份数据占空间。注意目标目录名以.开头Finder 默认隐藏按Cmd Shift .可以切换显示。然后创建符号链接ln -s /Volumes/你的硬盘名/.hermes ~/.hermes验证链接是否正确ls -la ~/.hermes期望输出类似lrwxr-xr-x 1 cc staff 38 Apr 22 10:30 /Users/cc/.hermes - /Volumes/WDBlueSN5000/.hermes看到箭头指向外部硬盘就对了。关于 HERMES_HOME 环境变量这里必须说清楚不要用它来替代符号链接。Hermes 的 venv 里所有脚本 shebang 硬编码了#!/Users/你的用户名/.hermes/hermes-agent/venv/bin/python3。如果你设置export HERMES_HOME/Volumes/你的硬盘名/.hermes并直接mv目录venv 内部路径全部断裂hermes命令会报No such file or directory或者 Python 解释器找不到。符号链接让系统「以为」数据还在~/.hermes/所有硬编码路径都能正常解析这才是正确方案。那HERMES_HOME什么时候有用当你需要临时切换到一个完全独立的 Hermes 实例做测试时可以配合符号链接一起用但日常迁移场景下符号链接是唯一稳妥的选择。如果你确实想用环境变量正确做法是保留~/.hermes符号链接同时不设置HERMES_HOME让默认路径生效。如果你对外部硬盘上的目录名不满意比如想从hermes-data改成.hermes流程是停 Hermes → 删旧链接 →mv重命名 → 重建链接hermes stop 2/dev/null pkill -f hermes 2/dev/null rm ~/.hermes mv /Volumes/你的硬盘名/旧目录名 /Volumes/你的硬盘名/新目录名 ln -s /Volumes/你的硬盘名/新目录名 ~/.hermes ls -la ~/.hermes hermes --version4. 迁移后启动自检与成功结果验证符号链接建好之后先别急着跑复杂任务按顺序做几项自检确认环境完整。第一项确认hermes命令可用hermes --version期望输出v0.10.0或你迁移前记录的版本号。如果报command not found说明 PATH 里的hermes入口指向了旧路径检查which hermes通常它是个软链到~/.hermes/hermes-agent/venv/bin/hermes符号链接生效后应该能正常解析。第二项确认配置文件可读cat ~/.hermes/config.yaml能正常打印内容说明符号链接和权限都没问题。如果报Permission denied检查外部硬盘挂载时是否带了noowners选项APFS 默认不会但某些第三方挂载工具会。第三项确认 venv 内部路径解析正常~/.hermes/hermes-agent/venv/bin/python3 --version这条命令直接调用 venv 里的 Python能打印版本号说明 shebang 硬编码路径通过符号链接透明解析成功。这是判断迁移是否真正成功的关键指标。第四项跑一次模型调用验证接入配置。如果你用 TaoToken 接入可以先用模型对话页面确认密钥和模型 ID 有效再在 Hermes 里发一条测试消息hermes 你好测试一下迁移后的环境如果返回正常回复说明auth.json里的 Base URL、API Key、Model ID 三件套都正确加载了。TaoToken 的 Base URL 是https://taotoken.net/api模型 ID 要和你config.yaml里写的一致比如claude-sonnet-4-5。如果报 401去控制台的 API Keys 页面确认密钥没过期如果报模型不存在对照接入文档里的模型 ID 列表检查拼写。第五项确认数据目录可写touch ~/.hermes/.write_test rm ~/.hermes/.write_test能创建和删除文件说明写权限正常Hermes 后续写会话和记忆不会失败。五项都通过迁移就算成功了。我实测下来整个流程从停止 Hermes 到验证完成大约 5 分钟其中大部分时间花在mv跨文件系统复制上1GB 数据在 USB 3.0 硬盘上大概 30 秒。5. 常见报错排查401、local proxy failed、reading choices、OAuth迁移过程中和迁移后最容易碰到几类报错这里逐个对照排查。报错一401 Unauthorized或invalid api key这是接入配置没跟着迁移导致的。检查~/.hermes/auth.json是否存在且内容完整cat ~/.hermes/auth.json如果文件为空或不存在从你迁移前的备份里恢复。如果你用 TaoToken去控制台的 API Keys 页面重新生成一个密钥然后更新auth.json{ base_url: https://taotoken.net/api, api_key: sk-新密钥, model: claude-sonnet-4-5 }注意 Base URL 不要带末尾斜杠模型 ID 要和接入文档一致。报错二local proxy failed或connection refused这个报错通常和网络代理配置有关。Hermes 如果配置了本地代理端口迁移后代理进程可能没起来。检查config.yaml里是否有proxy相关字段如果有确认代理服务在运行。如果你没有主动配置代理把config.yaml里的 proxy 字段注释掉再试。另外确认外部硬盘挂载后路径没变符号链接指向正确。报错三reading choices或KeyError: choices这是模型返回格式不符合预期导致的常见于 Base URL 配错或者模型 ID 写成了不支持的名称。检查config.yaml里的base_url是否是https://taotoken.net/api模型 ID 是否在支持列表里。如果用的是 OpenAI 兼容格式确认请求路径拼接正确。这个报错和迁移本身无关但迁移后重新配置时容易写错。报错四OAuth相关报错或token expired如果你用 OAuth 方式登录某些模型服务迁移后 token 缓存路径变了会导致认证失败。检查~/.hermes/下是否有.oauth或credentials目录确认它们跟着搬到了外部硬盘。如果 token 过期重新走一次 OAuth 授权流程即可。注意 OAuth 回调地址可能绑定localhost确保本地端口没被占用。报错五hermes: command not found符号链接建好了但 PATH 没生效。检查which hermes如果为空说明 shell 的 PATH 里没有~/.hermes/hermes-agent/venv/bin。在~/.zshrc或~/.bashrc里加上export PATH$HOME/.hermes/hermes-agent/venv/bin:$PATH然后source ~/.zshrc重新加载。报错六外部硬盘推出后 Hermes 崩溃这是没先停 Hermes 就拔盘导致的。正确流程是hermes stop 2/dev/null pkill -f hermes 2/dev/null lsof D /Volumes/你的硬盘名/.hermes 2/dev/null diskutil eject /Volumes/你的硬盘名lsof有输出说明还有进程占用逐一 kill 掉再推出。重新插入硬盘后符号链接自动生效直接运行hermes即可。6. 回滚方案与长期使用建议迁移不是单向操作如果你后来想把数据迁回内置硬盘或者换一块外部硬盘回滚流程要清楚。回滚到内置硬盘hermes stop 2/dev/null pkill -f hermes 2/dev/null rm ~/.hermes mv /Volumes/你的硬盘名/.hermes ~/.hermes hermes --version注意rm ~/.hermes删的是符号链接本身不会删外部硬盘上的数据所以这一步是安全的。mv把数据搬回原位后~/.hermes重新变成真实目录venv 路径自然生效。换外部硬盘时先把新盘格式化为 APFS挂载后把旧盘数据rsync过去rsync -aH --infoprogress2 /Volumes/旧盘/.hermes/ /Volumes/新盘/.hermes/-aH保留权限和硬链接--infoprogress2显示总进度。复制完成后对比文件数量find /Volumes/旧盘/.hermes -type f | wc -l find /Volumes/新盘/.hermes -type f | wc -l数量一致再删旧链接、建新链接。长期使用有几点建议。第一外部硬盘尽量用 SSD机械盘跑 venv 和数据库会有明显延迟。第二养成「先停 Hermes 再拔盘」的习惯state.db损坏恢复成本很高。第三定期备份auth.json和config.yaml这两个文件很小但最关键丢了要重新配置接入。第四如果你经常在不同机器间切换可以把 Hermes 数据放在 TaoToken 的 Coding Plan 配合的云端工作区里做同步但本地符号链接方案仍然是性能最好的选择。最后提醒一句符号链接方案对 Hermes 这种自带 venv 的工具是通用解法其他类似结构的 Agent 工具迁移时也可以参考这个思路先停进程再mv数据最后ln -s建链接不要用环境变量硬指路径。
Hermes Agent 迁移到外部硬盘教程：用符号链接与 HERMES_HOME 保住 venv
1. 为什么 Hermes Agent 迁移到外部硬盘会踩 venv 路径的坑Hermes Agent 是一个把程序本体和用户数据都塞进~/.hermes/的本地智能体工具它自带 Python 虚拟环境、Node 依赖、会话历史、跨会话记忆和技能库。默认安装后这个目录会随着你聊天、跑任务、装技能持续膨胀我见过从 1GB 涨到十几 GB 的情况。对于内置 SSD 只有 256GB 或 512GB 的机器来说系统盘被吃掉一大块空间是很现实的问题尤其是 macOS 用户系统盘写满之后连系统更新都做不了。把 Hermes Agent 迁移到外部硬盘核心要解决的不是「复制文件」这么简单而是venv 里硬编码的绝对路径。Python 虚拟环境在创建时bin/下的可执行脚本 shebang 会写死成类似#!/Users/你的用户名/.hermes/hermes-agent/venv/bin/python3这样的路径。你如果只是把目录挪走、再用HERMES_HOME环境变量指过去venv 内部的路径全部断裂hermes命令直接跑不起来。这就是很多人迁移失败的根本原因。所以正确思路是数据物理上搬到外部硬盘但逻辑上仍然让系统认为它在~/.hermes/。实现这个效果最稳的手段就是符号链接symlink。符号链接让所有硬编码路径透明解析到外部硬盘venv 感知不到任何变化hermes命令照常工作。这篇教程会给出可复制的目录结构、ln -s命令、HERMES_HOME的正确用法与禁用场景以及迁移后的启动自检和回滚验证动作适合想把 Hermes Agent 从系统盘迁到外部硬盘、又不想重装环境的用户。需要提前说明的是外部硬盘的文件系统必须是 APFS 或 Mac OS Extended (HFS)因为符号链接和 Unix 权限在 NTFS/exFAT 上支持不完整跨平台盘符挂载后经常出现权限丢失、链接失效的问题。这一点在动手前就要确认否则后面会白折腾。2. 迁移前的前置检查与 TaoToken 配置备份在动任何文件之前先把 Hermes Agent 彻底停下来并且确认外部硬盘状态。这一步看起来啰嗦但跳过它导致state.db损坏的案例非常多。Hermes 运行时会持续写会话和记忆数据库迁移过程中如果有进程还在读写数据库文件很容易写坏恢复起来很麻烦。先检查进程ps aux | grep -i hermes | grep -v grep如果有输出说明 Hermes 还在跑用官方命令停hermes stop停不掉就强制终止pkill -f hermes然后确认外部硬盘挂载情况和文件系统类型ls /Volumes/ diskutil info /Volumes/你的硬盘名 | grep File System df -h /Volumes/你的硬盘名File System那一行必须显示 APFS 或 HFS。如果是 exFAT 或 NTFS先备份数据再重新格式化为 APFS否则符号链接会失效。接下来是很多人忽略的一步备份你的 API 配置。Hermes Agent 的~/.hermes/auth.json里存着模型服务的密钥config.yaml里存着 Base URL 和默认模型。如果你用的是 TaoToken 这类聚合接入服务配置通常长这样{ base_url: https://taotoken.net/api, api_key: sk-你的密钥, model: claude-sonnet-4-5 }迁移前把auth.json和config.yaml单独复制一份到安全位置比如~/Desktop/hermes-backup/。这样即使迁移过程中出问题你也能快速恢复接入配置不用重新去控制台生成密钥。TaoToken 的密钥可以在控制台的 API Keys 页面管理接入文档里有完整的 Base URL 和模型 ID 对照表迁移后如果发现模型调用报 401多半是auth.json没跟着搬过去或者权限变了。确认外部硬盘可用空间足够。当前 Hermes 本体大约 1GB但sessions/、memories/、audio_cache/、image_cache/会持续增长建议预留至少 20GB。用df -h看一眼可用空间别等到搬到一半空间不够。最后记录一下当前版本方便迁移后对比hermes --version把版本号记下来比如v0.10.0迁移完成后要确认版本一致说明环境没被破坏。3. 可复制的迁移配置mv 搬数据 ln -s 建符号链接这一步是整篇教程的核心。先给出目标目录结构让你心里有数~/.hermes/ → 符号链接到 /Volumes/你的硬盘名/.hermes ├── hermes-agent/ (程序本体 ~1 GB) │ ├── venv/ (Python 虚拟环境, ~538 MB) │ ├── ui-tui/ (TUI 界面, ~191 MB) │ ├── node_modules/ (Node.js 依赖, ~146 MB) │ ├── skills/ (内置技能) │ └── agent/ (核心代理逻辑) ├── skills/ (自定义/学习到的技能, 会增长) ├── sessions/ (会话历史, 会增长) ├── memories/ (跨会话记忆, 会增长) ├── audio_cache/ (语音缓存, 会增长) ├── image_cache/ (图片缓存, 会增长) ├── config.yaml (配置文件) ├── SOUL.md (Agent 人格定义) ├── auth.json (API 密钥) └── state.db (状态数据库)搬数据用mvmv ~/.hermes /Volumes/你的硬盘名/.hermes为什么用mv而不是cp在同一文件系统上mv只改指针瞬间完成跨文件系统时它等价于cp rm但语义更简洁也不会留下两份数据占空间。注意目标目录名以.开头Finder 默认隐藏按Cmd Shift .可以切换显示。然后创建符号链接ln -s /Volumes/你的硬盘名/.hermes ~/.hermes验证链接是否正确ls -la ~/.hermes期望输出类似lrwxr-xr-x 1 cc staff 38 Apr 22 10:30 /Users/cc/.hermes - /Volumes/WDBlueSN5000/.hermes看到箭头指向外部硬盘就对了。关于 HERMES_HOME 环境变量这里必须说清楚不要用它来替代符号链接。Hermes 的 venv 里所有脚本 shebang 硬编码了#!/Users/你的用户名/.hermes/hermes-agent/venv/bin/python3。如果你设置export HERMES_HOME/Volumes/你的硬盘名/.hermes并直接mv目录venv 内部路径全部断裂hermes命令会报No such file or directory或者 Python 解释器找不到。符号链接让系统「以为」数据还在~/.hermes/所有硬编码路径都能正常解析这才是正确方案。那HERMES_HOME什么时候有用当你需要临时切换到一个完全独立的 Hermes 实例做测试时可以配合符号链接一起用但日常迁移场景下符号链接是唯一稳妥的选择。如果你确实想用环境变量正确做法是保留~/.hermes符号链接同时不设置HERMES_HOME让默认路径生效。如果你对外部硬盘上的目录名不满意比如想从hermes-data改成.hermes流程是停 Hermes → 删旧链接 →mv重命名 → 重建链接hermes stop 2/dev/null pkill -f hermes 2/dev/null rm ~/.hermes mv /Volumes/你的硬盘名/旧目录名 /Volumes/你的硬盘名/新目录名 ln -s /Volumes/你的硬盘名/新目录名 ~/.hermes ls -la ~/.hermes hermes --version4. 迁移后启动自检与成功结果验证符号链接建好之后先别急着跑复杂任务按顺序做几项自检确认环境完整。第一项确认hermes命令可用hermes --version期望输出v0.10.0或你迁移前记录的版本号。如果报command not found说明 PATH 里的hermes入口指向了旧路径检查which hermes通常它是个软链到~/.hermes/hermes-agent/venv/bin/hermes符号链接生效后应该能正常解析。第二项确认配置文件可读cat ~/.hermes/config.yaml能正常打印内容说明符号链接和权限都没问题。如果报Permission denied检查外部硬盘挂载时是否带了noowners选项APFS 默认不会但某些第三方挂载工具会。第三项确认 venv 内部路径解析正常~/.hermes/hermes-agent/venv/bin/python3 --version这条命令直接调用 venv 里的 Python能打印版本号说明 shebang 硬编码路径通过符号链接透明解析成功。这是判断迁移是否真正成功的关键指标。第四项跑一次模型调用验证接入配置。如果你用 TaoToken 接入可以先用模型对话页面确认密钥和模型 ID 有效再在 Hermes 里发一条测试消息hermes 你好测试一下迁移后的环境如果返回正常回复说明auth.json里的 Base URL、API Key、Model ID 三件套都正确加载了。TaoToken 的 Base URL 是https://taotoken.net/api模型 ID 要和你config.yaml里写的一致比如claude-sonnet-4-5。如果报 401去控制台的 API Keys 页面确认密钥没过期如果报模型不存在对照接入文档里的模型 ID 列表检查拼写。第五项确认数据目录可写touch ~/.hermes/.write_test rm ~/.hermes/.write_test能创建和删除文件说明写权限正常Hermes 后续写会话和记忆不会失败。五项都通过迁移就算成功了。我实测下来整个流程从停止 Hermes 到验证完成大约 5 分钟其中大部分时间花在mv跨文件系统复制上1GB 数据在 USB 3.0 硬盘上大概 30 秒。5. 常见报错排查401、local proxy failed、reading choices、OAuth迁移过程中和迁移后最容易碰到几类报错这里逐个对照排查。报错一401 Unauthorized或invalid api key这是接入配置没跟着迁移导致的。检查~/.hermes/auth.json是否存在且内容完整cat ~/.hermes/auth.json如果文件为空或不存在从你迁移前的备份里恢复。如果你用 TaoToken去控制台的 API Keys 页面重新生成一个密钥然后更新auth.json{ base_url: https://taotoken.net/api, api_key: sk-新密钥, model: claude-sonnet-4-5 }注意 Base URL 不要带末尾斜杠模型 ID 要和接入文档一致。报错二local proxy failed或connection refused这个报错通常和网络代理配置有关。Hermes 如果配置了本地代理端口迁移后代理进程可能没起来。检查config.yaml里是否有proxy相关字段如果有确认代理服务在运行。如果你没有主动配置代理把config.yaml里的 proxy 字段注释掉再试。另外确认外部硬盘挂载后路径没变符号链接指向正确。报错三reading choices或KeyError: choices这是模型返回格式不符合预期导致的常见于 Base URL 配错或者模型 ID 写成了不支持的名称。检查config.yaml里的base_url是否是https://taotoken.net/api模型 ID 是否在支持列表里。如果用的是 OpenAI 兼容格式确认请求路径拼接正确。这个报错和迁移本身无关但迁移后重新配置时容易写错。报错四OAuth相关报错或token expired如果你用 OAuth 方式登录某些模型服务迁移后 token 缓存路径变了会导致认证失败。检查~/.hermes/下是否有.oauth或credentials目录确认它们跟着搬到了外部硬盘。如果 token 过期重新走一次 OAuth 授权流程即可。注意 OAuth 回调地址可能绑定localhost确保本地端口没被占用。报错五hermes: command not found符号链接建好了但 PATH 没生效。检查which hermes如果为空说明 shell 的 PATH 里没有~/.hermes/hermes-agent/venv/bin。在~/.zshrc或~/.bashrc里加上export PATH$HOME/.hermes/hermes-agent/venv/bin:$PATH然后source ~/.zshrc重新加载。报错六外部硬盘推出后 Hermes 崩溃这是没先停 Hermes 就拔盘导致的。正确流程是hermes stop 2/dev/null pkill -f hermes 2/dev/null lsof D /Volumes/你的硬盘名/.hermes 2/dev/null diskutil eject /Volumes/你的硬盘名lsof有输出说明还有进程占用逐一 kill 掉再推出。重新插入硬盘后符号链接自动生效直接运行hermes即可。6. 回滚方案与长期使用建议迁移不是单向操作如果你后来想把数据迁回内置硬盘或者换一块外部硬盘回滚流程要清楚。回滚到内置硬盘hermes stop 2/dev/null pkill -f hermes 2/dev/null rm ~/.hermes mv /Volumes/你的硬盘名/.hermes ~/.hermes hermes --version注意rm ~/.hermes删的是符号链接本身不会删外部硬盘上的数据所以这一步是安全的。mv把数据搬回原位后~/.hermes重新变成真实目录venv 路径自然生效。换外部硬盘时先把新盘格式化为 APFS挂载后把旧盘数据rsync过去rsync -aH --infoprogress2 /Volumes/旧盘/.hermes/ /Volumes/新盘/.hermes/-aH保留权限和硬链接--infoprogress2显示总进度。复制完成后对比文件数量find /Volumes/旧盘/.hermes -type f | wc -l find /Volumes/新盘/.hermes -type f | wc -l数量一致再删旧链接、建新链接。长期使用有几点建议。第一外部硬盘尽量用 SSD机械盘跑 venv 和数据库会有明显延迟。第二养成「先停 Hermes 再拔盘」的习惯state.db损坏恢复成本很高。第三定期备份auth.json和config.yaml这两个文件很小但最关键丢了要重新配置接入。第四如果你经常在不同机器间切换可以把 Hermes 数据放在 TaoToken 的 Coding Plan 配合的云端工作区里做同步但本地符号链接方案仍然是性能最好的选择。最后提醒一句符号链接方案对 Hermes 这种自带 venv 的工具是通用解法其他类似结构的 Agent 工具迁移时也可以参考这个思路先停进程再mv数据最后ln -s建链接不要用环境变量硬指路径。
