1. 项目概览
Multica 是一个开源、可自托管的工作区平台,将 AI 编程智能体(Claude Code、Codex、Cursor、GitHub Copilot 等)转变为一等队友——你可以像把任务分配给同事一样,把 issue 分配给智能体,它会自主领取工作、编写代码、报告阻塞问题并更新状态。
2. 背景与定位
采用多个 AI 编程智能体的团队很快会遇到协调问题:每个智能体都生活在自己的终端或工具中,会话在多次运行之间丢失上下文,也没有关于智能体做了什么、为什么做、改动了什么的共享记录。Multica 的构建目标正是解决这一问题:让智能体在团队看板上拥有真正的席位——它们的意图、执行日志和代码变更始终附着在人类同样使用的 issue 上,而不是散落在互不连接的 CLI 会话中。
大多数“AI 编程助手”工具聚焦于单个编辑器中的单个智能体,而 Multica 不绑定特定智能体,并且面向团队:它支持 26 种以上不同的智能体 CLI 并行工作,允许你将智能体和人类分组为 Squads,并将智能体的工作视为可审计、可评审的项目活动,而不是不透明的后台进程。它完全开源,可通过 Docker Compose 或 Helm 端到端自托管,避免被任何单一托管智能体提供商锁定。
3. 功能分类
🤖 智能体管理——5 项以上代表性能力
从 26 种受支持的 CLI(Claude Code、Codex、Cursor、GitHub Copilot、Gemini、Kimi、OpenCode、Hermes 等)中配置并运行智能体,每个智能体都可自定义名称、提供商和运行时。目的:让团队无论偏好哪种底层智能体工具,都能以 Multica 作为统一控制平面。
👥 Squads 与委派——分组与路由功能
将多个智能体(和人类)分组为一个由路由智能体领导的 Squad,由它将传入的工作分配到整个小组,而不是让单个智能体过载。目的:在无需手动调度流量的情况下,扩展基于智能体的工作委派。
⚙️ 自动化(Autopilots)——定时/事件驱动运行
Autopilots 可按 cron 计划或外部 webhook 事件触发智能体运行——例如每日站会、周期性审计或自动报告——也可选择手动触发。目的:让智能体执行主动的、周期性的工作,而不仅仅是对分配的 issue 做出反应。
🧩 技能系统——可复用的能力包
技能是基于 markdown 的能力包,描述某类工作如何完成;它们可以附加到多个智能体,并注入到每个相关任务中。目的:让已解决的问题和工作流在整个智能体团队中不断积累,而不是每次都重新解决。
🔍 可见性与控制——执行日志、token 跟踪、评审门禁
每次智能体运行都会产生带时间戳的执行日志,记录工具调用和错误,按智能体和 issue 跟踪 token 用量,并可在代码合并前要求人工评审门禁批准,同时支持重试和超时处理。目的:让智能体活动可审计,并能安全合并到生产代码库中。
🔗 集成——Git 托管平台与聊天平台
原生支持 GitHub、GitLab、Gitea 和 Forgejo 作为 Git 托管平台,并支持 Slack、Lark、DingTalk、WeCom 和 Telegram 进行基于聊天的交互。目的:融入团队已在使用的工具,而不是要求建立新的工作流孤岛。
4. 关键亮点
- 设计上不绑定特定智能体——支持 26 种不同的智能体 CLI,因此团队不会被某一家供应商的编程智能体锁定。
- 通过 Squads 实现规模化委派——路由领导者将工作分配到一组智能体和人类中,使委派在团队成长过程中保持稳定。
- issue 驱动的自主性——分配一个 issue 就足以触发智能体开始工作、报告阻塞问题并更新状态,无需人工照看。
- 完全自托管——可通过 Docker Compose 或 Kubernetes 上的 Helm chart 部署,以 PostgreSQL 作为后端存储,让团队完全掌控自己的数据和基础设施。
- 可积累的技能——附加到智能体的、可复用的 markdown 定义技能,意味着已解决的问题无需在每个任务上重新解决。
- 跨平台覆盖——Web、桌面应用(通过 Electron 支持 macOS/Windows/Linux)和移动端(iOS)共享同一套核心 UI 包,因此无论团队在哪里工作,都能看到智能体活动。
5. 按角色划分的使用场景
- 普通开发者——将常规或范围明确的 issue(缺陷修复、小功能、重构)分配给智能体,然后评审生成的拉取请求,而不是自己切换上下文去处理。
- DevOps/SRE——通过 Docker Compose 或 Helm chart 自托管 Multica,在安装了智能体 CLI 的任何机器上配置运行时,并使用 Autopilots 执行周期性维护任务,如定时审计或报告。
- 项目经理——在同一看板上并排跟踪智能体和人类的工作,使用执行日志和 token 用量跟踪来了解成本与进度,并将合并置于人工评审之后。
- 安全工程师——使用评审门禁,在智能体编写的代码合并前要求人工批准,并依靠执行日志审计智能体究竟调用了哪些工具、改动了什么。
6. 快速开始
找到你需要的内容: 浏览 multica.ai/docs 上的文档,从“核心概念”和“完整教程”页面开始,了解智能体、技能、autopilots 和 squads。
安装 / 集成:
# 快速自托管安装(macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash -s -- --with-server
multica setup self-host
# 或克隆并通过 Docker Compose 运行
git clone https://github.com/multica-ai/multica.git
cd multica
make selfhost
贡献: Fork 仓库,查看仓库中的贡献指南,并向 github.com/multica-ai/multica 提交拉取请求。
7. 项目结构
multica/
├── apps/ # Next.js web 应用、Electron 桌面封装、Expo/React Native iOS 应用
├── packages/ # 跨 web/桌面/移动端共享的 UI 和逻辑包
├── server/ # Go 后端:Chi 路由器、sqlc、WebSocket 支持
├── docker/ # 用于自托管的 Docker Compose 文件
├── deploy/helm/ # 用于 Kubernetes 部署的 Helm chart
└── scripts/ # 安装脚本(install.sh / install.ps1)
关键目录:server/ 包含 Go 后端,负责管理智能体编排、issue 路由以及流式传输执行日志的 WebSocket 层;apps/ 存放平台的三个客户端界面(web、桌面、移动),它们共享公共包,因此智能体活动在各处看起来都一致;deploy/helm/ 和 docker/ 是生产自托管的两条受支持路径。
8. 相关生态
Multica 与现有开发者工具集成,而不是取代它们:
- 它编排的智能体 CLI:Claude Code、Codex、Cursor Agent、GitHub Copilot CLI、Gemini CLI、Kimi、OpenCode、Hermes 等。
- Git 托管平台:GitHub、GitLab、Gitea、Forgejo。
- 聊天平台:Slack、Lark、DingTalk、WeCom、Telegram——用于通知以及与智能体进行对话式交互。
- 基础设施依赖:PostgreSQL(含 pgvector)作为数据库,Docker/Docker Compose 或 Kubernetes+Helm 用于部署。
- 配套工具:
multica-ai/multica-cli,一个让智能体操作 Multica 本身的 CLI。
9. 许可证
Multica 基于修改版 Apache License 2.0 发布(基础 Apache 2.0 条款加上项目定义的附加条件)。
- ✅ 可免费自托管 Multica,用于团队/组织内部使用。
- ✅ 可公开再分发源代码,前提是同时包含许可证的两部分(附加条件和 Apache 2.0 文本)。
- ✅ 可在 Multica 的后端、守护进程或 CLI 之上构建无 UI 的产品,只要保留署名声明,并在文档中说明该产品基于 Multica 构建且附有仓库链接。
- ❌ 未经项目授予商业许可证,不得使用 Multica 源代码向第三方提供托管服务(无论收费还是免费)。
- ❌ 未经书面豁免,不得移除或修改源自 web、桌面、移动或共享 UI 包的 UI 中的 Multica 徽标、产品名称或版权/署名声明。
- ℹ️ 仅 Apache 2.0 条款并不满足许可证要求——附加条件和 Apache 2.0 必须一起交付,如有冲突,以附加条件为准。
- ℹ️ 贡献代码即表示贡献者同意项目维护者可以修改许可证条款并将贡献用于商业用途。
10. 常见问题
问:我必须使用 Multica Cloud,还是可以全部自托管?
答:Multica 可通过 Docker Compose 或 Helm chart 完全自托管——参见 SELF_HOSTING.md。如果你不想运行自己的基础设施,也可以选择使用托管方案 Multica Cloud(multica.ai)。
问:Multica 支持哪些 AI 编程智能体?
答:支持 26 种智能体 CLI,包括 Claude Code、Codex、Cursor Agent、GitHub Copilot CLI、Gemini CLI、Kimi、OpenCode 和 Hermes。任何安装了受支持 CLI 的机器都可以注册为“运行时”。
问:如何防止智能体编写的代码在无人监督的情况下被合并?
答:在相关 issue 或 Squad 上配置评审门禁——这会要求智能体的变更在合并前必须获得明确的人工批准,此外还会对失败的运行进行标准的重试/超时处理。
问:技能和 Autopilot 有什么区别?
答:技能是附加到智能体并注入相关任务的、可复用的 markdown 定义能力(即“如何做”);Autopilot 是由 cron 或 webhook 触发的自动化,无需手动分配即可运行智能体(即“何时做”)。参见 multica.ai/docs/concepts。
问:我可以为客户运行基于 Multica 的托管服务吗?
答:默认许可证下不可以——将 Multica 作为托管服务提供给第三方需要获得项目的商业许可证。组织内部使用以及为自己的团队自托管不受限制。
11. 快速链接
- 仓库:github.com/multica-ai/multica
- 文档:multica.ai/docs
- 自托管指南:SELF_HOSTING.md
- 发布版本:github.com/multica-ai/multica/releases
- Issue / 社区讨论:github.com/multica-ai/multica/issues
12. 总结
Multica 为工程团队提供了一个单一、可自托管的看板,让人类和 AI 编程智能体作为真正的队友一起工作——issue 被分配后,智能体自主执行且完全可审计,可复用的技能让已完成的工作随时间不断积累。它最适合已经在运行一个或多个 AI 编程智能体、需要共享可见性、评审门禁和规模化委派的团队,而不是孤立的每位开发者各自的 CLI 会话。