## 项目概述

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

**自托管安装：**
```bash
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](SELF_HOSTING.md)。
- **环境变量**：参考 [环境变量文档](https://multica.ai/docs/environment-variables)。
- **Git 集成**：支持 GitHub、GitLab、Gitea、Forgejo，包括自托管。
- **安全模型**：配置代理可访问的资源，参考 [安全模型文档](https://multica.ai/docs/security-model)。
- **运行时**：代理在您的机器上运行，确保机器安装了支持的代理 CLI 并已登录。
- **数据库**：需要 PostgreSQL 17 和 pgvector。

## 限制、风险与许可证

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

## 官方链接

- [官方网站](https://multica.ai)
- [文档](https://multica.ai/docs)
- [快速开始](https://multica.ai/docs/cloud-quickstart)
- [下载](https://multica.ai/download)
- [GitHub 仓库](https://github.com/multica-ai/multica)
- [Discord](https://discord.gg/W8gYBn226t)
- [X (Twitter)](https://x.com/MulticaAI)

## 信息来源和分析时间

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