Hermes Agent 会话机制 · 工程师版

先看单聊如何延续,再区分平台群聊与多 Bot 房间。

图里看过程,正文查原理与实现细节。

图 1一条消息,怎样找到自己的会话?

先确定是谁、在哪个聊天里发言,再找到对应的会话。

收到消息来自单聊或平台群聊
找到对应会话已有就复用,没有再创建
等待轮到这条消息同一会话忙时按顺序排队
执行并保存必要时先总结,再回复

两点要分开:停止等控制命令可以优先处理;运行实例被释放,不等于会话历史被删除。

会话如何定位、忙时队列如何工作、重启后如何恢复,放在下方正文;这里先看消息的主路径。

图 2单聊变长:旧段封存,新段接着聊

压缩的主要持久化路径会换一个底层会话编号,但保留前后关联;你仍是在延续同一段对话。

原会话持续积累内容逐渐接近处理上限
总结旧内容保留摘要和近期消息
封存旧段原始历史仍可追溯
新段接着聊带上摘要,关联旧段

与 OpenMausBot 的关键区别:前者主要在原线程内折叠内容;这里的主要路径会接出一个新段。还有原地整理的路径,详见正文。

新段继续积累后,也会重复这个过程。阈值公式、并发保护、原子提交及失败时不破坏旧段的规则,放在正文。

图 3什么时候续聊,什么时候翻篇?

时间本身不是结束会话的理由。不同操作会影响不同对象,不要都理解成“清空历史”。

闲置、跨天或网关重启

原会话暂时没有运行执行实例可能已经释放
下次消息恢复会话不会仅因时间过去而翻篇

主动另开对话

/new 或 /reset给当前对话划出新边界
后续进入新会话不会跨边界捞回旧会话

停止当前工作

/stop中止并留下挂起标记
下次访问再重置不是普通的闲置超时

本地会话另有规则:本地界面消失后,会话可能被标记为结束,但记录仍在、可恢复。自动删除和自动归档默认都关闭。

结束、挂起、归档和物理删除是不同状态。具体适用范围、宽限时间和保留天数,见下方回收矩阵。

图 4官方支持群聊,但有两种不同形态

“人在平台群里用一个 Bot”和“多个 Bot 在房间里协作”,不是同一套会话组织方式。

平台群聊 · 人与 Bot 交谈

例如 Telegram、Discord、Slack。

群里有人发消息系统区分群、用户和话题
默认按用户分会话同群不同人通常各聊各的
沿用单聊生命周期持续聊天,必要时压缩

例外:话题线程默认共享;也可配置为整群共享会话。

Bot Mode 房间 · 多个 Bot 协作

房间组织成员轮流发言。

轮到某个 Bot每个成员有自己的会话
补入它没看过的消息只取有上限的一段
在自己的会话里继续变长后仍走单聊压缩流程

单轮补入上限:200 条或 32,000 字符,先到为准。超长单条也会截断。

左侧的群只是定位会话的条件;右侧的房间会调度多个 Bot。两者都不能套用 OpenMausBot 群聊“超限直接重置”的规则。

〇、心智模型:先映射到你熟悉的概念

Hermes 机制后端类比
gateway_routing 表(key → 活跃会话)消费者组位点 / sticky 路由表:消息通道只认 key,表告诉你写到哪个分区头
压缩 = 分段 rotation(parent ended + child 发布)WAL 压实 / log rotation:旧段封存只读,写入切到新段,链式指针 = lineage
lineage(parent_session_id 链)分代日志的 segment 链;GC、prune、archive 都以「整链」为生命周期单位
compression lease(TTL 300s + watermark + fencing)单写者租约 + fence token:僵尸压缩者对旧代次的提交会被拒绝
pending FIFO + 控制命令旁路串行工作队列 + 带外控制信道(/stop /new 类比 SIGINT 优先级)
Agent 缓存 TTL/LRU 驱逐热缓存与持久态分离:cache miss 只是重建成本,绝不等于数据删除
成员 turn 的 since-my-last-turn 增量窗口每个消费者维护独立 offset 的 pull 模型(对比 OpenMausBot 的全局 30 条滑窗 push)
崩溃恢复按「最近实际活动」仲裁read-repair:用事实时间戳裁决,不信任任何时钟假设;尊重显式重置边界
中断 turn 必须显式 discardunknown outcome 永不自动重放 —— 把幂等性边界显式化交给人

