前言¶

在 Cursor、Claude Code 等 Agent 里处理设计素材时，常见需求是：把人像或商品抠成透明 PNG、修发丝边缘、从双人海报里只留某一侧角色，或在抠图后再做放大和锐化。若每次手写 rembg、pymatting 或各家 API 的调用链，成本高且容易漏掉批量汇总、多主体定向等细节。

下面介绍 SkillHub 社区 Skill smart-bg-removal-sharpen（坐标 @user_a7af8eab/smart-bg-removal-sharpen）。它把标准抠图、发丝精修、BRIA 超精度、多主体提取，以及本地放大/锐化/一体增强封装成统一脚本入口，由 Agent 按自然语言选择档位并执行。

这是什么¶

smart-bg-removal-sharpen 是面向 design-media 类的智能抠图与图片增强 Skill，版本 1.0.0，来源为 community，由发布者 user_a7af8eab 维护。

官方入口：

• API 页：https://api.skillhub.cn/user_a7af8eab/smart-bg-removal-sharpen
• SkillHub 页：https://www.skillhub.cn/skills/user_a7af8eab/smart-bg-removal-sharpen

Skill 说明支持本地模型与在线 API 双模式，并约定默认优先走统一入口 scripts/run_bg_removal.py；放大、锐化、增强则分别走 upscale_image.py、sharpen_image.py、enhance_image.py。SkillHub 标签标明 requires_api_key=true（在线抠图路径需要配置对应环境变量）。

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与脚本说明，可按场景组合使用。

抠图与主体提取

• 人像、商品、通用图片去背景，输出透明背景 PNG（.png、.jpg、.jpeg、.webp、.bmp）。
• 三档精度：标准（remove_bg.py / rembg）、精修（refine_matting.py，发丝与复杂边缘）、超精度 BRIA（remove_bg_bria.py，失败可自动降级）。
• 多主体定向提取（extract_target_subject.py）：按左/右/中间目标抠出单一角色，并通过多模型融合尽量补回武器、头绳、飘带等离散附件。
• 单张与批量；批量默认额外生成 batch_summary.md 与 batch_summary.json。

图片增强（本地）

• 放大：upscale_image.py，支持 2x、4x 及自定义倍数，模式含 illustration、photo、lineart。
• 锐化：sharpen_image.py，预设 light / medium / strong。
• 一体增强：enhance_image.py，放大与锐化组合，适合抠图后的角色 PNG。

在线 API（可选）

• remove_bg_api.py 支持 Remove.bg、腾讯云人像分割、Clipdrop；环境变量与申请方式见包内 references/api_config.md。

安装与启用¶

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方说明执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

文档：https://skillhub.cn/install/skillhub.md

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须使用 --dir 指向 Agent 实际识别的 skills 目录，否则可能装到默认 ./skills/ 而无法加载。常见路径（以 SkillHub 文档为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装命令示例（Cursor）：

skillhub install smart-bg-removal-sharpen --namespace user_a7af8eab --dir ~/.cursor/skills/

也可在对话中让 Agent 按 https://skillhub.cn/install/skillhub.md 安装 @user_a7af8eab/smart-bg-removal-sharpen。

3、Python 依赖与 API Key¶

本地抠图与增强需要可用的 Python 环境，以及 rembg、pymatting、torch 等依赖（Skill 文档给出 pip 安装示例）。BRIA 首次使用需从 Hugging Face 获取 briaai/RMBG-2.0 并同意模型条款；许可为 CC BY-NC 4.0（非商用）。

在线模式需配置环境变量（优先级与说明见 references/api_config.md），例如：

export REMOVE_BG_API_KEY="your_key_here"
export CLIPDROP_API_KEY="your_key_here"
export TENCENT_SECRET_ID="your_secret_id"
export TENCENT_SECRET_KEY="your_secret_key"

安装或更新 Skill 后，按你所用客户端要求重启或刷新 Agent，以便加载新 Skill。

典型用法¶

进入 Skill 安装目录后，脚本路径相对于该目录。下列命令将 python3 换为你环境中已装好依赖的解释器即可。

统一入口（推荐）

# 标准抠图
python3 scripts/run_bg_removal.py input.jpg output_no_bg.png

# 发丝精修
python3 scripts/run_bg_removal.py input.jpg output_no_bg.png --quality refine

# BRIA 超精度（失败可降级）
python3 scripts/run_bg_removal.py input.jpg output_no_bg.png --quality best

# 只抠右侧角色
python3 scripts/run_bg_removal.py poster.png right_char.png --subject right

# 目录批量 + 定向主体
python3 scripts/run_bg_removal.py ./inputs ./outputs --batch --subject right

放大与锐化

python3 scripts/upscale_image.py char.png char_2x.png --scale 2 --mode illustration

python3 scripts/sharpen_image.py char.png char_sharp.png --preset medium

python3 scripts/enhance_image.py char.png char_hd.png --scale 2 --mode illustration --preset light

在线 API 示例

python3 scripts/remove_bg_api.py input.jpg output.png --api remove_bg
python3 scripts/remove_bg_api.py portrait.jpg output.png --api tencent
python3 scripts/remove_bg_api.py input.jpg output.png --api clipdrop

在 Agent 对话中，可直接用自然语言描述意图（如「发丝再精修」「像 Clipdrop 一样干净一点」「只要右边角色」「放大 2 倍再锐化」）；Skill 文档中给出了与 --quality、--subject、--scale、--preset 等参数的对应关系，便于 Agent 选用上述命令。

适用场景与注意¶

适合谁

• 需要在 Agent 工作流里反复做抠图、透明素材导出、电商/人像修边、游戏或动漫海报多角色分离的团队或个人。
• 希望在本地完成放大、锐化，减少把原图上传到第三方服务的场景；对隐私或批量离线处理有要求时，可优先本地 rembg + 精修路径。

限制与注意

• 本地首次运行会下载分割模型，BRIA 另有 Hugging Face 授权与非商用许可约束。
• 腾讯云 API 仅人像；通用物体应选 Remove.bg 或 Clipdrop，或走本地模型。
• 在线 API 有各自免费额度与尺寸限制（详见 references/api_config.md）；SkillHub 元数据要求 API Key 时，未配置则只能依赖本地能力。
• Skill 文档中的示例 Python 路径针对特定 workbuddy 环境；在其他机器上应使用本机 venv 并自行验证 import rembg 等依赖。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 793；以 SkillHub 实时页面为准。

结尾¶

smart-bg-removal-sharpen 把抠图多档位、多主体提取与本地增强脚本收敛到同一 Skill，适合挂在 Cursor 等 Agent 上，用对话驱动单张或批量透明 PNG 产出。安装与优先源配置见 https://skillhub.cn/install/skillhub.md ；Skill 详情见 https://www.skillhub.cn/skills/user_a7af8eab/smart-bg-removal-sharpen 。