用途:通过严格、非交互的 CLI 调用独立 matting-api,为本地图片抠图、去背景并输出透明 PNG。算法、模型与运行状态以本次服务探测为准,不能把历史文档或模型名称猜测当作实时能力。
主要能力:支持读取服务状态与实时算法/模型能力;检查输入图的 alpha、边框颜色、均匀度与亮度等特征并给出推荐;根据返回的 method 与 model 交集中自动选择;已有有效 alpha 时默认保留并规范化为 PNG;可用 --reprocess 重抠;可通过 JSON 参数覆盖(如 halo_pixels、despill_strength)。输出只写 .png,默认拒绝覆盖,明确要求时才用 --force。
使用方式:CLI 前缀为 uv run --project {SCRIPTS_DIR} matting。典型流程:先运行 matting status 与 matting algorithms 检查配置与实时能力,再运行 matting inspect --input ./source.png 获取推荐,最后运行 matting remove --input ./source.png --out ./source-transparent.png 执行抠图。高成本请求可先加 --dry-run 校验。配置查找顺序为当前工作目录、skill 目录、当前 Git 项目根目录、~/.agents/agent_config.toml,也可用 --config 或 MATTING_CONFIG 指定。与 image-generation 配合时可优先用其 imggen remove-background 统一入口。
适用场景:本地图片去背景、需要透明 PNG 的素材处理,以及生成图去背景等流程。
限制:自动推荐是技术启发式,不能仅凭统计可靠识别人像、发丝、玻璃或烟雾,语义更强时可显式覆盖但需通过能力校验;配置缺失、无效、服务不可达或能力为空时必须明确报告不可用,不得声称已使用 matting-api;服务探测成功后任务失败须如实失败,不能静默换算法或改本地处理;不输出认证 header、API key 或环境变量值;health/HTTP 200 不等于抠图成功,只有下载结果通过校验并写入目标路径才算完成。