withoutBG 纯 Go 封装小记

Sat, 19 Sep 2026 00:00:00 +0000

把 withoutBG 的开放权重模型包成了一个纯 Go 库：github.com/lib-x/withoutbg-go 。和上一个 PP-OCRv6 的封装一样，用 pure-onnx 通过 purego 调 ONNX Runtime，不需要 CGO，也不用装 PyTorch。

这个模型做的是背景去除：输入一张 RGB 照片，输出一张 alpha 蒙版，把蒙版挂到原图的 alpha 通道上就是抠图。模型仓库是 withoutbg/withoutbg-openweights-onnx ，455MB，Apache-2.0。

这篇记录的重点和上一篇不同：上次的第一手来源是模型自带的 inference.yml，这次是模型自带的 sidecar JSON；上次的难点是动态形状和字典映射，这次的难点是几何（letterbox 怎么缩放、蒙版怎么裁回去），踩错一步人物边缘就会被啃掉一圈。

先看术语：抠图和它的度量

没接触过图像处理也没关系，先看这几个词。

抠图（matting）和分割（segmentation）不是一回事。 分割给每个像素一个"是不是前景"的二值标签，抠图给的是 0 到 1 之间的连续值，叫 alpha 蒙版。连续值是为了处理半透明和边缘过渡：发丝、玻璃、烟雾这类区域，一个像素里可能一半是前景一半是背景，硬二值会切出锯齿。这个模型输出的就是连续 alpha。

alpha 合成，把抠图结果和任意背景拼起来用的公式：

C = \alpha F + (1-\alpha) B

$F$ 是前景色，$B$ 是新背景，$\alpha$ 是蒙版值。$\alpha=1$ 保留原像素，$\alpha=0$ 完全换成背景，中间值按比例混合。库里 Remove() 返回的就是"原图颜色 + 新 alpha 通道"。

letterbox：把任意比例的图塞进正方形输入框的标准做法，等比缩放让长边贴到目标尺寸，空出来的地方填固定颜色。和直接拉伸成正方形的区别是：拉伸会改变物体形状，模型会把形变当成内容。

NCHW：张量内存布局，依次是批、通道、高、宽。这个模型的输入是 [1, 3, 448, 448]。

图像处理 on 虫子樱桃

withoutBG 纯 Go 封装小记

先看术语：抠图和它的度量