hermes sessions 命令 — 完整参考与示例

概述

hermes sessions 用于查看和管理 SQLite 会话存储。你可以列出、浏览、导出、删除、清理、归档、修复和优化 Hermes 保存的对话。

hermes sessions <list|browse|export|delete|prune|archive|optimize|clean-markers|optimize-storage|repair|recover|stats|rename|retitle-skills>

子命令

list — 列出最近会话

hermes sessions list
hermes sessions list --limit 20
hermes sessions list --source telegram
hermes sessions list --workspace /path/to/project

browse — 交互式会话选择器

hermes sessions browse
hermes sessions browse --limit 100

export — 导出会话

hermes sessions export --format md ./exports
hermes sessions export --session-id abc123 --format jsonl -
hermes sessions export --older-than 30d --format md --yes

格式：jsonl、md、qmd、html、trace。支持多种过滤条件（标题、来源、模型、费用、token、工具调用等）。

delete — 删除特定会话

hermes sessions delete abc123
hermes sessions delete abc123 --yes

prune — 按条件清理旧会话

hermes sessions prune
hermes sessions prune --older-than 90d
hermes sessions prune --source cli --keep 50 --dry-run

未提供过滤条件时，默认删除 90 天前的会话。

archive — 软隐藏会话而不删除

hermes sessions archive --older-than 30d --dry-run
hermes sessions archive --title "legacy" --yes

optimize — 回收磁盘空间（不改变数据）

hermes sessions optimize

合并 FTS5 段并对数据库执行 VACUUM。不更改任何对话内容。

clean-markers — 修复残留的工具调用标记

hermes sessions clean-markers --dry-run
hermes sessions clean-markers --yes

optimize-storage — 将搜索索引重建为紧凑的 v23 布局

hermes sessions optimize-storage --yes
hermes sessions optimize-storage --no-vacuum

repair — 修复损坏的 state.db 结构

hermes sessions repair --check-only
hermes sessions repair --no-backup

recover — 对损坏的数据库进行离线恢复

hermes sessions recover --source state.db --output recovered.db
hermes sessions recover --source state.db --inspect-only

选项：--source、--output、--inspect-only、--work-dir、--chunk-size、--allow-partial、--report。

stats — 显示会话存储统计

hermes sessions stats

rename — 设置或修改会话标题

hermes sessions rename abc123 "API 设计会话"

retitle-skills — 为 /skill 会话重新生成标题

hermes sessions retitle-skills --dry-run
hermes sessions retitle-skills --apply --limit 200

常见场景

查找并导出会话

hermes sessions list --limit 50
hermes sessions export --session-id abc123 --format md ./exports

定期清理

hermes sessions prune --older-than 90d --yes
hermes sessions optimize

修复显示为空的数据库

hermes sessions repair --check-only
hermes sessions repair

从损坏的备份中恢复

hermes sessions recover --source ~/.hermes/backups/state.db --output ~/.hermes/recovered.db --allow-partial

技巧

• export 默认格式为 jsonl；md 适合人工阅读，trace 可用于 Claude Code trace viewer。
• 无过滤条件时 prune 默认删除 90 天前的会话；先用 --dry-run 预览。
• archive 只是隐藏会话，释放空间不如 delete 或 prune。
• repair 和 recover 默认都会备份；仅在可接受风险时使用 --no-backup。
• retitle-skills 适用于大量会话因 /skill 展开内容而被自动命名为技能内容而非用户请求的场景。