AI > Hermes >

Hermes Agent如何清除会话?Hermes Agent彻底清除飞书会话操作指南

2026-08-04 15:03:33 花伤情犹在

一、背景

Hermes 把所有会话都存在一个 SQLite 数据库里：

数据库路径：~/.hermes/state.db（WAL 模式，旁边还有 state.db-wal、state.db-shm 两个伴随文件）
sessions 表：会话元数据，每条会话用 source 字段标记来源平台（如 cli、telegram、discord、飞书等）
messages 表：每个会话的完整消息历史
messages_fts 等：FTS5 全文索引虚拟表，靠触发器自动跟随 messages 表变化，无需手动维护

所以「清除飞书所有会话」本质就是：删掉 source 为飞书的那批 session 及其 messages。

两个一定要先知道的限制：

source 值要先确认，大概率是 feishu，也可能是 lark，删之前务必核对，别删错平台。
CLI 的 prune 只会删「已结束」的会话，正在进行/未正常结束的会话它不动。要彻底清，要么先停 gateway 让会话结束，要么用 SQL 直接删。

另外注意：会话（session）≠ 记忆（memory）。本指南只清对话历史，不影响 Hermes 沉淀在 ~/.hermes/memory/ 下的长期记忆（MEMORY.md / USER.md 等）。

二、操作前必做

1. 停掉 gateway

避免运行中改库产生锁冲突，也让在跑的飞书会话结束：

hermes gateway stop

2. 备份数据库（三个文件一起拷）

cp ~/.hermes/state.db      ~/.hermes/state.db.bak
cp ~/.hermes/state.db-wal  ~/.hermes/state.db-wal.bak 2>/dev/null
cp ~/.hermes/state.db-shm  ~/.hermes/state.db-shm.bak 2>/dev/null

也可以用 hermes backup --quick 做一次快照式备份。

三、第一步：确认飞书的 source 值

sqlite3 ~/.hermes/state.db "SELECT source, COUNT(*) FROM sessions GROUP BY source;"

看清楚飞书那行的 source 字段值和条数。下文命令里凡是出现 feishu 的地方，都替换成你实际看到的值。

四、第二步：选一种清理方式

方式 A：CLI 命令（推荐，最简单）

hermes sessions prune 支持按平台过滤。注意 --older-than 默认是 90 天，只删 90 天前的；要清全部飞书会话（含今天的），必须设成 0。

先不加 --yes，让它显示「将删除 N 条」再核对：

hermes sessions prune --source feishu --older-than 0

条数和 source 都确认无误后，正式执行：

hermes sessions prune --source feishu --older-than 0 --yes

prune 命令参数说明：

参数	含义
`--source SOURCE`	只清理该来源的会话
`--older-than N`	删除 N 天前的会话（默认 90；填 `0` 表示包含今天，即全部）
`--yes` / `-y`	跳过确认

局限：只能删「已结束」的会话。若有残留未结束会话，改用方式 B。

方式 B：直接 SQL（最彻底，能删未结束的会话）

注意删除顺序：先删 messages，再删 sessions（messages 引用 sessions）。FTS 索引会随 messages 删除自动清理，不用管。

sqlite3 ~/.hermes/state.db <<'SQL'
DELETE FROM messages WHERE session_id IN (SELECT id FROM sessions WHERE source='feishu');
DELETE FROM sessions WHERE source='feishu';
SQL

五、第三步：重启 gateway

hermes gateway start

六、完整流程速查（推荐路径）

# 0. 停网关 + 备份
hermes gateway stop
cp ~/.hermes/state.db ~/.hermes/state.db.bak

# 1. 确认飞书 source 值与条数
sqlite3 ~/.hermes/state.db "SELECT source, COUNT(*) FROM sessions GROUP BY source;"

# 2. 预览将删除多少条（先不加 --yes）
hermes sessions prune --source feishu --older-than 0

# 3. 条数无误后正式删除
hermes sessions prune --source feishu --older-than 0 --yes

# 4.（可选）若有未结束会话残留，用 SQL 彻底清
sqlite3 ~/.hermes/state.db <<'SQL'
DELETE FROM messages WHERE session_id IN (SELECT id FROM sessions WHERE source='feishu');
DELETE FROM sessions WHERE source='feishu';
SQL

# 5. 重启网关
hermes gateway start

七、附：其他相关命令

hermes sessions list             # 列出最近会话
hermes sessions browse           # 交互式选择器，可搜索、手动挑删
hermes sessions delete <id>      # 删单个会话
hermes sessions stats            # 会话存储统计
hermes dashboard                 # 网页版管理界面，可视化管理会话

特殊情况：如果飞书是这台机器上唯一接入的平台、且想彻底重置，最省事的是直接删掉整个 state.db（连 -wal、-shm），下次启动 Hermes 会自动重建空库。但这会清掉所有平台的会话，确认没有其他平台数据要保留时才这么做。

hermes gateway stop
rm ~/.hermes/state.db ~/.hermes/state.db-wal ~/.hermes/state.db-shm
hermes gateway start

八、误删恢复

如果删错了，用之前备份的文件还原即可：

hermes gateway stop
cp ~/.hermes/state.db.bak ~/.hermes/state.db
rm -f ~/.hermes/state.db-wal ~/.hermes/state.db-shm   # 清掉可能不一致的伴随文件
hermes gateway start

到此这篇关于Hermes Agent如何清除会话?Hermes Agent彻底清除飞书会话操作指南的文章就介绍到这了,更多相关Hermes Agent清除飞书会话内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！