会话

Hermes Agent 自动将每次对话保存为会话。会话支持对话恢复、跨会话搜索和完整的对话历史管理。

会话如何工作

每次对话 —— 无论是来自 CLI、Telegram、Discord、Slack、WhatsApp、Signal、Matrix 还是任何其他消息平台 —— 都作为会话存储，包含完整的消息历史。会话在两个互补系统中跟踪：

SQLite 数据库 (~/.hermes/state.db) —— 结构化会话元数据，带 FTS5 全文搜索
JSONL 转录本 (~/.hermes/sessions/) —— 原始对话转录本，包括工具调用（网关）

SQLite 数据库存储：

会话 ID、来源平台、用户 ID
会话标题（唯一、人类可读的名称）
模型名称和配置
系统提示快照
完整消息历史（角色、内容、工具调用、工具结果）
令牌计数（输入/输出）
时间戳（started_at、ended_at）
父会话 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 的 SMS
`dingtalk`	DingTalk 信使
`feishu`	Feishu/Lark 信使
`wecom`	企业微信
`weixin`	微信（个人微信）
`bluebubbles`	通过 BlueBubbles macOS 服务器的 Apple iMessage
`homeassistant`	Home Assistant 对话
`webhook`	传入 webhooks
`api-server`	API 服务器请求
`acp`	ACP 编辑器集成
`cron`	定时 cron 作业
`batch`	批处理运行

CLI 会话恢复

使用 --continue 或 --resume 从 CLI 恢复之前的对话：

继续上次会话

bash

# 恢复最近的 CLI 会话
hermes --continue
hermes -c

# 或使用 chat 子命令
hermes chat --continue
hermes chat -c

这会从 SQLite 数据库中查找最近的 cli 会话并加载其完整的对话历史。

按名称恢复

如果您给会话起了标题（见下面的会话命名），您可以按名称恢复它：

bash

# 按名称恢复会话
hermes -c "my project"

# 如果有谱系变体（my project、my project #2、my project #3），
# 这会自动恢复最近的一个
hermes -c "my project"   # → 恢复 "my project #3"

恢复特定会话

bash

# 通过 ID 恢复特定会话
hermes --resume 20250305_091523_a1b2c3d4
hermes -r 20250305_091523_a1b2c3d4

# 按标题恢复
hermes --resume "refactoring auth"

# 或使用 chat 子命令
hermes chat --resume 20250305_091523_a1b2c3d4

会话 ID 在您退出 CLI 会话时显示，可以使用 hermes sessions list 找到。

恢复时的对话回顾

恢复会话时，Hermes 会在输入提示之前在一个样式面板中显示之前对话的紧凑回顾：

恢复模式显示一个紧凑的回顾面板，包含最近的助手和用户轮次，然后将您返回到实时提示。

回顾：

显示用户消息（金色 ●）和助手响应（绿色 ◆）
截断长消息（用户 300 字符，助手 200 字符 / 3 行）
折叠工具调用为计数和工具名称（例如 [3 个工具调用：terminal, web_search]）
隐藏系统消息、工具结果和内部推理
限制为最后 10 次交换，带有 "... N 条更早的消息 ..." 指示器
使用暗淡样式以区别于活跃对话

要在 ~/.hermes/config.yaml 中禁用回顾并保持最小的一行行为，请设置：

yaml

display:
  resume_display: minimal   # 默认值：full

提示

会话 ID 遵循格式 YYYYMMDD_HHMMSS_<8-char-hex>，例如 20250305_091523_a1b2c3d4。您可以通过 ID 或标题恢复 —— 两者都适用于 -c 和 -r。

会话命名

给会话起人类可读的标题，以便您可以轻松找到和恢复它们。

自动生成标题

Hermes 在第一次交换后自动为每个会话生成一个简短的描述性标题（3–7 个词）。这在后台线程中使用快速的辅助模型运行，因此不会增加延迟。使用 hermes sessions list 或 hermes sessions browse 浏览会话时，您会看到自动生成的标题。

