分划一切模型的里程碑,但主仓库已 25 个月零提交、从未发过 release——新项目请直接用后继模型,别再从这里起步。
适合谁
- 论文复现与历史基线对照(固定 commit 引用)
- 已有生产集成、只想维持现状不升级的存量系统
不要用,如果要
- 任何新项目——触发「已停更」禁止级红线(见 R1),后继模型是更合理起点
- 需要 issue 修复或安全响应——仓库实质上无人维护
体检卡
5 分 · 最后一次推送 2024-09-18(773 天前),releases 列表为空——从未发布过正式版本
60 分 · pip install git+ 一行可装,但依赖 PyTorch 且模型权重需单独下载(E1 README)
— 分 · 未评估 · 缺证据:未实测:各 checkpoint 的显存占用与推理速度缺数据
75 分 · Apache-2.0 无限制;输出 mask 格式通用(COCO 风格),替换模型成本低(推断 E3)
20 分 · 无 release、无发版通道,open issues 596 基本无人处理(停更事实 E1 推得)
55 分 · 55,081 star、学术引用极多、下游衍生生态庞大;但生态已整体迁移到后继模型(E1:官方后继仓库 sam2 存在且更新更近)
加权总分 40.0 / 100(仅已评维度参与,已评权重 80;公式:(5×25+60×20+75×15+20×10+55×10) ÷ 80)。未评估维度不记 0 分,也不参与计算。
| # | 红线类型 | 级别 | 判定 | 说明 | 来源 |
|---|---|---|---|---|---|
| R1 | 已停更 | 禁止级 | 命中 | 最后一次推送 2024-09-18T17:46:55Z,距今约 773 天(>12 个月阈值)——触发禁止级红线,一票否决 | 原文 |
| R2 | 协议不明 | 警示级 | 未命中 | GitHub 识别为 Apache-2.0,无歧义 | 原文 |
| R3 | 高危 CVE | 禁止级 | 未命中 | security-advisories 返回空 | 原文 |
解剖:它到底怎么工作
可提示分割(promptable segmentation)的开创实现:图像编码器一次性算 embedding,之后用点/框/掩码提示的轻量解码器即时出 mask,这正是「分割基础模型」思路的起点。
核心机制
重型 image encoder(ViT-H/L/B)+ 轻量 promptable mask decoder 的两段式设计;同一张图编码一次即可反复交互出 mask。
三种 checkpoint(ViT-H/L/B)按算力选择,权重从项目页下载(README 载明)。
扩展点
sam_model_registry 按 model_type 加载;输出 COCO 风格 RLE mask,方便接下游标注/训练管线(README 依赖 pycocotools 可佐证)。
未评估
与 sam2 的精度/速度对比、ONNX 导出路径的实际可用性——需实测。
避坑指南
每条陷阱都有可点击来源(E1);没有来源的「坑」不写。本报告共 3 条。
你会看到:依赖解析失败、新 CUDA/torch 环境跑不起来时,不会有任何官方修复;issue 区 596 个 open issue 实质冻结。
根因:pushed_at = 2024-09-18(E1);releases 为空(E1)——维护在 SAM 2 发布后即停止。
缓解:新项目直接评估后继模型;存量系统把当前版本钉死在镜像里,当作「已完成的历史组件」维护。
证据 E1 · https://api.github.com/repos/facebookresearch/segment-anything
你会看到:想跟进官方最新分割能力,发现本仓库不再更新;转向 sam2 后发现其最近提交也在 5 个月前(2026-05-30)。
根因:官方后继仓库 facebookresearch/sam2 存在,pushed_at = 2026-05-30T02:29:40Z(E1),比本仓库新但仍超 5 个月无推送。
缓解:选型时把「Meta 研究仓库的维护节奏」当作常态预期:能力验证用官方仓库,生产部署预留自维护预算或选社区活跃分支。
你会看到:pip 装完 import 正常,运行时才发现 checkpoint 要去页面另行下载。
根因:README 的 Getting Started 明确要求先下载 model checkpoint 再初始化 sam_model_registry。
缓解:把权重下载固化进构建脚本或镜像层,避免运行时外链依赖。
证据 E1 · https://github.com/facebookresearch/segment-anything#readme
成本账
| 上手时间 | 未评估(未实测:未跑推理,显存与速度无数据) |
|---|---|
| 算力 | 推理需 GPU 实测确认;最大 checkpoint 的显存要求未实测 |
| 钱 | Apache-2.0 无许可费;无官方托管服务 |
| 长期维护 | 零维护预期:bug 自修、环境自适配 |
替代方案
| 候选 | 为什么可能不选它 |
|---|---|
| SAM 2(facebookresearch/sam2) | 能力更强(视频+图像)、代码更新;但其仓库同样 5 个月无推送,生产引入同样要评估自维护成本(E1) |
| 社区活跃的分割模型(如 EfficientSAM 系) | 维护更活跃,但精度与生态基线需按任务自行评测(推断 E3,未对比) |
证据链
展开全部 5 条证据(断言 → 来源 → 等级)
| # | 断言 | 等级 | 来源 |
|---|---|---|---|
| E1 | star = 55,081;pushed_at = 2024-09-18T17:46:55Z;license SPDX = Apache-2.0;open issues 596 | E1 | https://api.github.com/repos/facebookresearch/segment-anything |
| E2 | releases 列表为空(从未发版) | E1 | https://api.github.com/repos/facebookresearch/segment-anything/releases |
| E3 | README:pip install git+… 安装;需先下载 model checkpoint;可选依赖 opencv-python/pycocotools/matplotlib/onnxruntime | E1 | https://github.com/facebookresearch/segment-anything#readme |
| E4 | security-advisories 返回空列表 | E1 | https://api.github.com/repos/facebookresearch/segment-anything/security-advisories |
| E5 | 官方后继仓库 facebookresearch/sam2:star 20,080,pushed_at = 2026-05-30T02:29:40Z,license Apache-2.0 | E1 | https://api.github.com/repos/facebookresearch/sam2 |