先看单聊如何延续,再区分平台群聊与多 Bot 房间。
图里看过程,正文查原理与实现细节。
先确定是谁、在哪个聊天里发言,再找到对应的会话。
两点要分开:停止等控制命令可以优先处理;运行实例被释放,不等于会话历史被删除。
会话如何定位、忙时队列如何工作、重启后如何恢复,放在下方正文;这里先看消息的主路径。
压缩的主要持久化路径会换一个底层会话编号,但保留前后关联;你仍是在延续同一段对话。
与 OpenMausBot 的关键区别:前者主要在原线程内折叠内容;这里的主要路径会接出一个新段。还有原地整理的路径,详见正文。
新段继续积累后,也会重复这个过程。阈值公式、并发保护、原子提交及失败时不破坏旧段的规则,放在正文。
时间本身不是结束会话的理由。不同操作会影响不同对象,不要都理解成“清空历史”。
本地会话另有规则:本地界面消失后,会话可能被标记为结束,但记录仍在、可恢复。自动删除和自动归档默认都关闭。
结束、挂起、归档和物理删除是不同状态。具体适用范围、宽限时间和保留天数,见下方回收矩阵。
“人在平台群里用一个 Bot”和“多个 Bot 在房间里协作”,不是同一套会话组织方式。
例如 Telegram、Discord、Slack。
例外:话题线程默认共享;也可配置为整群共享会话。
房间组织成员轮流发言。
单轮补入上限: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 必须显式 discard | unknown outcome 永不自动重放 —— 把幂等性边界显式化交给人 |
sessions(元数据,title 唯一索引)、messages(全量消息,FTS5 全文索引,行带 active/compacted 归档标志)、gateway_routing(session key → 活跃会话 id 的路由索引)。WAL 模式,多读单写。sessions.json 只是路由表的遗留镜像(可关);真正的会话列表永远查库。<ns>:<platform>:<chat_type>[:<thread>][:<user>];DM 即 agent:main:telegram:dm:<chat_id> —— 一个 DM 聊天永远路由到同一个键。suspended(/stop 标记)—— 注释原话:「Only explicit suspension replaces a routed conversation; time never does.」idle_compact_after_seconds);发 API 前的 preflight(请求 token ≥ 阈值);回合内 post-tool 再查;外加 provider 超窗 400 的强制兜底(重试耗尽 fail-closed,宁可不发也不硬塞)。手动 /compress 是逃生门。threshold=0.50;窗口 < 512K 的模型强制抬高到 ≥ 0.75(raise-only floor);基数是有效输入预算(窗口 − 输出预留 maxTokens),64K 下限、退化时 85% 封顶;支持按模型子串覆盖和绝对 token 封顶。尾部保留 ≈ 阈值 × 0.20(target_ratio)。
// 伪代码:一次压缩分段(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 条 |
group_sessions_per_user=true:同一个群里,Alice 和 Bob 各自与 Bot 之间是两条完全独立的 DM 级会话(键 …:group:<chat>:<user>)—— 一个人的超长工具任务不会污染另一个人的上下文,token 成本各记各的。thread_sessions_per_user=false);平台拿不到参与者 ID 时整群回退共享;显式设 group_sessions_per_user=false 则回到「每房间一个 room brain」(共享上下文,也共享中断与成本)。
// 伪代码: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 | Hermes 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 |
| 工作区 / 文件 GC | task-workspaces 永不自动回收(连删 Bot 都留着) | per-profile SQLite 单库;auto_prune 默认关(开启才删 ended>90d),孤儿清扫只对本地/自动化会话 |
| 键 | 默认 | 作用 |
|---|---|---|
compression.threshold | 0.50 | 压缩触发比例;窗口 <512K 强制 ≥0.75 |
compression.threshold_tokens | 无 | 绝对 token 封顶,与比例阈值取低者 |
compression.target_ratio | 0.20 | 压缩时保留的尾部大小(×阈值) |
compression.idle_compact_after_seconds | 关 | 闲置墙钟触发压缩(resume 时先压再答) |
group_sessions_per_user | true | 群内每用户独立会话;false = 每房间共享一条 |
thread_sessions_per_user | false | thread/topic 默认整线程共享一条会话 |
sessions.auto_prune / retention_days | false / 90 | 删 ended 且超期的会话(lineage 整链) |
sessions.auto_archive / auto_archive_days | false / 3 | 闲置软隐藏,复活自动回归 |
sessions.orphan_end_grace_s | 300 | 本地 viewer 消失多久后孤儿 end |
sessions.max_resume_messages / max_export_messages | 20000 | 一次性载入/导出的行数上限 |
| 房间常量(代码级) | 200 / 32K / 8K / 6 | 成员 turn 窗口条数 / 字符 / 单条截断 / 最大成员数;日志保留 2× / 8× |
| 压缩租约 TTL(代码级) | 300s | compression lock 的租期与 watermark 基准 |