系统模型

本页讲解 Alice 背后的基本概念：多 bot 架构、场景路由、session 和启动模式。理解这些有助于你高效配置和排错。

Alice 是什么（以及不是什么）

Alice 是一个连接器，而非 bot 框架。它不直接实现聊天逻辑、NLU 或自定义集成。实际上，它：

从飞书接收消息
决定调用哪个 LLM 后端以及如何调用
以子进程方式调用 LLM CLI
将响应发回飞书

"智能"部分在 LLM 后端（Codex、Claude 等）。Alice 处理"管道"工作：路由、排队、session 管理、附件 I/O 和进度展示。

多 Bot 模型

一个 alice 进程可以通过一份 config.yaml 托管多个独立的 bot：

bots:
  engineering_bot:
    feishu_app_id: "cli_11111"
    # ...
  support_bot:
    feishu_app_id: "cli_22222"
    # ...

每个 bot 拥有自己独立的：

Runtime 目录（~/.alice/bots/<bot_id>/）
工作空间、prompt 和 SOUL.md
飞书凭据（App ID、App Secret）
LLM profile — 可以使用不同的 provider 和模型
场景配置 — 独立的 chat/work 路由
Runtime API 端口 — 自动递增（7331、7332……）

Bot 之间共享：

相同的进程和 worker 池
默认的 CODEX_HOME（可按 bot 覆盖）

Bot 目录布局

~/.alice/bots/<bot_id>/
├── workspace/                        # Agent 工作空间
├── prompts/                          # Prompt 模板覆盖
├── SOUL.md                           # Bot 人格
└── run/connector/
    ├── automation.db                 # 持久化任务存储（bbolt）
    ├── campaigns.db                  # 活动索引（bbolt）
    ├── session_state.json            # Session 别名、用量计数器
    ├── runtime_state.json            # 可变运行时状态
    └── resources/scopes/             # 已下载的附件和产物

场景路由

每条收到的群消息经过一个决策树：

收到消息
  │
  ├─ 是内置命令？(/help、/status、/stop、/clear、/session)
  │   └─ 是 → 直接处理，不涉及 LLM
  │
  ├─ 匹配 work 触发词？(@Bot #work ...)
  │   └─ 是 → 路由到 work 场景
  │
  ├─ chat 场景已启用？
  │   └─ 是 → 路由到 chat 场景
  │
  └─ 两个场景都禁用？
      └─ 回退到旧版 trigger_mode（at / prefix / all）

场景 vs 旧版触发

旧版 trigger_mode（at/prefix/all）是一个简单的闸门：它决定是接受还是忽略消息。如果接受，只有一个 LLM 流水线。

场景更进一步：它们为每个场景分配不同的 LLM profile、session 作用域、话题行为和 SOUL.md 处理方式。新部署应始终使用场景。

Session 管理

Session 是 LLM 的上下文窗口。Alice 决定何时开始新 session，何时继续已有 session。

Session Key

Alice 使用规范 key 来标识 session：

格式	示例
`{receive_id_type}:{receive_id}`	`chat_id:oc_123`
`{key}	scene:{scene}`
`{key}	scene:{scene}

Session 作用域

session_scope 控制何时创建和复用 session：

作用域	行为
`per_chat`	整个群/DM 共用一个 session
`per_thread`	每个飞书话题一个 session
`per_user`	（仅 DM）每个用户一个 session
`per_message`	（仅 DM）每条消息新建 session