Donmai：开源多智能体工作流运行时，让本地AI代理舰队自主运行

Donmai是RenseiAI开源的多智能体工作流运行时，支持在本地机器上运行、重试和审计多步骤代理任务。它采用三进程架构（编排器-调度器-工作器），提供完整的CLI工具链，支持Linear集成、日志分析和 fleet 管理。

• 原作者/维护者：RenseiAI
• 来源平台：github
• 原始标题：donmai
• 原始链接：https://github.com/RenseiAI/donmai
• 来源发布时间/更新时间：2026-06-13T20:15:35Z

随着大型语言模型（LLM）能力的不断提升，AI代理（Agent）正在从实验性工具逐步演变为生产级的基础设施。然而，在本地环境中管理和编排多个代理任务仍然是一个复杂的问题：如何确保任务可靠执行？如何处理失败和重试？如何监控代理舰队的健康状态？

Donmai正是为解决这些问题而生的开源工作流运行时。它由RenseiAI团队开发，采用MIT许可证，是Rensei生产环境所使用的同款二进制文件。Donmai将多智能体编排、任务调度、日志审计等功能整合到一个统一的CLI工具中，让用户能够在自己的机器上构建和运行可靠的AI代理工作流。

Donmai的设计遵循清晰的责任分离原则，采用经典的三进程协作模型：

编排器是整个工作流的入口点，负责从外部系统（如Linear issue tracker）获取待处理任务，并将它们分派到内部工作队列。它不直接执行代理任务，而是专注于任务调度和分发。在SaaS环境中，编排器可以被平台级的Webhook驱动控制平面替代；在开源模式下，用户可以按需运行编排器或设置定时任务（cron job）来自动化处理积压的工作项。

调度器是一个长期运行的扫描循环进程，持续监视Redis工作队列中的待处理任务。它负责强制执行并发限制，并在有可用容量时启动工作器进程来消费队列中的任务。调度器是OSS模式下保持工作器运行的核心组件，相当于SaaS模式中的协调服务（coordinator service）。

工作器是实际执行代理任务的进程。每个工作器启动后会向协调器注册，通过HTTP轮询获取分配的任务，然后执行对应的会话（调用Claude、Codex等LLM运行时），最后将结果报告回协调器。多个工作器可以并行运行，由调度器控制并发上限。

┌──────────────────────────────────────────────────────────────────┐
│                        your machine                              │
│                                                                  │
│  ┌─────────────────┐    ┌─────────────────┐   ┌──────────────┐  │
│  │   orchestrator  │───▶│    governor     │──▶│   worker(s)  │  │
│  │  (donmai orche- │    │  (donmai govr.) │   │ (donmai wkr) │  │
│  │   ator)         │    │                 │   │              │  │
│  └─────────────────┘    └─────────────────┘   └──────────────┘  │
│           │                      │                    │          │
│     Linear API             Redis queue         coordinator HTTP  │
└──────────────────────────────────────────────────────────────────┘

除了三进程模型外，Donmai还提供了一个本地守护进程（rensei-daemon），作为系统服务运行（macOS上使用launchd，Linux上使用systemd）。守护进程具有以下关键特性：

• 持久化：系统重启后自动恢复运行
• 工作区池管理：维护代理会话的工作区池
• 自动更新：支持带排空语义（drain semantics）的自动更新
• 健康检查：提供donmai daemon doctor命令进行配置、凭证和磁盘空间检查

守护进程通过donmai daemon install命令安装，支持用户级（--user）或系统级（--system）安装。安装后会自动配置系统服务，确保Donmai在后台稳定运行。