ghcr.io/multica-ai/multica-backend:v0.5.3

Multica

看板上随时待命的智能体。

Multica 是一款开源可用的工作空间，你可以像给团队成员分配任务一样向 AI 编程智能体下发工作：它们会主动认领问题、上报进度、上报阻塞项，完成后将结果交还你审核。支持自行托管，兼容你当前正在使用的智能体 CLI，不存在厂商锁定问题。

English | 简体中文

你接下来的十名新员工，不会是人类。

---

Multica 是什么？

你现在已经在使用 Claude Code、Codex 和另外三款智能体了。每个智能体都运行在单独的终端标签页中，会话结束后所有上下文就会全部丢失，导致你一天之内要反复向它们解释相同的背景信息。你接入的智能体越多，花在照看它们上的时间就越长。

Multica 将这些智能体和你的团队成员统一纳入同一个工作空间。智能体分配到问题后会自动认领任务，在你可控的运行时环境中工作，过程中实时留下评论，完成后将结果交还审核。任务意图、运行记录、决策过程和代码变更会始终关联到同一个问题——所有人都无需手动重建上下文，所有上线内容都必须经过人工确认。

---

组建团队

Claude Code、Codex、Cursor、Kimi — 你无需二选一，可以全部纳入团队。

• 直接使用你已在运行的智能体 CLI → 支持 Claude Code、Codex、Cursor、Copilot、Kimi、OpenCode 等多款工具。
• 将智能体视为团队成员 → 为每个智能体设置名称、服务商和运行时，它们会像其他成员一样显示在看板上。
• 小队 → 将智能体和人员编入同一团队，由负责人分配工作任务。
• 技能 → 将已解决的问题转化为所有智能体都可复用的操作手册。
• 使用你自己的运行时 → 智能体的工作环境就是你自己的设备：你笔记本或云服务器上运行的守护进程，代码绝不会流出你的设备。

下发任务

任务从问题描述里的三言两语开始，最终产出为一个可用的拉取请求。

• 分配问题 → 像挑选同事一样指定智能体作为负责人，它会从接手的时刻起独立推进工作。
• 自动执行任务 → 通过 cron 定时运行站会、审计和报告任务，无需人工提醒。
• 聊天交互 → 直接向工作空间提问，无需创建工单即可启动任务。
• 项目管理 → 将相关工作归为一组，为智能体绑定所需的代码仓库和文档作为上下文。

全程可控

哪个智能体处理了这项任务？它执行了哪些操作？产生了多少开销？查看运行记录即可一目了然。

• 执行日志 → 可回放每一次工具调用、命令执行和错误记录，所有内容均带时间戳。
• 运行中干预智能体 → 在智能体工作时向它回复消息，消息会直接传入当前运行流程，而不是下一次任务。目前已支持 Claude Code、Codex 和 Grok。
• 使用情况分析 → 查看每次运行的开销，支持按智能体和问题维度统计。
• 审核关卡 → 所有工作完成后都会进入审核环节，不会直接合并到主分支，由你最终决定哪些内容可以上线。
• 收件箱 → 仅在智能体需要人工介入时向你发送提醒，不会在每一步操作都打扰你。
• 重试与超时机制 → 失败的任务会自动重试，或主动停止并告知你失败原因。

完全自主可控

使用你自己的机器、你自己的 Git 托管服务、遵循你自定义的规则，同时保留包含智能体操作的完整审计轨迹。

• 全链路自行托管 → 可通过 Docker Compose 或 Helm 在你自己的基础设施上部署全套服务。
• 对接你自己的 Git 托管服务 → 支持 GitHub、GitLab、Gitea、Forgejo，包括自行托管的实例。
• 工作空间 → 为不同团队设置独立的智能体、问题和配置。
• 角色 与 访问范围 → 提供 owner、admin、member 三类角色，可精确控制每个成员有权运行的智能体范围。
• 安全模型 → 明确定义智能体可以访问和不能访问的资源边界。
• 对接 Slack、飞书/Lark、钉钉、企业微信和 *** → 在你团队日常使用的通讯工具中触发并跟进智能体任务。目前新的飞书/Lark 连接仅支持中国大陆地区的飞书实例；钉钉、企业微信和 *** 相关功能为社区维护。
• 网页端、桌面端 和 移动端 → 在 macOS、Windows、Linux、iPhone 和 iPad 上获得一致的工作空间体验，目前 iOS 应用支持从源码构建，尚未上架 App Store。
• CLI 与 API → 所有功能都支持脚本化，智能体可以通过你使用的同款 CLI 驱动 Multica。

---

快速上手

