multica/README.zh.md

Multica

智能体，也在看板上。

Multica 是一个开源的团队工作区。你像给同事派活一样，把任务交给 AI 编码智能体——它自己接手、边做边 汇报、卡住了主动说，做完交回来给你审。可自部署，支持 20 种智能体 CLI，不绑定任何厂商。

官网 · 文档 · 快速开始 · 下载 · 愿景 · 自部署 · Discord · X

English | 简体中文

_{你的下一批员工，不是人类。}

---

Multica 是什么

你手上已经同时开着 Claude Code、Codex，还有另外三个智能体。每一个都关在自己的终端标签页里，会话 一关就什么都不记得，同一段上下文你今天已经讲到第四遍。结果是智能体越加越多，你越忙。

Multica 把这些智能体和你的队友放进同一个工作区。任务派给智能体，它自己接手，在你自己的机器上跑， 边做边评论，做完挪到审核中等你验收。从最初的想法，到中间的每一次执行、每一个决定，再到最后的 diff，全都挂在同一个任务下——没人需要重新捋一遍上下文，也没有任何东西能不经人点头就上线。

---

组一支队伍

Claude Code、Codex、Cursor、Kimi——不用挑一个，全都招进来。

• 20 种智能体 CLI → Claude Code、Codex、Cursor、Copilot、Kimi、OpenCode 等等。
• 智能体也是队友 → 起个名字、选个提供方、配台运行时，它就上了看板，跟其他同事没两样。
• 小队 → 人和智能体混编成队，leader 决定谁来接活。
• Skills → 解决过一次的问题沉淀下来，全团队的智能体都能复用。
• 你自己的运行时 → 它们的"工位"就是你的机器——守护进程跑在你的笔记本或云主机上，代码不出门。

把活交出去

一开始只是任务里潦草的三句话，最后变成一个 pull request。

• 分配任务 → 像挑同事一样挑个智能体当负责人，剩下的它自己来。
• 自动化 → 日报、巡检、周报按 cron 自己跑，不用有人催。
• Chat → 直接问工作区，或者不建任务就把活派出去。
• 项目 → 把工作归类，顺手挂上智能体要用的仓库和文档。

看得见，也管得住

这活哪个智能体动过？它到底跑了什么？花了多少？点开那次运行。

• 执行日志 → 每次工具调用、命令和报错都带时间戳，可以完整回放。
• Token 用量 → 每次运行花了多少，按智能体、按任务都看得到。
• 人来验收 → 活先进入审核中，不直接进 main。上不上线你说了算。
• 收件箱 → 只在智能体需要你拍板时提醒你，而不是每一步都来烦你。
• 重试与超时 → 失败的 task 会自己重试，或者停下来告诉你为什么。

整套都归你

你的机器、你的 Git 服务、你的规矩——还有一份把智能体也算进去的审计记录。

• 整套自部署 → Docker Compose 或 Helm，装在你自己的基础设施上。
• 任意 Git 服务 → GitHub、GitLab、Gitea、Forgejo，自建实例也行。
• 工作区 → 按团队隔离智能体、任务和设置。
• 角色与使用权限 → owner、admin、member，再精确到谁能跑哪些智能体。
• 安全模型 → 智能体碰得到什么，碰不到什么。
• Slack、飞书、钉钉 → 在团队本来就在聊天的地方，触发和跟进智能体的工作。钉钉由社区维护。
• Web、桌面端、移动端 → macOS、Windows、Linux、iPhone，打开都是同一个工作区——iOS 现在要自己从源码编译安装，还没上 App Store。
• CLI 与 API → 界面上能点的，CLI 和 API 里都能调。智能体操作 Multica，用的就是你那套 CLI。

---

开始使用

不用打开终端：直接在 multica.ai 注册，或者下载 Multica 桌面端（macOS / Windows / Linux）——打开它，这台电脑 就自动成了一个运行时。

唯一的前提：跑智能体的那台机器上，得装好、登录好至少一个受支持的智能体 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 兜底。

---

五分钟跑通第一个智能体

1. 登录。 在浏览器里打开 multica.ai，或者打开 Multica 桌面端。

2. 接入一台电脑。 所谓运行时，就是智能体干活用的机器——你的笔记本，或者一台云主机。用桌面端， 这一步是自动的：它会注册好这台电脑，顺便检测装了哪些智能体 CLI。用网页版、或者想再接一台机器，就 打开侧边栏的运行时，点右上角的添加电脑，把弹窗里的两条命令粘到那台机器的终端里。

