多 Agent 软件工程范式的经典实现，但主仓库已 9 个月无提交、19 个月无发版——学习参考可以，新项目慎选。
适合谁
- 研究多 Agent 角色分工（PM/架构师/工程师）范式的学习者
- 以论文/教学为目的、不需要持续维护的实验项目
不要用，如果要
- 要接入最新模型并长期维护的生产系统——主仓库停更意味着新模型适配无人跟进（见 T1）
- 环境是 Python 3.12+——官方明确只支持 3.9 至 3.12 以下（见 T2）
体检卡
30 分 · 最后一次推送 2026-01-21（283 天前），最后一个 release v0.8.2 停在 2025-03-09（598 天前）
45 分 · 安装链长：conda + pip 之外，README 要求额外安装 node 与 pnpm，且 Python 需 ≥3.9 且 <3.12
— 分 · 未评估 · 缺证据：未实测：未部署，API 调用成本与 token 消耗无数据
70 分 · MIT 协议无限制；但角色编排逻辑与框架 API 耦合，迁移到自研框架需重写（推断 E3）
35 分 · 无已发布安全公告（好），但发版停滞近 20 个月，open issues 134 无维护响应（推断 E3）
60 分 · 71,098 star、引用度高，社区 fork 与衍生项目多；主仓库本身不再活跃（E1 停更事实）
加权总分 45.6 / 100（仅已评维度参与，已评权重 80；公式：(30×25+45×20+70×15+35×10+60×10) ÷ 80）。未评估维度不记 0 分，也不参与计算。
| # | 红线类型 | 级别 | 判定 | 说明 | 来源 |
|---|---|---|---|---|---|
| R1 | 已停更 | 禁止级 | 未命中 | 最后一次推送 2026-01-21，距今约 9.3 个月——未超 12 个月禁止级阈值，但已进入警示区间（详见 T1） | 原文 |
| R2 | 协议不明 | 警示级 | 未命中 | GitHub 识别为 MIT，无歧义 | 原文 |
| R3 | 高危 CVE | 禁止级 | 未命中 | security-advisories 返回空 | 原文 |
解剖：它到底怎么工作
把软件公司的角色流（产品经理→架构师→工程师→QA）建模为多 Agent 流水线：每个角色是一个 LLM 驱动的 Agent，按 SOP 传递结构化产物（需求文档→设计→代码）。
核心机制
角色（Role）+ 动作（Action）+ 环境（Environment）三元抽象：Agent 按 SOP 订阅上游产物、发布自己的产物，形成有向消息流。
输出强调结构化中间产物而非一次性对话，这是它区别于简单 AutoAgent 循环的地方。
扩展点
自定义 Role/Action 注册进流水线；支持本地模型与各类 LLM API（具体适配列表随停更而过期——推断 E3）。
未评估
长任务稳定性、成本曲线、与 2026 年新模型的实际兼容性——需实测。
避坑指南
每条陷阱都有可点击来源（E1）；没有来源的「坑」不写。本报告共 3 条。
你会看到：提 issue 无人回、新模型（新版 API 形态）不适配、文档与代码开始漂移。
根因：pushed_at = 2026-01-21T10:12:33Z（E1），最后一个 release v0.8.2 发布于 2025-03-09（E1）。
缓解：生产场景改用活跃维护的多 Agent 框架；确需沿用 MetaGPT 范式则评估社区 fork 的活跃度后再引入。
你会看到：在 Python 3.12+ 的现代环境里 pip install 直接失败或依赖冲突。
根因：README 原文要求「Ensure that Python 3.9 or later, but less than 3.12, is installed」。
缓解：用 conda/uv 锁 3.11 环境安装；或评估 fork 是否已放宽版本要求。
你会看到：修复只能靠 main 分支——而 main 也停了；PyPI 上的 metagpt 包与仓库最新代码存在差距。
根因：releases 接口显示最后发版 v0.8.2 于 2025-03-09，其后无任何 tag（E1）。
缓解：不要依赖 pip 包的持续更新；以固定 commit 飘记源码方式引入，并自建补丁。
证据 E1 · https://api.github.com/repos/geekan/metagpt/releases
成本账
| 上手时间 | 未评估（未实测：未跑通安装，token 消耗与上手时间无数据） |
|---|---|
| 算力 | API 调用为主，本地资源要求低（推断 E3，未实测） |
| 钱 | MIT 无许可费；主要成本是 LLM API 消耗（多角色多轮调用，token 用量偏高——推断 E3） |
| 长期维护 | 无人维护，长期维护成本即自担 fork 成本 |
替代方案
| 候选 | 为什么可能不选它 |
|---|---|
| AutoGPT（站内已收录） | 同属早期明星项目，主仓库亦进入低维护状态（其协议另有 NOASSERTION 问题，待出报告） |
| LangGraph / CrewAI | 活跃维护中，但抽象层级更低（代码优先），拿不到 MetaGPT 式「角色扮演即流程」的开箱体验（推断 E3） |
证据链
展开全部 4 条证据（断言 → 来源 → 等级）
| # | 断言 | 等级 | 来源 |
|---|---|---|---|
| E1 | star = 71,098；pushed_at = 2026-01-21T10:12:33Z；license SPDX = MIT；open issues 134 | E1 | https://api.github.com/repos/geekan/metagpt |
| E2 | 近 5 个 release：v0.8.2（2025-03-09）为最新，此后无发版 | E1 | https://api.github.com/repos/geekan/metagpt/releases |
| E3 | README：要求 Python ≥3.9 且 <3.12；安装需 node + ppm/pnpm；提供 pip 与 docker 两条安装路径 | E1 | https://github.com/geekan/MetaGPT#readme |
| E4 | security-advisories 返回空列表 | E1 | https://api.github.com/repos/geekan/metagpt/security-advisories |