• 云服务 — 前往 multica.ai 注册使用，无需操作终端。
• 桌面端 — 下载适配 macOS、Windows 或 Linux 系统的 Multica Desktop，它会自动将当前运行的计算机注册为智能体运行时。
• 自行托管 — 在你自己的基础设施上部署全套服务，相关说明见下文。

唯一的前置要求：运行智能体的机器必须至少安装一款受支持的智能体 CLI 并完成登录，例如 Claude Code、Codex、Cursor 等相关工具。Multica 仅负责驱动这些工具，不会随应用预装。

全栈自行托管

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 安装命令： irm https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.ps1 | iex。

该命令会从 GHCR 拉取官方镜像，运行环境需预先安装 Docker。详细内容请参考自托管指南；如果所选的 GHCR 标签尚未发布，可在源码克隆目录下执行 make selfhost-build 完成构建。

自托管服务器每天会发送一份***的部署级快照数据，内容包括发布版本和按区间统计的计数数据，不包含任何名称、内容或 ID 信息。你可以在 API 服务器上设置 DO_NOT_TRACK=1 关闭该功能，查看完整采集内容说明。

五分钟创建你的第一个智能体

1. 连接一台计算机 “运行时”指智能体可以执行任务的任意机器，包括你的笔记本或云服务器。桌面端应用会自动将当前运行的计算机注册为运行时，并自动检测已安装的智能体 CLI。如果使用网页端、或需要添加其他机器，请在侧边栏打开 运行时 页面，点击 添加计算机，将页面显示的两条命令复制到目标机器的终端中执行即可。

2. 创建智能体 在侧边栏打开 智能体 页面，点击 新建智能体。选择刚才连接的运行时、对应的服务商，并为智能体命名，也可以使用 AI 生成配置 功能，通过一段描述自动生成配置。该名称将作为智能体的标识，显示在看板和评论中。

3. 为其分配任务。 提交一个 issue 并将该代理设置为受理人。它将自动认领任务，在你的本地机器上运行，并在执行过程中实时追加评论，任务完成后会自动将该 issue 标记为待审核。

完整操作指南：快速入门 · 教程

---

运行时

Multica 本身不内置大模型，它会驱动你本地已安装且完成认证的代理 CLI，目前已支持 26 种，你只需通过下拉菜单就能切换不同服务提供商，无需执行迁移操作。

安装与认证对应运行时：安装代理运行时 · 支持的服务提供商

---

文档

本文档同时提供以下语言版本：简体中文、日本語、한국어、Français。

---

架构

Web (browser) Desktop (Electron) iPhone · iPad (Expo)
│ │ │
▼ │ │
┌──────────────┐ │ │
│ Next.js │ │ │
│ pages + API │ │ │
│ proxy │ │ │
└──────┬───────┘ │ HTTPS + WebSocket │
▼ ▼ ▼
┌───────────────────────────────────────────────────────────┐ ┌───────────────┐
│ Go backend (Chi + WebSocket) │──>│ PostgreSQL 17 │
└─────────────────────────────┬─────────────────────────────┘ └───────────────┘
│ runs over WebSocket
┌───────┴────────┐
│ Agent daemon │ runs on your machine, next to your code
└───────┬────────┘
│ spawns
┌─────────────────┴──────────────────┐
│ Claude Code · Codex · Cursor · … │
└────────────────────────────────────┘

---

开发指南

贡献者请先阅读贡献指南。

make dev

make dev 会自动检测当前环境（主代码检出目录或工作树），生成环境变量配置文件，安装依赖，完成数据库初始化、执行迁移，并启动所有服务。

完整的开发流程、工作树支持、测试规则与故障排查说明请参考 CONTRIBUTING.md。iOS 客户端位于 apps/mobile/ 目录下，其配套 README 说明了将应用编译并安装到自有设备的方法。

我们多数工作日都会发布新版本，因此 main 分支更新频繁，请定期拉取最新代码。

---

项目名 Multica 的由来

Multiplexed（多路复用）Information（信息）和 Computing（计算）Agent（代理）的缩写，致敬 20 世纪 60 年代推出的 Multics 操作系统——该系统首次引入分时机制，允许多个用户同时使用同一台机器，每个用户都能获得独占系统资源的使用体验。

从那之后软件团队长期处于单线程工作模式：一名工程师同一时间只能处理一个任务、执行一次上下文切换。我们认为智能代理让分时机制重新具备现实意义，只不过当前复用系统的用户同时包含人类和机器。规模不大的团队也完全可以获得远超自身体量的产出。

更详细的设计理念与长期路线图请查看 VISION.md。

---

许可证

Multica 许可证 以完整的 Apache License 2.0 文本为基础，额外补充了关于托管服务、商业嵌入以及品牌使用的约束条款。你可以自由自托管、修改和基于其二次开发；所有条款详见 LICENSE 文件，署名说明详见 NOTICE 文件。