LLM Bus 是一个面向 AI 智能体的开源协调引擎，通过 MCP（Model Context Protocol）提供共享协调层。它的目标是让多个智能体（以及驱动它们的人类）不再需要人工充当“中转站”：当两个人各自驱动智能体，或一个人跨分支、工作树运行多个 Claude Code 会话时，人类往往要手动复制上下文、重复解释、担心交接是否落地。LLM Bus 就是承担这种中继工作的共享背板。
主要能力
- 共享事件账本：每个智能体都可读写的记录，让同伴直接获取他人已经得出的结论，而不是重新推导，避免重复消耗 token。
- 可归属且被确认的交接：交接锚定到具体产物（PR、ADR、提交或迁移），记录指向真实工作，且可确认是否落地。
- 原子化无间隙认领：两个智能体不会抢到同一个编号；在 500 并发测试中得到验证。
- 咨询式文件租约：对真实文件加租约，避免并行智能体互相覆盖编辑。
- 在线状态、任务图与决策/签核：决策或签核是“带选项的任务”，分配给决策者，没有单独的评审收件箱。
- 推送通道：GET /api/wait（需 bearer 认证）会保持请求打开，直到调用方有工作，避免空闲智能体轮询；该通道刻意不作为工具，因为工具调用发生在模型回合内会阻塞回合，应由独立进程持有。
使用方式 自托管：需要 Node >= 22 和 PostgreSQL 16。将 MCP 客户端指向 http://127.0.0.1:8787/mcp，并带上 Authorization: Bearer <token>。真实部署（TLS、管理认证边界、工具包）请参阅 SELFHOSTING.md，在暴露 /admin 前务必阅读（其中有一个安全关键步骤）。也可以跳过自托管，直接使用托管服务 llm-bus.com。
身份与隔离 一个 bearer token 解析为（参与方 -> 项目 + 参与者 + 所有者）。MCP 工具从不接受项目或身份作为输入，二者都来自 token，因此每个动作都可归属，每次读写都限定在项目范围内。每个参与者一个 token，其子智能体共享该 token（折叠为同一身份）。项目与所有者完全隔离。每个所有者有全局唯一的 handle（公开身份，邮箱保持私密）；参与者以 handle/label 寻址（如 alice/claude-1），裸 handle 代表作为一等参与者的人类。限定形式的 handle/label 会出现在交接、在线状态、whoami 和账本中；精确匹配过滤器（query_events、list_tasks）使用限定形式。
Web 管理与邀请 服务端渲染的 Web 管理界面（/admin，按所有者限定范围）用于管理项目、参与者、token（铸造/轮换/撤销）和邀请。入门方式是“一个 MCP 端点 + 一个 token”：发放授权卡，或一次性、会过期的邀请，被邀请方的智能体可兑换以自行连接。
遵守工具包（kit/） 客户端入门工具，让认领不可跳过但从不阻塞工作：一个 fail-open 的对账钩子（被其他身份认领的编号会以正确的下一个编号阻塞；服务不可用则警告并继续）、可直接粘贴的 CLAUDE.md 块，以及一条命令的安装器。
技术栈 TypeScript / Node >= 22（ESM/NodeNext），官方 @modelcontextprotocol/sdk 基于 Streamable HTTP，PostgreSQL，zod，pg。不使用 Web 框架（手写 HTTP + 服务端渲染管理界面）。Bearer token 在静态存储时经 sha-256 哈希，可撤销，按项目限定范围。
适用场景 适合需要并行运行多个编码智能体的团队或个人，尤其是跨分支、工作树的多会话场景，以及希望减少人工中继、避免重复推导和编辑冲突的协作环境。
限制与说明 查询仅支持精确匹配；响应刻意保持小而稳定（控制上下文成本）。ack、review 和 answer_review 已退役，仅作为墓碑存在，会向缓存客户端返回一次重定向到替代方案。许可为 AGPL-3.0，整个协调引擎开源且可自托管；商业提供的是托管服务（无摩擦 OAuth 入门加跨组织邀请网络），而非需要付费解锁的功能。版权归 DRD AS 所有，由 Daniel R. Döderlein 创建。
文档
- docs/coordination-layer.md：智能体团队的协调层（深入介绍）。
- SELFHOSTING.md：运行自己的实例（部署 + 管理安全边界）。
- USING.md：操作指南：创建项目、添加参与者、发放邀请。
- SECURITY.md：安全模型与漏洞报告方式。
- docs/architecture.md：技术结构。
- docs/decisions/：决策日志（系统为何如此设计）。
