必须对~/.hermes/目录进行有策略备份：一、手动归档，用cp -r复制并验证config.yaml与.env；二、CLI导出，用hermes config export生成.tar.gz快照；三、定时脚本，通过cron自动执行压缩归档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要防止Hermes Agent配置意外丢失或损坏，确保关键配置文件完整可恢复，则必须对~/.hermes/目录下的核心文件进行有策略的备份。以下是执行配置备份与还原的具体操作步骤：
一、手动归档核心配置文件
该方法通过标准文件系统操作直接复制全部关键配置项，适用于所有部署环境，不依赖额外工具，备份结果为可验证的静态快照。
1、打开终端，切换至当前用户主目录：
cd ~
2、创建带时间戳的备份目录：
mkdir -p ~/.hermes-backup-$(date +%Y%m%d_%H%M%S)
3、将整个~/.hermes/目录递归复制到备份目录：
cp -r ~/.hermes/ ~/.hermes-backup-$(date +%Y%m%d_%H%M%S)/
4、验证备份完整性：
ls -la ~/.hermes-backup-$(date +%Y%m%d_%H%M%S)/.hermes/config.yaml ~/.hermes-backup-$(date +%Y%m%d_%H%M%S)/.hermes/.env
5、为备份目录设置只读权限以防止误修改：
chmod -R 500 ~/.hermes-backup-$(date +%Y%m%d_%H%M%S)
二、使用hermes CLI导出配置快照
该方法调用Hermes Agent内置命令生成结构化备份包，自动排除运行时状态文件（如state.db），仅保留可移植的声明式配置，适合跨环境迁移场景。
1、执行配置导出命令：
hermes config export --output ~/.hermes-config-snapshot-$(date +%Y%m%d_%H%M%S).tar.gz
2、确认输出文件存在且非空：
ls -lh ~/.hermes-config-snapshot-*.tar.gz
3、解压验证内容（可选）：
tar -tzf ~/.hermes-config-snapshot-*.tar.gz | head -n 5
4、检查导出包中是否包含config.yaml和.env两个必需文件：
tar -tzf ~/.hermes-config-snapshot-*.tar.gz | grep -E '\.(yaml|env)$'
三、自动化定时备份脚本
该方法通过cron任务定期执行压缩归档，解决人工备份遗漏问题，适用于生产环境长期值守需求，备份周期与保留策略可精确控制。
1、创建备份脚本文件：
cat > ~/hermes-backup.sh #!/bin/bash
BACKUP_DIR="$HOME/hermes-backups"
mkdir -p "$BACKUP_DIR"
TIMESTAMP=$(date +\%Y\%m\%d_\%H\%M\%S)
tar -czf "$BACKUP_DIR/hermes_$TIMESTAMP.tar.gz" -C "$HOME" ".hermes/config.yaml" ".hermes/.env"
find "$BACKUP_DIR" -name "hermes_*.tar.gz" -mtime +7 -delete
EOF
2、赋予脚本执行权限：
chmod +x ~/hermes-backup.sh
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
3、编辑当前用户crontab：
crontab -e
4、添加每日凌晨2点执行的定时任务：
0 2 * * * /home/$(whoami)/hermes-backup.sh
5、确认任务已写入：
crontab -l | grep hermes-backup.sh
四、还原配置文件的操作流程
该方法用于在配置损坏、误删或升级失败后，将已备份的配置安全恢复至运行环境，需严格区分文件覆盖与权限继承步骤，避免因权限错误导致Agent启动失败。
1、停止Hermes Agent服务：
hermes stop
2、删除当前配置目录（保留原目录结构）：
rm -rf ~/.hermes
3、解压指定备份包至原路径：
tar -xzf ~/.hermes-backup-20260417_142201.tar.gz -C ~
4、恢复~/.hermes/目录所有权与权限：
chown -R $(whoami):$(whoami) ~/.hermes
chmod 700 ~/.hermes
chmod 600 ~/.hermes/.env
5、验证关键文件可读性：
test -r ~/.hermes/config.yaml && test -r ~/.hermes/.env && echo 配置文件读取正常
五、备份敏感信息的特别防护措施
该方法聚焦于API密钥等凭证类数据的安全隔离，防止备份介质泄露引发密钥外泄，通过加密封装实现配置可用性与机密性的双重保障。
1、使用gpg对.env文件单独加密：
gpg --symmetric --cipher-algo AES256 ~/.hermes/.env
2、确认加密文件生成：
ls -l ~/.hermes/.env.gpg
3、将加密后的.env.gpg与未加密的config.yaml分别存入不同备份路径：
cp ~/.hermes/config.yaml ~/backup-safe/config/
cp ~/.hermes/.env.gpg ~/backup-encrypted/
4、设置加密备份目录权限为仅属主可访问：
chmod 700 ~/backup-encrypted
5、还原时先解密再覆盖：
gpg --decrypt ~/backup-encrypted/.env.gpg > ~/.hermes/.env
