会话
Hermes Agent 会自动将每次对话保存为一个会话。会话功能支持对话续接、跨会话搜索以及完整的对话历史管理。
会话如何工作
无论通过 CLI、Telegram、Discord、Slack、WhatsApp、Signal、Matrix 还是其他任何消息平台发起的对话，都会被完整记录为一个会话，并保留全部消息历史。会话由两个互补的系统共同追踪：
- SQLite 数据库 (
~/.hermes/state.db) — 结构化会话元数据，支持 FTS5 全文搜索 - JSONL 转录文件 (
~/.hermes/sessions/) — 原始对话转录内容，包含工具调用（网关）
SQLite 数据库中存储的内容包括：
- 会话 ID、来源平台、用户 ID
- 会话标题（唯一，可读性强的名称）
- 模型名称与配置
- 系统提示快照
- 完整的消息历史（角色、内容、工具调用、工具结果）
- Token 数量统计（输入/输出）
- 时间戳（开始时间、结束时间）
- 父会话 ID（用于触发压缩时的会话拆分）
会话来源
每个会话都会标记其来源平台：
| 来源 | 描述 |
|---|---|
cli | 交互式 CLI（hermes 或 hermes chat） |
telegram | Telegram 消息应用 |
discord | Discord 服务器或私信 |
slack | Slack 工作区 |
whatsapp | WhatsApp 消息应用 |
signal | Signal 消息应用 |
matrix | Matrix 频道和私信 |
mattermost | Mattermost 频道 |
email | 邮件（IMAP/SMTP） |
sms | 通过 Twilio 发送的短信 |
dingtalk | 钉钉消息应用 |
feishu | 飞书 / Lark 消息应用 |
wecom | 企业微信（WeCom） |
weixin | 个人微信（Weixin） |
bluebubbles | 通过 BlueBubbles macOS 服务器接入的 Apple iMessage |
homeassistant | Home Assistant 对话 |
webhook | 入站 Webhook 请求 |
api-server | API 服务请求 |
acp | ACP 编辑器集成 |
cron | 定期计划任务（cron） |
batch | 批量处理运行 |
CLI 中的会话续接
可通过 --continue 或 --resume 命令从 CLI 续接之前的会话：
继续最近一次会话
# Resume the most recent CLI session
hermes --continue
hermes -c
# Or with the chat subcommand
hermes chat --continue
hermes chat -c
此命令会从 SQLite 数据库中查找最近一次的 cli 会话，并加载其完整的对话历史。
按名称续接会话
如果你已为会话设置了标题（参见下方 会话命名），可直接按名称续接：
# Resume a named session
hermes -c "my project"
# If there are lineage variants (my project, my project #2, my project #3),
# this automatically resumes the most recent one
hermes -c "my project" # → resumes "my project #3"
续接特定会话
# Resume a specific session by ID
hermes --resume 20250305_091523_a1b2c3d4
hermes -r 20250305_091523_a1b2c3d4
# Resume by title
hermes --resume "refactoring auth"
# Or with the chat subcommand
hermes chat --resume 20250305_091523_a1b2c3d4
会话 ID 在退出 CLI 会话时显示，也可通过 hermes sessions list 查看。
续接时的对话摘要
当您续接会话时，Hermes 会在输入提示前以样式面板形式展示上次对话的简洁摘要：
恢复模式会显示一个紧凑的摘要面板，包含最近的用户与助手对话，随后返回实时输入界面。
摘要内容包括：
- 显示 用户消息（金色
●）和 助手回复（绿色◆） - 截断长消息（用户消息最多 300 字符，助手回复最多 200 字符或 3 行）
- 折叠工具调用为数量加工具名（如
[3 tool calls: terminal, web_search]） - 隐藏系统消息、工具结果及内部推理过程
- 最多显示最近 10 次交互，并以“... N 条更早的消息 ...”作为指示
- 使用 浅色样式 区分于当前活跃对话
若要禁用摘要，保持最小化的一行提示行为，请在 ~/.hermes/config.yaml 中设置：
display:
resume_display: minimal # default: full
会话 ID 格式为 YYYYMMDD_HHMMSS_<8-char-hex>，例如 20250305_091523_a1b2c3d4。您可以使用 ID 或标题进行续接——两者均适用于 -c 和 -r。
会话命名
为会话赋予人类可读的标题，以便轻松查找和续接。
自动生成标题
Hermes 在首次交流后会自动为每个会话生成一个简短描述性标题（3–7 个词）。该过程在后台线程中使用快速辅助模型完成，不会引入延迟。您在使用 hermes sessions list 或 hermes sessions browse 浏览会话时即可看到自动生成的标题。
自动命名仅对每个会话执行一次，且若您已手动设置标题，则跳过自动命名。
手动设置标题
在任意聊天会话（CLI 或网关）中使用 /title 斜杠命令：
/title my research project
标题会立即生效。如果会话尚未创建于数据库中（例如您在发送第一条消息前运行了 /title），则标题会被暂存，待会话启动后应用。
您也可以从命令行重命名现有会话：
hermes sessions rename 20250305_091523_a1b2c3d4 "refactoring auth module"
标题规则
- 唯一性 — 不能有两个会话共享相同标题
- 最大 100 个字符 — 保持列表输出清晰
- 自动清理 — 控制字符、零宽字符、RTL 覆盖等将被自动移除
- 正常 Unicode 支持良好 — 表情符号、CJK 字符、带变音符号的字符均可使用
压缩时的自动继承链
当会话上下文被压缩（通过 /compress 手动触发或自动触发）时，Hermes 会创建一个新的延续会话。若原会话有标题，新会话将自动获得编号标题：
"my project" → "my project #2" → "my project #3"
当您通过名称续接会话（hermes -c "my project"）时，系统会自动选择该继承链中最新的会话。
消息平台中的 /title 命令
/title 命令在所有网关平台（Telegram、Discord、Slack、WhatsApp）中均可用：
/title My Research— 设置会话标题/title— 显示当前标题
会话管理命令
Hermes 提供了一套完整的会话管理命令，通过 hermes sessions 实现：
列出会话
# List recent sessions (default: last 20)
hermes sessions list
# Filter by platform
hermes sessions list --source telegram
# Show more sessions
hermes sessions list --limit 50
当会话拥有标题时，输出将显示标题、预览和相对时间戳：
Title Preview Last Active ID
────────────────────────────────────────────────────────────────────────────────────────────────
refactoring auth Help me refactor the auth module please 2h ago 20250305_091523_a
my project #3 Can you check the test failures? yesterday 20250304_143022_e
— What's the weather in Las Vegas? 3d ago 20250303_101500_f
当没有会话拥有标题时，使用简化格式：
Preview Last Active Src ID
──────────────────────────────────────────────────────────────────────────────────────
Help me refactor the auth module please 2h ago cli 20250305_091523_a
What's the weather in Las Vegas? 3d ago tele 20250303_101500_f
导出会话
# Export all sessions to a JSONL file
hermes sessions export backup.jsonl
# Export sessions from a specific platform
hermes sessions export telegram-history.jsonl --source telegram
# Export a single session
hermes sessions export session.jsonl --session-id 20250305_091523_a1b2c3d4
导出文件每行包含一个 JSON 对象，包含完整的会话元数据和所有消息。
删除会话
# Delete a specific session (with confirmation)
hermes sessions delete 20250305_091523_a1b2c3d4
# Delete without confirmation
hermes sessions delete 20250305_091523_a1b2c3d4 --yes
重命名会话
# Set or change a session's title
hermes sessions rename 20250305_091523_a1b2c3d4 "debugging auth flow"
# Multi-word titles don't need quotes in the CLI
hermes sessions rename 20250305_091523_a1b2c3d4 debugging auth flow
如果目标标题已被其他会话占用，将显示错误。
清理旧会话
# Delete ended sessions older than 90 days (default)
hermes sessions prune
# Custom age threshold
hermes sessions prune --older-than 30
# Only prune sessions from a specific platform
hermes sessions prune --source telegram --older-than 60
# Skip confirmation
hermes sessions prune --older-than 30 --yes
清理操作仅删除 已结束 的会话（即显式结束或自动重置的会话）。活跃会话永远不会被清理。
会话统计信息
hermes sessions stats
输出示例：
Total sessions: 142
Total messages: 3847
cli: 89 sessions
telegram: 38 sessions
discord: 15 sessions
Database size: 12.4 MB
如需更深入的分析（Token 使用量、成本估算、工具使用分布、活动模式等），请使用 hermes insights。
会话搜索工具
Agent 内置了一个 session_search 搜索工具，利用 SQLite 的 FTS5 引擎对所有过往对话进行全文搜索。
工作原理
- FTS5 搜索匹配消息并按相关性排序
- 按会话分组，选取前 N 个（默认 3 个）唯一会话
- 加载每个会话的完整对话，截取约 10 万字符，聚焦于匹配内容
- 传入快速摘要模型生成聚焦摘要
- 返回每个会话的摘要，附带元数据和上下文
FTS5 查询语法
搜索支持标准 FTS5 查询语法：
- 简单关键词：
docker deployment - 词组：
"exact phrase" - 布尔运算：
docker OR kubernetes,python NOT java - 前缀匹配：
deploy*
使用时机
Agent 会自动被提示使用会话搜索：
"当用户提及过去对话中的内容，或你怀疑存在相关上下文时，请使用 session_search 回忆相关内容，避免让用户重复说明。"
各平台会话追踪
网关会话
在消息平台中，会话通过一个基于消息来源的确定性会话键进行标识：| 聊天类型 | 默认密钥格式 | 行为 |
|-----------|--------------------|----------|
| Telegram 私聊 | agent:main:telegram:dm:<chat_id> | 每个私聊会话一个独立会话 |
| Discord 私聊 | agent:main:discord:dm:<chat_id> | 每个私聊会话一个独立会话 |
| WhatsApp 私聊 | agent:main:whatsapp:dm:<chat_id> | 每个私聊会话一个独立会话 |
| 群组聊天 | agent:main:<platform>:group:<chat_id>:<user_id> | 当平台提供用户 ID 时，按用户区分会话 |
| 群组线程/话题 | agent:main:<platform>:group:<chat_id>:<thread_id>:<user_id> | 该线程/话题内按用户区分会话 |
| 频道 | agent:main:<platform>:channel:<chat_id>:<user_id> | 当平台提供用户 ID 时，频道内按用户区分会话 |
当 Hermes 无法获取共享聊天的参与者标识符时，将回退到该房间使用一个共享会话。
共享 vs 隔离群组会话
默认情况下，Hermes 在 group_sessions_per_user: true 中使用 config.yaml。这意味着：
- Alice 和 Bob 可以在同一个 Discord 频道中与 Hermes 对话而不会共享对话历史
- 一个用户的长时间工具密集型任务不会污染另一个用户的上下文窗口
- 中断处理也保持按用户隔离，因为运行中的代理密钥与隔离会话密钥一致
如果你希望启用一个共享的“房间大脑”，请设置：
group_sessions_per_user: false
这将使群组/频道恢复为每个房间仅一个共享会话，从而保留共享对话上下文，但也会共享 token 成本、中断状态和上下文增长。
会话重置策略
网关会话根据可配置策略自动重置：
- 空闲 — 在 N 分钟无活动后重置
- 每日 — 每天在指定时间重置
- 两者 — 以先发生者为准（空闲或每日）
- 无 — 永不自动重置
在会话自动重置前，代理会被给予一次机会保存对话中的重要记忆或技能。
具有活跃后台进程的会话，无论策略如何，都不会被自动重置。
存储位置
| 内容 | 路径 | 描述 |
|---|---|---|
| SQLite 数据库 | ~/.hermes/state.db | 所有会话元数据 + 带 FTS5 的消息 |
| 网关对话记录 | ~/.hermes/sessions/ | 每个会话的 JSONL 对话记录 + sessions.json 索引文件 |
| 网关索引 | ~/.hermes/sessions/sessions.json | 将会话密钥映射到活跃会话 ID |
SQLite 数据库采用 WAL 模式，支持多个读取者和单个写入者，非常适合网关的多平台架构。
数据库模式
state.db 中的关键表：
- sessions — 会话元数据（id、来源、user_id、模型、标题、时间戳、token 数量）。标题有唯一索引（允许 NULL 标题，但非 NULL 标题必须唯一）。
- messages — 完整的消息历史（角色、内容、tool_calls、tool_name、token_count）
- messages_fts — FTS5 虚拟表，用于跨消息内容的全文搜索
会话过期与清理
自动清理
- 网关会话根据配置的重置策略自动重置
- 重置前，代理会保存来自即将过期会话的重要记忆和技能
- 结束的会话仍保留在数据库中，直到被清理
手动清理
# Prune sessions older than 90 days
hermes sessions prune
# Delete a specific session
hermes sessions delete <session_id>
# Export before pruning (backup)
hermes sessions export backup.jsonl
hermes sessions prune --older-than 30 --yes
数据库增长缓慢（典型情况：数百个会话约 10–15 MB）。清理主要适用于移除不再需要用于搜索召回的旧对话。