OpenMausBot 会话机制 · 工程师版

先看消息如何流转,再看单聊、群聊与文件怎样延续。

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

图 1一条消息,怎样接着原来的对话?

普通消息会接着当前会话聊;不会因为聊得太久就自动新开。

收到消息你在某条对话里发言
找到这条会话沿用它的历史和工作文件
准备本轮资料必要时先总结旧内容
执行并保存生成回复,保存新消息

新对话需要单独创建。定时任务等系统工作有自己的建会话入口,见下方正文。

图 2单聊变长:先总结,再继续

缩短的是下次交给模型的内容,不是把整条聊天记录删掉。

持续聊天消息越来越多
判断是否需要总结接近容量,或空闲时提前处理
旧内容变成摘要保留近期消息
继续原来的会话下次读取摘要和近期消息

这是一个循环:继续聊天 → 内容再次变多 → 再次总结。会话本身不因压缩而换一条。

默认轮首检查约在容量的 80% 触发;后台也可提前总结。防止反复压缩的条件、失败处理和执行引擎差异放在正文。

图 3群聊:同一份聊天记录,两种接续方式

大家的发言写在同一条群记录里。某个 Bot 轮到发言时,再决定如何接续自己的运行上下文。

重新开始时

共享群记录所有成员的消息放在一起
取最近 30 条作为这次对话的起点
Bot 发言回复写回群记录

上次运行还能接着用时

保留上次的上下文仅部分执行引擎支持
补入后来的消息不必重发整个窗口
Bot 继续发言回复仍写回同一份群记录

超过容量怎么办?默认达到约 90% 时重置该 Bot 的运行上下文,下一轮再从最近 30 条开始;群聊天记录不因此清空。
谁先发言?同一条群线程里排队,一次只有一个成员运行。

30 条是重新构建输入时的消息窗口,不代表可接续运行的 Bot 始终只记得 30 条。能否接续、何时失效和如何排队,见正文。

图 4不说话、归档、删除,分别会怎样?

聊天会话、运行中的模型上下文、工作文件是三种不同的东西,回收规则不能混为一谈。

只是暂时不聊

停止发消息会话闲置
会话保留不会自动关闭或另开

手动归档

归档会话收起这条对话
聊天记录保留部分事件日志可超期清理

手动删除

删除会话移除消息和事件日志
工作文件仍保留任务目录不会一起自动删除

“删除会话”不等于“清空它产生的文件”。更完整的对象与回收条件,见正文的存储与回收矩阵。

正文机制拆解

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

OpenMausBot 机制后端类比关键差异
单聊线程append-only log + 定期压实(WAL / LSM compaction)有损:压实产物是模型生成的摘要,不是精确合并
趁热总结后台 goroutine 抢在缓存 TTL 内执行与用户输入竞态,冲突即弃(乐观并发)
滞回防抖hysteresis / debounce防止不可压缩前缀被反复压实
群聊读路径消费者位点 + 最近 N 条滑动窗口位点 = 该成员上次发言处,天然滞后
暖会话长连接 keep-alive + 增量同步空闲 TTL、配置指纹变更即失效
群聊超限不清算、直接重置位点读者上下文有界,但无记忆延续
群聊调度每线程互斥队列(single-writer)同引擎同线程只保一个暖进程,后到驱逐先到
任务工作区每会话一块 scratch dir,首用即 pin无 GC:删除也不回收,泄漏式增长
cwd 选择sticky routing首轮定死,除配置变更外永不迁移

一、消息路由与会话开启

// 路由决策(简化):sticky,永不因“太长”自动换线程
threadID := in.threadID                // 客户端显式指定
if threadID == "" {
    threadID = bot.activeThreadID      // 否则落到当前活跃线程
}
ws := ensureTaskWorkspace(bot.ID, threadID)   // 幂等 mkdir -p, 0700,每轮都调
cwd := thread.pinnedCwd ?? bot.workFolder ?? ws // 首轮 pinTaskCwd 钉死后恒定

二、单聊:上下文是一条有损压实的日志

2.1 数据形态

2.2 触发时机(三处,语义不同)