一、单聊:路由、创建与忙时行为

1. 存储:每 profile 一个 SQLite 状态库

2. 会话键:确定性纯函数

3. 路由转换:两阶段提交式的「检查 + 落定」

4. 忙时:FIFO 排队,不合并

二、压缩循环:分段压实,而非原地折叠

// 伪代码:一次压缩分段(Go 风格)
func maybeCompress(a *Agent, reqTokens int) {
    thr := threshold(a.Model) // clamp((window-maxTokens)*pct, 64K, 0.85*window); pct=0.50,小窗≥0.75
    if reqTokens < thr { return }
    lease := acquireCompressionLock(a.SessionID, ttl=300*time.Second) // watermark + fence
    summary, err := summarize(a.Tail(fraction=0.20))
    if err != nil {
        switch classOf(err) { // quota|network|empty → abort;overload|timeout → cooldown+retry
        default: cooldown(a.SessionID); antiThrash.Bump(a.SessionID)
        }
        return
    }
    tx() { // 单事务 rotate
        flushTo(a.SessionID)
        end(a.SessionID, reason="compression")
        child := publishChild(parent=a.SessionID, summary, compacted,
                              lineage=a.SessionID)
        a.rebind(child) // 新前缀从此固定
    }
}

三、终局与回收矩阵

对象 / 场景谁负责结束默认
gateway 消息会话(Telegram/Discord/… DM 与群)只有 /new、/reset、压缩分段、显式 delete永不闲置重置、永不跨天重置
本地 CLI / TUI / Desktop 会话viewer 消失 > orphan_end_grace_s(300s)→ 孤儿 end;重启清扫不早于最后活动 6h非破坏:行只是 ended,消息一来同 id 复活
自动化来源会话(cron / kanban / 子代理 / 一次性 CLI)auto-prune 扫描时顺手关闭超期孤儿仅当 auto_prune 开启
sessions.auto_prune删 ended 且闲置 > retention_days(90 天)的会话,lineage 整链评估;24h 至多一次关(磁盘吃紧时会主动问你一次 /autoprune)
VACUUM 回收磁盘删过行之后:距上次 ≥ 30 天 且 空闲页 > 25% 才重写库文件双门槛节流
sessions.auto_archive闲置 > 3 天软隐藏(不删,搜索保留,复活自动回归)关
ACTIVE 会话 / pinned / 压缩进行中—永不被自动删除或关闭
超大 transcript 防护max_resume_messages / max_export_messages 拒绝一次性载入各 20000 条

四、群聊:一个 Bot 的会话生命周期(两种官方形态)

形态 A · 平台群聊 —— 群只是路由的一个维度

形态 B · Bot Mode 房间 —— 真正的多 Bot 编排器

// 伪代码:hosted room 的成员 turn(Go 风格)
func memberTurn(room *Room, m *Bot) {
    if !room.lease.ValidFor(m.epoch) { return } // 旧 epoch 禁止提交(fencing)
    delta := room.Log.Since(m.lastTurnSeq)          // per-consumer offset
    win := fitWindow(delta, msgs=200, chars=32_000, lineCap=8_000)
    turn(m.sessionFor(room), win)                   // 成员自己的普通会话 → 压缩循环
    room.Commit(task{IdempotencyKey: m.turnKey()})  // 串行 drive · 幂等提交
    m.lastTurnSeq = win.lastSeq                     // 位点前移
}

五、与 OpenMausBot 对照(同一读者视角)

