HermesAgent数据导出步骤详解

本文详细介绍了Hermes Agent四种结构化数据导出方法——全量加密ZIP快照、模块化JSONL分项导出、底层SQLite数据库直拷贝，以及基于上下文感知的交互式选择性导出，覆盖从系统迁移、外部集成、人工审计到紧急恢复等各类实际需求，帮助用户灵活、安全、精准地持久化保存对话历史、技能记录与配置状态，真正实现数据自主可控与环境无缝流转。

如果您需要将Hermes Agent中积累的对话历史、技能记录或配置状态持久化保存或迁移至其他环境，则需执行结构化数据导出操作。以下是实现该目标的具体步骤：

一、使用内置命令导出全量状态数据

该方法通过CLI直接触发序列化流程，生成包含会话、技能、记忆索引及元配置的完整快照，输出为加密ZIP归档，适合作为迁移前基准备份。

1、在终端中执行导出命令：hermes export --output /path/to/backup/hermes-full-$(date +%Y%m%d).zip

2、确认终端返回成功提示，例如“Export completed: 327 conversations, 41 skills, 2 memory indices”

3、检查目标路径下是否生成对应时间戳命名的ZIP文件，并验证其完整性：unzip -t /path/to/backup/hermes-full-*.zip

二、按模块分项导出JSONL格式数据

该方法适用于需对接外部系统或进行人工审计的场景，将不同逻辑单元的数据分别导出为标准JSONL文件，每行一条结构化记录，便于后续ETL处理。

1、导出全部对话记录：hermes export --dataset conversations --format jsonl --output conversations.jsonl

2、导出已沉淀技能清单：hermes export --dataset skills --format jsonl --output skills.jsonl

3、导出记忆索引元数据：hermes export --dataset memories --format jsonl --output memories.jsonl

4、验证各文件首三行内容是否符合JSONL规范：head -n 3 conversations.jsonl

三、手动提取SQLite数据库原始文件

该方法绕过应用层封装，直接拷贝底层SQLite数据库文件，保留完整事务状态与未提交变更，适用于紧急恢复或底层分析需求，但不包含内存中未落盘的临时状态。

1、定位Hermes Agent主数据库路径：hermes config show --key database_path

2、确认数据库文件存在且可读：ls -lh $(hermes config show --key database_path)

3、执行安全拷贝（保留权限与时间戳）：cp -p $(hermes config show --key database_path) ./hermes-state-$(date +%s).db

4、校验源与副本SHA256一致性：sha256sum $(hermes config show --key database_path) ./hermes-state-*.db

四、通过交互式终端触发选择性导出

该方法利用Hermes Agent的实时上下文感知能力，在对话过程中动态识别当前任务关联的数据实体，并一键导出相关子集，避免全量冗余操作。

1、启动交互式终端：hermes

2、输入斜杠命令调出导出向导：/export

3、根据提示选择导出范围：输入conversations、skills或last_7d

4、确认导出路径并执行：y，等待终端显示“Exported 89 items to /home/user/hermes-export/”

理论要掌握，实操不能落！以上关于《HermesAgent数据导出步骤详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！