multica-ai / multica

multica-ai/multica

open_in_new前往仓库

将问题分配给Claude Code、Codex、Cursor等17种以上编码代理，如同队友协作——开源且可自托管。

项目概览

项目概述

Multica 是一个开源、可自托管的工作区，用于将任务分配给 AI 编码代理，如同分配给团队成员一样。它支持 20 种代理 CLI（如 Claude Code、Codex、Cursor 等），代理可以自主领取问题、报告进度、提出阻塞并交回审查。项目采用 Go 编写，前端使用 Next.js，数据库使用 PostgreSQL 17 和 pgvector。

核心功能

  • 代理作为团队成员：为每个代理命名、配置提供商和运行时，它们像人类同事一样出现在看板上。
  • 问题分配：将问题分配给代理，代理自动领取、执行、评论并移动到审查状态。
  • Squads：将代理和人员组成团队，由领导分配工作。
  • 技能（Skills）：将已解决的问题转化为可复用的操作手册。
  • 自定义运行时：代理在您控制的机器（本地或云端）上运行，代码不会离开该机器。
  • Autopilots：按计划（cron）运行站会、审计和报告。
  • 聊天：向工作区提问或直接开始工作。
  • 项目：分组工作并附加仓库和文档作为上下文。
  • 执行日志：回放每个工具调用、命令和错误，带时间戳。
  • 令牌使用量：查看每次运行的成本。
  • 审查门禁：工作进入审查状态，而非直接合并。
  • 收件箱：仅在代理需要人工介入时通知。
  • 重试和超时：失败运行自动重试或停止并说明原因。
  • 自托管：通过 Docker Compose 或 Helm 部署在自己的基础设施上。
  • 多 Git 托管：支持 GitHub、GitLab、Gitea、Forgejo。
  • 工作区：按团队隔离代理、问题和设置。
  • 角色和访问范围：owner、admin、member 角色，以及每个成员可运行的代理。
  • 安全模型：定义代理可访问和不可访问的内容。
  • 集成：支持 Slack、Lark、钉钉、企业微信（后两者由社区维护）。
  • 多端：Web、桌面（macOS/Windows/Linux）和 iOS。
  • CLI 和 API：所有功能均可脚本化。

适用与不适用场景

适用场景：

  • 团队希望将重复性编码任务（如 bug 修复、小功能开发）委托给 AI 代理，并保持人类审查。
  • 需要统一管理多个 AI 编码代理，避免上下文丢失和重复解释。
  • 需要自托管解决方案，确保代码和数据留在自己的基础设施中。
  • 需要审计跟踪，包括代理执行的所有操作。

不适用场景：

  • 需要完全无人干预的自动化（Multica 强调人类审查门禁）。
  • 需要代理在云端运行且不关心代码位置（Multica 的代理运行时在您的机器上）。
  • 需要内置模型（Multica 不提供模型，依赖已安装的代理 CLI）。

技术架构与依赖

  • 前端：Next.js 16（App Router），桌面端使用 Electron，移动端使用 Expo/React Native（iOS）。
  • 后端：Go（Chi 路由器、sqlc、gorilla/websocket）。
  • 数据库：PostgreSQL 17 和 pgvector。
  • 代理运行时：本地守护进程执行 20 种代理 CLI。
  • 架构：Web/桌面/移动端 → Next.js 前端 → Go 后端 → PostgreSQL；后端通过 WebSocket 与代理守护进程通信，守护进程在您的机器上运行并生成代理 CLI。

安装与快速开始

云服务快速开始：

  1. 在 multica.ai 注册，或下载 Multica Desktop。
  2. 连接一台计算机（运行时），桌面版自动注册并检测已安装的代理 CLI。
  3. 创建代理：选择运行时、提供商并命名，或使用“Build with AI”生成配置。
  4. 分配问题：将代理设为 assignee，代理自动领取并执行。

自托管安装：

curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash -s -- --with-server
multica setup self-host

Windows 用户设置 $env:MULTICA_MODE="with-server" 后运行 PowerShell 安装脚本。需要 Docker。

开发环境：

  • 前置要求：Node.js v20+、pnpm v10.28+、Go v1.26+、Docker。
  • 运行 make dev 自动设置环境并启动所有服务。

典型使用方法

  1. 创建代理：在侧边栏打开 Agents，点击 New agent，选择运行时和提供商，命名。
  2. 分配问题：创建 issue 并将代理设为 assignee，代理自动领取。
  3. 监控进度：通过执行日志查看代理的每个工具调用和命令。
  4. 审查结果：代理完成后将 issue 移至审查状态，人类审查后合并。
  5. 使用 Autopilots：设置 cron 任务运行站会或审计。
  6. 通过 CLI 脚本化：使用 multica CLI 执行所有操作。

配置与部署要点

  • 自托管：使用 Docker Compose 或 Helm，参考 SELF_HOSTING.md。
  • 环境变量：参考 环境变量文档。
  • Git 集成：支持 GitHub、GitLab、Gitea、Forgejo，包括自托管。
  • 安全模型：配置代理可访问的资源，参考 安全模型文档。
  • 运行时：代理在您的机器上运行，确保机器安装了支持的代理 CLI 并已登录。
  • 数据库：需要 PostgreSQL 17 和 pgvector。

限制、风险与许可证

  • 限制：不提供模型，依赖外部代理 CLI；iOS 应用需从源码构建，尚未上架 App Store；钉钉和企业微信集成由社区维护。
  • 风险：代理可能产生错误或意外行为，需人类审查；自托管需自行维护基础设施。
  • 许可证：Multica License，包含 Apache License 2.0 全文及额外条件（覆盖托管服务、商业嵌入和品牌）。允许自托管、修改和构建，具体条款见 LICENSE 文件。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、CONTRIBUTING.md、最新发布信息（v0.4.22，2026-08-10）。
  • 分析时间：2026-08-10（基于最新发布信息）。