ghcr.io/multica-ai/multica-web:v0.5.0

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 (浏览器) 桌面端 (Electron) iPhone · iPad (Expo)
│ │ │
▼ │ │
┌──────────────┐ │ │
│ Next.js      │ │ │
│ 页面 + API   │ │ │
│ 代理服务     │ │ │
└──────┬───────┘ │ HTTPS + WebSocket │
▼                ▼                    ▼
┌───────────────────────────────────────────────────────────┐ ┌───────────────┐
│ Go 后端 (Chi + WebSocket)                                 │──>│ PostgreSQL 17  │
└─────────────────────────────┬─────────────────────────────┘ └───────────────┘
│ 通过 WebSocket 通信
┌───────┴────────┐
│ 代理守护进程   │ 运行于你的本地机器、代码目录旁
└───────┬────────┘
│ 启动子进程
┌─────────────────┴──────────────────┐
│ Claude Code · Codex · Cursor · …   │
└────────────────────────────────────┘

---

开发指南

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

make dev

make dev 命令会自动检测你的环境（主代码库或工作区）、生成环境配置文件、安装依赖、初始化数据库、执行数据迁移并启动所有服务。

完整的开发流程、工作区支持规则、测试方法与故障排查说明请参考 CONTRIBUTING.md。iOS 客户端代码位于 apps/mobile/ 目录，对应 README 文档说明了如何构建并安装到你的设备上。

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

---

为什么命名为 "Multica"？

Multiplexed（多路复用）Information（信息）和 Computing（计算）Agent（代理），这个命名也是对 Multics 的致敬。Multics 是 20 世纪 60 年代推出的操作系统，首次引入了分时共享机制，让多名用户可以同时使用同一台机器，体验仿佛各自独占整台设备。

在此之后，软件开发团队长期处于单线程工作模式：一名工程师、一个任务、同一时间只能进行一次上下文切换。我们认为代理技术会让分时理念重新焕发价值，而如今复用系统资源的对象已经同时包含人类和机器。小规模团队也完全可以拥有超出人力规模的生产力。

关于这一思路的完整阐述以及我们对项目未来的规划，请查看 VISION.md。

---

许可证

Multica 许可证 — 完整包含 Apache License 2.0 文本，同时附加了针对托管服务、商业嵌入和品牌标识的额外条款。你可以自托管、修改并基于该项目二次开发；所有条款明细请查看 LICENSE 文件，归属声明请参考 NOTICE 文件。