维度OpenMausBotHermes Agent
单聊会话形态thread 钉死 + 折叠循环(同一条对话内 kind=compaction 总结 + 保留尾部)sticky 路由键 + 分段 rotation(parent ended / child 新生,lineage 链)
压缩触发轮首 ≥80% 兜底 + 空闲 3min 趁热总结(主力)+ 手动turn 首 idle(opt-in)/ preflight ≥50%(小窗 ≥75%)+ post-tool + overflow 兜底 + /compress
缓存友好性趁 prompt 缓存还热时提前压缩「缓存神圣」写进开发不变式:压缩是唯一改前缀的例外;refresh-prompts 明码标价一次 cache miss
闲置/跨天重置单聊无;群聊成员 90% 直接重置一律无 ——「time never does」;旧 idle/daily 重置降级为可选插件
群聊模型共享黑板:全群一条 transcript,成员每次读最近 30 条滑窗,短时暖会话做增量A) 路由维度:默认群内每用户独立会话,thread 默认共享;B) 房间编排器:成员各自持会话 + since-last-turn 增量窗口(200 条 / 32K)
群聊成员上下文天然有界(30 条),超限重置轮次输入有界,会话本体无界(走压缩循环)
多 Bot 编排群内 room queue 轮流发言,同引擎一线程互斥SQLite 租约 + epoch fencing 串行 drive,排队 / hold / release 语义丰富
崩溃恢复总结冲突即弃;对话本身不丢按最近实际活动仲裁 + 尊重重置边界;中断 turn 结果未知须显式 discard
工作区 / 文件 GCtask-workspaces 永不自动回收(连删 Bot 都留着)per-profile SQLite 单库;auto_prune 默认关(开启才删 ended>90d),孤儿清扫只对本地/自动化会话

六、不变式(理解机制的锚点)

  • 时间永不重置会话:唯一自动替换路由的是 /stop 留下的 suspended 标记;闲置、跨天、重启都不是边界。
  • prompt 缓存神圣:会话前缀字节不变;压缩(分段 rotation)是唯一例外,新段前缀随即固定。
  • 会话身份原子写:建行即写全路由身份;恢复以最近实际活动仲裁并尊重 /new 边界(read-repair 而非时钟信任)。
  • 缓存 ≠ 持久态:agent 实例被驱逐、网关重启,durable 会话原样在库;下一个消息原 id 复活。
  • 删除只发生在 ended 之上:ACTIVE / pinned / 压缩中的会话永不被自动删;lineage 整链是 prune 与 archive 的评估单位。
  • 房间 drive 单写者:lease generation + epoch fencing,过期代次禁止提交;成员 turn 输入永远有界(200 条 / 32K / 单条 8K)。
  • unknown outcome 显式化:中断 turn 永不自动重放,须 discard 确认才解锁会话。

七、配置速查

键默认作用
compression.threshold0.50压缩触发比例;窗口 <512K 强制 ≥0.75
compression.threshold_tokens无绝对 token 封顶,与比例阈值取低者
compression.target_ratio0.20压缩时保留的尾部大小(×阈值)
compression.idle_compact_after_seconds关闲置墙钟触发压缩(resume 时先压再答)
group_sessions_per_usertrue群内每用户独立会话;false = 每房间共享一条
thread_sessions_per_userfalsethread/topic 默认整线程共享一条会话
sessions.auto_prune / retention_daysfalse / 90删 ended 且超期的会话(lineage 整链)
sessions.auto_archive / auto_archive_daysfalse / 3闲置软隐藏,复活自动回归
sessions.orphan_end_grace_s300本地 viewer 消失多久后孤儿 end
sessions.max_resume_messages / max_export_messages20000一次性载入/导出的行数上限
房间常量(代码级)200 / 32K / 8K / 6成员 turn 窗口条数 / 字符 / 单条截断 / 最大成员数;日志保留 2× / 8×
压缩租约 TTL(代码级)300scompression lock 的租期与 watermark 基准

八、工程视角小结

一句话:Hermes 的单聊会话 = 「键路由 + 分段压实的无限日志」,终局只认显式事件;群聊 = 「路由维度(每用户独立会话)」与「房间编排器(成员各持会话、吃有界增量、租约串行)」两个正交形态 —— 与 OpenMausBot 的「折叠循环 + 共享黑板滑窗」恰好构成两种可对照的工程取舍。