跳转至

会话隔离

会话机制

会话以 chatId(而非 userId)为键,每个群聊和私聊拥有独立的:

  • 工作目录 — 来自 Bot 配置
  • Claude 会话 ID — 对话历史
  • 任务状态 — 每个 chat 同时只有一个任务

会话在 24 小时 无活动后过期。

群聊行为

  • 群聊 — Bot 仅在被 @提及 时响应
  • 2 人群(1 个用户 + 1 个 Bot)— 视为私聊,无需 @提及
  • 私聊 — Bot 回复所有消息

群成员数量缓存 5 分钟,避免频繁 API 调用。

Fork 群

用户可以创建多个 2 人小群来 "fork" 一个 Bot,每个群有独立会话。这可以实现:

  • 并行对话 — 同一个 Bot 的多个独立 Claude 会话
  • 隔离上下文 — 每个 fork 有自己的对话历史和会话状态
  • 互不干扰 — 一个 fork 中的操作不影响另一个

当你需要同时处理多个任务而不想上下文混在一起时非常有用。

Bot 隔离

多 Bot 模式下(通过 bots.json),各 Bot 之间完全隔离:

  • 各自拥有独立的飞书/Telegram 应用,只接收自己的消息
  • 独立的会话存储
  • 独立的工作目录和配置