如果您已经手动设置了标题，则自动标题不会触发。

手动设置标题

在任何聊天会话中使用 /title 斜杠命令（CLI 或网关）：

/title my research project

标题立即应用。如果会话尚未在数据库中创建（例如，您在发送第一条消息之前运行 /title），它会被排队并在会话开始后应用。

您还可以从命令行重命名现有会话：

bash

hermes sessions rename 20250305_091523_a1b2c3d4 "refactoring auth module"

标题规则

唯一 —— 没有两个会话可以共享相同的标题
最多 100 个字符 —— 保持列表输出简洁
已清理 —— 自动去除控制字符、零宽字符和 RTL 覆盖
正常 Unicode 没问题 —— emoji、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 提供一套完整的会话管理命令：

列出会话

bash

# 列出最近的会话（默认：最近 20 个）
hermes sessions list

# 按平台筛选
hermes sessions list --source telegram

# 显示更多会话
hermes sessions list --limit 50

当会话有标题时，输出显示标题、预览和相对时间戳：

标题                  预览                                  最后活动   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

当没有会话有标题时，使用更简单的格式：

预览                                            最后活动   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

导出会话

bash

# 将所有会话导出到 JSONL 文件
hermes sessions export backup.jsonl

# 导出特定平台的会话
hermes sessions export telegram-history.jsonl --source telegram

# 导出单个会话
hermes sessions export session.jsonl --session-id 20250305_091523_a1b2c3d4

导出的文件每行包含一个 JSON 对象，包含完整的会话元数据和所有消息。

删除会话

bash

# 删除特定会话（带确认）
hermes sessions delete 20250305_091523_a1b2c3d4

# 无需确认删除
hermes sessions delete 20250305_091523_a1b2c3d4 --yes

重命名会话

bash

# 设置或更改会话的标题
hermes sessions rename 20250305_091523_a1b2c3d4 "debugging auth flow"

# 多词标题在 CLI 中不需要引号
hermes sessions rename 20250305_091523_a1b2c3d4 debugging auth flow

如果标题已被另一个会话使用，会显示错误。

修剪旧会话

bash

# 删除 90 天前的已结束会话（默认）
hermes sessions prune

# 自定义年龄阈值
hermes sessions prune --older-than 30

# 仅修剪特定平台的会话
hermes sessions prune --source telegram --older-than 60

# 跳过确认
hermes sessions prune --older-than 30 --yes

信息

修剪仅删除已结束的会话（已明确结束或自动重置的会话）。活跃会话永远不会被修剪。

会话统计

bash

hermes sessions stats

输出：

总会话数: 142
总消息数: 3847
  cli: 89 个会话
  telegram: 38 个会话
  discord: 15 个会话
数据库大小: 12.4 MB

有关更深入的分析 —— 令牌使用、成本估算、工具分解和活动模式 —— 使用 hermes insights。

会话搜索工具

智能体有一个内置的 session_search 工具，使用 SQLite 的 FTS5 引擎对所有过去的对话执行全文搜索。

工作原理

FTS5 搜索按相关性排名的匹配消息
按会话分组，取前 N 个唯一会话（默认 3 个）
加载每个会话的对话，截断为以匹配为中心的约 100K 字符
发送到快速摘要模型进行重点摘要
返回带有元数据和周围上下文的每个会话摘要

FTS5 查询语法

搜索支持标准 FTS5 查询语法：

简单关键词：docker deployment
短语："exact phrase"
布尔：docker OR kubernetes，python NOT java
前缀：deploy*

何时使用

智能体会被提示自动使用会话搜索：

"当用户引用过去对话中的内容或您怀疑存在相关的先前上下文时，使用 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 无法获取共享聊天的参与者标识符时，它会回退到该房间的一个共享会话。

共享与隔离的群组会话

