/save 一键导出会话：JSON、Markdown、HTML 三种格式，聊天里也能直接收文件

周五下午，你花了三个小时让 Hermes 帮你排查一个线上问题——翻日志、改配置、来回试了十几轮，终于搞定。这时候你最想做的事，是把这段“破案过程”整理成文档发给同事，或者存进自己的知识库。可如果只能一屏一屏地截图，那这份宝贵的经验就永远烂在终端里了。其实不用这么麻烦：Hermes 自带的 /save 命令，一句话就能把整个会话导出成文件，JSON、Markdown、HTML 任你选，还能顺手把里面的密钥擦干净。

/save 是什么

/save 是 Hermes 的会话内导出命令：在当前会话里敲一下，它就把这段对话完整地保存成文件。默认的 JSON 快照形式很早就有了，而最近的一次升级（2026 年 8 月中旬合并进主分支的 PR #86806）把它变成了一个跨平台的全能导出器：

  • /save json —— 完整会话快照，包含消息、工具调用、元数据，是机器可读的“原始档案”，适合备份和迁移；
  • /save md —— 可读的 Markdown 转录稿，直接就能粘进文档、笔记或者发给同事；
  • /save html —— 独立的单文件 HTML 页面，打开浏览器就能看，没有任何依赖，分享给别人最方便。

三种格式覆盖了“备份”“阅读”“分享”三个最常见的需求。而且它不止在终端里能用：在 Telegram、Discord、Slack 这些聊天平台上，直接对 agent 发一句 /save md，它会用文件的形式把导出结果发回聊天里——手机上也能轻松拿到完整记录。

怎么用：几个命令搞定

在终端会话里，用法是：

/save <json|md|html> [文件名] [redact]

几个实际例子：

/save                  # 不带参数时，显示完整的用法说明
/save json             # 导出完整快照，自动命名，存到 ~/.hermes/sessions/saved/
/save md               # 导出 Markdown 转录稿
/save html my-report.html   # 指定文件名，导出单文件 HTML
/save json backup redact    # 导出前强制擦除 API key 等敏感信息

细节说明：文件名可以随便起，它只取最后一段路径，不用担心被塞进奇怪的路径；不指定文件名时会自动命名。CLI 里导出的文件默认保存在 ~/.hermes/sessions/saved/ 目录下。

redact：导出之前，先擦干净

会话里经常混着 API key、token、密码这类敏感信息——排查问题时贴过配置、配过密钥，这些内容都会留在对话记录里。如果直接导出分享，等于把钥匙交了出去。

/save 的 redact 参数就是干这个的：导出前会先跑一遍强制脱敏（force-mode secret redaction），把看起来像密钥、令牌、口令的内容替换掉再写文件。Hermes 本身默认就开启了 security.redact_secrets 对工具输出做脱敏，而 /save redact 是在导出环节再补一道保险。分享给别人的时候，养成加 redact 的习惯，能省掉不少麻烦。

进阶：CLI 批量导出和其他导出方式

如果你要导出的不止当前这一个会话，可以用 CLI 命令 hermes sessions export，它支持一次导出多个会话：

# 导出为 JSONL（默认格式）
hermes sessions export backup.jsonl

# 导出为 Markdown 到指定目录
hermes sessions export out/ --format md

# 导出为 Claude Code 格式的 trace，并上传到 Hugging Face Trace Viewer
hermes sessions export --format trace --upload

--format 支持 jsonl、md、qmd、html、trace 五种；其中 trace 是 Claude Code 的 JSONL 格式，可以配合 --upload 直接传到 Hugging Face 的 Agent Trace Viewer 做可视化分析（需要配置 HF_TOKEN），--no-redact 可以跳过强制脱敏——只在你手动检查过内容之后再用。

另外注意别把 /save 和 /export 搞混：/save 导出的是当前会话，而 /export 导出的是整个 profile（配置、技能、主题打包成一个 tar.gz 归档，用于迁移和分享环境），两者用途完全不同。

几个值得知道的点

  • 导出不影响会话本身：每一条消息其实都已经实时存进了本地的 SQLite 会话数据库，导出只是生成一份快照，会话随时还能用 hermes --resume <id> 恢复，不用担心“导出即销毁”。
  • 跨平台的 json/md/html 是新功能：完整的三种格式导出是在 2026 年 8 月 15 日合并到主分支的新增强，v0.20.1 及更早的正式版本里 /save 还只有 CLI 端的 JSON 快照。跑一次 hermes update 更新到最新版（或者等下一个正式版本 v0.21.0），就能用上完整能力。
  • 怎么选格式：要留档、要迁移、要给工具处理，选 json；要读、要贴文档，选 md；要发给别人用浏览器打开，选 html。

总结

/save 是那种“平时想不起来，用一次就回不去”的小命令：调试完顺手导出存档，开会前把会话转成 Markdown 贴进文档，排查记录用 HTML 发给同事。配合 redact 擦密钥、配合聊天平台直接收文件，它把“会话里积累的知识”从终端里解放了出来——存档、整理、分享、迁移恢复，都变得像发一条消息一样简单。想了解更多命令细节，可以看看会话管理命令参考，或者我们网站上的 v0.20.0 发布说明。