时机触发条件执行方式冲突 / 失败
轮首兜底每次调模型前跑 shouldCompact同步压缩(用户可感,35–58s)总结中线程有新写入 → 放弃本轮
空闲趁热(主力)回合结束 · ≥100k tokens · 空闲3min 后后台执行;下轮必压则 10s 抢跑新消息到 → 让路;忙则 2min 重试,50min 放弃
手动API / 界面按钮(用量 ≥80% 出提示)同步内部回合,全量折叠冲突 → 报「请重试」
// shouldCompact(简化):阈值 + 滞回,双条件
func shouldCompact(th *Thread) bool {
    used := th.lastReportedTokens()          // 引擎实测;缺省 bytes/4
    limit := min(th.window*cfg.compactAt, th.window*0.90) // 默认 0.8,封顶 0.9
    if th.floor > 0 {                        // 上次压实后设的滞回下限
        return used >= th.floor*1.25 && used >= limit
    }
    return used >= limit
}

三、群聊:共享日志 + 有界读者

// 群聊每轮(简化):串行队列 + 窗口读路径
func (r *Room) turn(m Member) {
    <-r.queue                               // 每线程互斥:一次一个成员发言
    prompt := r.sysPrompt(m) + lastN(r.log, 30)  // 滑动窗口,摘要行也占额
    if s := r.warm[m]; s != nil && s.valid() {
        s.resume(deltaSince(m.lastSpoke))   // 暖会话:只补增量
    } else {
        r.warm[m] = engine.NewSession(prompt) // 冷启动:整窗重发
    }
    if used(r.warm[m]) >= 0.9*window {
        r.reset(m)                          // 重置位点,非压实
    }
}

四、存储与回收矩阵

触发线程消息事件日志task-workspaces共享 workspaces
删除会话(手动)删删保留保留
归档 + 闲置超期保留清理保留保留
删除 Bot删删保留删(含 MEMORY.md)
自动 GC——无—

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

  • 同一 threadID ⇒ 同一 cwd(首轮钉死后恒定,与执行机器无关)。
  • 线程日志只追加:压缩是追加一条 compaction 记录 + 改变重放起点,不改写历史。
  • 群成员单轮可见消息数 ≤ 30,与群聊总长无关(有界性)。
  • 单聊上下文以 ~90% 窗口为上界(触发压实),滞回保证压实频率有下限。
  • task-workspaces 目录一旦创建,系统内不存在任何删除它的路径。
  • 用户聊天线程的状态只能被手动操作(归档 / 删除)改变,不存在基于时间或用量的自动迁移。

六、配置速查

配置 / 常量默认语义
context.compactAt0.8<1 为窗口比例,≥1 为绝对 token 数;实际封顶 0.9×window
context.autoCompacttruefalse 关闭自动压缩,仅剩手动
空闲总结水位100k tokens低于此不做后台趁热总结
空闲总结时延3min / 10s常规 3min;预判下轮轮首必压则 10s 抢跑
空闲总结坚持上限50min超过即放弃(缓存已冷),留给轮首兜底;重试间隔 2min
滞回系数+25%压实后需超过 floor×1.25 才可再压
GROUP_CONTEXT_MESSAGES30群聊每成员可见窗口(代码常量,非配置)
roomCompactAt0.9群聊成员重置阈值(重置而非摘要)
暖会话空闲 TTL~10min小内存部署 ~2.5min;另有指纹失效条件
单 bot 并发线程上限16按内存折算;历史线程总数无上限

七、工程视角小结

有界性总账:单聊读者上下文有界(压实)、群聊读者上下文有界(窗口);存储全部无界(线程日志、task-workspaces、历史线程数)。
  • 有损压实是设计内的信息损失:长会话早期细节会被越压越薄——重要结论应落盘(记忆 / 文件),不要依赖超长对话的“记性”。
  • 暖会话收益依赖引擎支持(需严格恢复的原生会话);不支持时每次发言都是整窗重发,成本模型完全不同。
  • 磁盘是泄漏式增长:删会话留目录、删 Bot 也只删共享区;要干净只能定期人工清理 task-workspaces 与归档线程。
  • 并发小顶:同时运行 ≤16 线程按内存折算,小机器更低——高峰期排队是预期行为,不是故障。