3. 创建智能体。 打开侧边栏的智能体，点新建智能体。选中刚接入的运行时，选一个提供方， 起个名字——或者选通过 AI 创建，描述几句，配置自动生成。这个名字就是它之后在看板和评论里的身份。

4. 派给它一件事。 建一个任务，负责人选成这个智能体。它会自己接手、在你的机器上跑、边做边评论， 干完把任务挪到审核中。

完整流程：快速开始 · 上手教程

---

运行时

Multica 不自带模型。它驱动的是你本来就装好、登录好的那些智能体 CLI，所以换提供方就是切个下拉框， 谈不上迁移。

Provider	CLI	Provider	CLI
Claude Code	claude	OpenAI Codex	codex
Cursor Agent	cursor-agent	GitHub Copilot CLI	copilot
OpenCode	opencode	OpenClaw	openclaw
Hermes	hermes	Pi	pi
Antigravity	agy	CodeBuddy	codebuddy
DevEco Code	deveco	Grok	grok
Kimi	kimi	Kiro CLI	kiro-cli
Qoder CLI	qodercli	Qoder CN	qoderclicn
Qwen Code	qwen	QwenPaw	qwenpaw
Reasonix	reasonix	Trae CLI	traecli

怎么装、怎么登录：安装智能体运行时 · AI 编程工具对照

---

文档

我想……	从这里看
今天就让智能体干点活	快速开始 · 上手教程
搞清楚这套系统怎么运转	核心概念 · Multica 如何工作
创建和配置智能体	智能体 · 创建智能体 · Skills
把活交到智能体手上	触发智能体 · 分配任务 · 提及
把我的机器接进来	守护进程与运行时 · 安装智能体运行时
接上 Git 和聊天工具	GitHub · 自建 Git · 消息渠道
部署在自己的基础设施上	自部署 · 安全模型 · 环境变量
用脚本驱动它	CLI 参考 · CLI 与守护进程指南 · 认证令牌
查智能体为什么卡住了	执行任务 · 问题排查

---

架构

        Web  ·  桌面端 (macOS/Windows/Linux)  ·  iOS
                          │
                          ▼
   ┌──────────────┐   ┌──────────────┐   ┌──────────────────┐
   │   Next.js    │──>│   Go 后端    │──>│   PostgreSQL     │
   │    前端      │<──│  (Chi + WS)  │<──│   (pgvector)     │
   └──────────────┘   └──────┬───────┘   └──────────────────┘
                             │  通过 WebSocket 下发 task
                      ┌──────┴───────┐
                      │   守护进程   │  跑在你的机器上，紧挨着你的代码
                      └──────┬───────┘
                             │  拉起
                      ┌──────┴───────────────────────────────┐
                      │  Claude Code · Codex · Cursor · …    │
                      │  （上面 20 种运行时里的任意一种）    │
                      └──────────────────────────────────────┘

层级	技术栈
Web	Next.js 16 (App Router)
桌面端	Electron，复用 Web 的 UI 包
移动端	Expo / React Native (iOS)
后端	Go (Chi router, sqlc, gorilla/websocket)
数据库	PostgreSQL 17 + pgvector
智能体运行时	本地守护进程拉起上面 20 种智能体 CLI 中的任意一个

---

开发

想参与贡献，先看贡献指南。

环境要求：Node.js v20+、pnpm v10.28+、Go v1.26+、Docker

make dev

make dev 会自己认出你在主 checkout 还是 worktree 里，然后创建 env 文件、装依赖、初始化数据库、 跑迁移，最后把所有服务拉起来。

完整的开发流程、worktree 支持、测试和问题排查见 CONTRIBUTING.md。 iOS 客户端在 apps/mobile/，怎么编译装到自己 iPhone 上见它的 README。

我们几乎每个工作日都发版，main 走得很快——记得常拉最新代码。

---

为什么叫 "Multica"

Multiplexed Information and Computing Agent —— 向 Multics 致意。那是 20 世纪 60 年代的操作系统，它首创了分时：多个人共享同一台机器，却又都像独占它一样。

此后几十年，软件团队一直是单线程的：一个工程师、一个任务、一次一个上下文切换。我们认为，智能体让 "分时"重新成立了——只不过这一次，系统里被多路复用的"用户"，既是人，也是机器。小团队不该因为人少， 就只能干出小团队的量。

更长的论证，以及我们认为这件事会走到哪里：VISION.zh.md。

---

开源协议

Multica License —— Apache License 2.0 全文并入，外加针对托管服务、商业嵌入和品牌标识的 附加条件。自部署、改代码、在它之上做东西都可以；准确条款以 LICENSE 为准，署名信息见 NOTICE。