换电脑前必看!Hermes 6 大核心位置备份,Skills 与 Bundles 全不丢
很多人换电脑、重装系统或切换 WSL2 环境时,第一反应就是重装 Hermes。官方安装脚本虽能一键配置 Python、Node.js 等基础环境,但重装后才发现:工具回来了,沉淀的 Skills、自定义 Bundles、API 密钥和专属配置全没了。
这些长期积累的个性化数据,才是 Hermes 的核心价值。本文手把手教你锁定 6 个关键备份位置,一条命令完成备份,新设备无缝恢复,工作流零中断。

开始教程之前,建议大家使用算力云平台(www.suanlix.com),算力云不仅有海外云主机、热门显卡GPU等产品,现在已搭建好大模型广场,汇集海内外主流大模型。
◆ 价格普惠、计费透明:平台直接对接模型厂商与顶级算力资源,价格低于行业平均水平,还为用户提供了极具性价比的token套餐,6元就能入门
◆ 统一调用,一站式管理:用户无需多个平台注册账号+充值余额,注册后一个账号、一个APIKey,即可调用所有模型,带给用户极致便捷的体验。为开发者、企业及个人用户提供高效、便捷的AI能力调用服务。
一、核心备份 6 大位置(一个都不能少)
所有核心数据均集中在 ~/.hermes/ 目录,重点锁定以下路径:
1. Skills 主目录(重中之重)
-
路径: ~/.hermes/skills/ -
内容:内置 Skill、Hub 安装 Skill、自定义 Skill(含 SKILL.md、脚本、模板) -
备份命令:
mkdir -p ~/hermes-backup-$(date +%F)tar -czf ~/hermes-backup-$(date +%F)/skills.tar.gz -C ~/.hermes skills
2. Skill Bundles(快捷组合入口)
-
路径:
~/.hermes/skill-bundles/ -
内容:自定义 Skill 组合 YAML(如 /release-prep、/doc-review 等斜杠命令)
-
备份命令:
tar -czf ~/hermes-backup-$(date +%F)/skill-bundles.tar.gz -C ~/.hermes skill-bundles
3. config.yaml(非敏感配置)
-
路径:
~/.hermes/config.yaml -
内容:Skill 路径、外部目录配置、个性化偏好
-
备份命令:
cp ~/.hermes/config.yaml ~/hermes-backup-$(date +%F)/config.yaml 2> /dev/null
4. .env(敏感密钥,安全第一)
-
路径:
~/.hermes/.env -
内容:API Key、模型密钥、Token 等敏感信息
-
备份 & 安全设置:
cp ~/.hermes/.env ~/hermes-backup-$(date +%F)/env.backup 2> /dev/nullchmod 600 ~/hermes-backup-$(date +%F)/env.backup # 仅本人可读
5. Hub taps 与状态
-
路径:
~/.hermes/.hub/taps.json、~/.hermes/skills/.hub/ -
内容:自定义 Skill 仓库 tap 记录、Hub 安装状态、日志
-
备份命令:
mkdir -p ~/hermes-backup-$(date +%F)/hubcp -a ~/.hermes/.hub ~/hermes-backup-$(date +%F)/hub/root-hub 2> /dev/nullcp -a ~/.hermes/skills/.hub ~/hermes-backup-$(date +%F)/hub/skills-hub 2> /dev/null
6. 项目内 Hermes 痕迹(易遗漏)
-
路径:项目目录下
.hermes/plans/、[AGENTS.md](AGENTS.md)、[SOUL.md](SOUL.md) -
内容:项目级计划文件、Agent 规则配置、人格设定
-
检查命令:
find . -maxdepth 3 -path "*/.hermes/*" -type f
二、一键备份脚本(懒人必备)
复制以下命令,终端一键执行,自动打包所有核心数据并生成清单:
BACKUP="$HOME/hermes-backup-$(date +%F)"mkdir -p "$BACKUP"# 备份skills[ -d "$HOME/.hermes/skills" ] && tar -czf "$BACKUP/skills.tar.gz" -C "$HOME/.hermes" skills# 备份bundles[ -d "$HOME/.hermes/skill-bundles" ] && tar -czf "$BACKUP/skill-bundles.tar.gz" -C "$HOME/.hermes" skill-bundles# 备份配置[ -f "$HOME/.hermes/config.yaml" ] && cp "$HOME/.hermes/config.yaml" "$BACKUP/config.yaml"# 备份密钥[ -f "$HOME/.hermes/.env" ] && cp "$HOME/.hermes/.env" "$BACKUP/env.backup" && chmod 600 "$BACKUP/env.backup"# 备份hub数据[ -d "$HOME/.hermes/.hub" ] && cp -a "$HOME/.hermes/.hub" "$BACKUP/root-hub"[ -d "$HOME/.hermes/skills/.hub" ] && cp -a "$HOME/.hermes/skills/.hub" "$BACKUP/skills-hub"# 生成备份清单{ echo "# Hermes Backup $(date)"echo "## Skills"find ~/.hermes/skills -name "SKILL.md" 2> /dev/null | sed "s|$HOME/||"echo "## Bundles"ls ~/.hermes/skill-bundles 2> /dev/nullecho "## Env keys"cut -d= -f1 ~/.hermes/.env 2> /dev/null } > "$BACKUP/README.md"
三、新设备恢复步骤(无缝迁移)
1. 先安装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2. 恢复核心数据
# 创建目录mkdir -p ~/.hermes# 恢复skillstar -xzf ~/hermes-backup-YYYY-MM-DD/skills.tar.gz -C ~/.hermes# 恢复bundlestar -xzf ~/hermes-backup-YYYY-MM-DD/skill-bundles.tar.gz -C ~/.hermes# 恢复配置cp ~/hermes-backup-YYYY-MM-DD/config.yaml ~/.hermes/config.yaml# 恢复密钥(务必设置权限)cp ~/hermes-backup-YYYY-MM-DD/env.backup ~/.hermes/.envchmod 600 ~/.hermes/.env
3. 校验恢复结果
hermes skills list # 查看所有Skillhermes bundles list # 查看所有Bundleshermes config show # 核对配置hermes skills check # 检查Skill完整性
四、关键注意事项
-
密钥安全:
.env严禁上传公开仓库、普通截图或聊天窗口,仅用加密 U 盘 / 本地加密备份存储。 -
路径匹配:恢复后若配置了外部 Skill 目录,需核对
config.yaml中external_dirs路径与新设备一致。 -
依赖完整性:Bundles 仅存 Skill 组合引用,恢复时必须同步备份
skills/目录,否则会出现 Skill 缺失。 -
版本适配:建议新旧设备保持 Hermes 版本一致,避免因版本差异导致配置不兼容。
五、总结
Hermes 可以重装,但你沉淀的 Skill、Bundles 和专属配置无法重来。换设备前,锁定这 6 个位置,一键备份,新设备即可无缝衔接,让你的 AI 工作流持续在线,无需从零开始。