默认情况下，Hermes 在 config.yaml 中使用 group_sessions_per_user: true。这意味着：

Alice 和 Bob 可以在同一个 Discord 频道中与 Hermes 交谈，而不共享转录历史
一个用户的长时间工具密集型任务不会污染另一个用户的上下文窗口
中断处理也保持每个用户，因为 running-agent 键与隔离的会话键匹配

如果您想要一个共享的"房间大脑"，请设置：

yaml

group_sessions_per_user: false

这将群组/频道回退到每个房间的单个共享会话，保留共享的对话上下文，但也共享令牌成本、中断状态和上下文增长。

会话重置策略

网关会话基于可配置策略自动重置：

idle —— 不活动 N 分钟后重置
daily —— 每天特定小时重置
both —— 以先发生的为准（空闲或每日）
none —— 永不自动重置

在会话自动重置之前，智能体会被给予一个机会来保存对话中的任何重要记忆或技能。

有活跃后台进程的会话无论策略如何都不会自动重置。

存储位置

内容	路径	描述
SQLite 数据库	`~/.hermes/state.db`	所有会话元数据 + 带 FTS5 的消息
网关转录本	`~/.hermes/sessions/`	每个会话的 JSONL 转录本 + sessions.json 索引
网关索引	`~/.hermes/sessions/sessions.json`	将会话键映射到活跃会话 ID

SQLite 数据库使用 WAL 模式进行并发读取和单写入，这非常适合网关的多平台架构。

数据库模式

state.db 中的关键表：

sessions —— 会话元数据（id、source、user_id、model、title、timestamps、token counts）。标题有唯一索引（允许 NULL 标题，只有非 NULL 必须唯一）。
messages —— 完整消息历史（role、content、tool_calls、tool_name、token_count）
messages_fts —— 用于跨消息内容全文搜索的 FTS5 虚拟表

会话过期和清理

自动清理

网关会话根据配置的重置策略自动重置
重置前，智能体保存过期会话中的记忆和技能
已结束的会话保留在数据库中直到被修剪

手动清理

bash

# 修剪 90 天前的会话
hermes sessions prune

# 删除特定会话
hermes sessions delete <session_id>

# 修剪前导出（备份）
hermes sessions export backup.jsonl
hermes sessions prune --older-than 30 --yes

提示

数据库增长缓慢（典型：数百个会话 10-15 MB）。修剪主要用于删除您不再需要搜索回忆的旧对话。

会话 ​

会话如何工作 ​

会话来源 ​

CLI 会话恢复 ​

继续上次会话 ​

按名称恢复 ​

恢复特定会话 ​

恢复时的对话回顾 ​

会话命名 ​

自动生成标题 ​

手动设置标题 ​

标题规则 ​

压缩时的自动谱系 ​

消息平台中的 /title ​

会话管理命令 ​

列出会话 ​

导出会话 ​

删除会话 ​

重命名会话 ​

修剪旧会话 ​

会话统计 ​

会话搜索工具 ​

工作原理 ​

FTS5 查询语法 ​

何时使用 ​

每个平台的会话跟踪 ​

网关会话 ​

共享与隔离的群组会话 ​

会话重置策略 ​

存储位置 ​

数据库模式 ​

会话过期和清理 ​

自动清理 ​

手动清理 ​

会话

会话如何工作

会话来源

CLI 会话恢复

继续上次会话

按名称恢复

恢复特定会话

恢复时的对话回顾

会话命名

自动生成标题

手动设置标题

标题规则

压缩时的自动谱系

消息平台中的 /title

会话管理命令

列出会话

导出会话

删除会话

重命名会话

修剪旧会话

会话统计

会话搜索工具

工作原理

FTS5 查询语法

何时使用

每个平台的会话跟踪

网关会话

共享与隔离的群组会话

会话重置策略

存储位置

数据库模式

会话过期和清理

自动清理

手动清理