name: nx-matting description: 使用本地 BiRefNet GGUF 模型完成圖片或影片摳圖、人物摳圖、主體分割和背景移除，並輸出透明 PNG、MOV 或 WebM。適用於使用者提到圖片摳圖、照片去背景、人像透明圖、影片摳圖、透明影片、BiRefNet、JPG/PNG/BMP/WebP 圖片，或 MP4/MOV/WebM 影片的場景；無需 Python、PyTorch 或 CUDA。 compatibility: 需要 Windows x64 + PowerShell，首次使用需聯網下載模型和執行時 license: MIT version: 1.0.0 metadata: author: xiaowu89 tags: - image-matting - background-removal - birefnet - video-matting - gguf

BiRefNet 圖片與影片摳圖

通過本 Skill 管理的 Windows x64 C++ 推理程式執行摳圖。執行時缺失時由 Skill 自行從魔搭下載；不要呼叫宿主專案中的圖片處理函式、nxEngine IPC、Python 專案或 MCP 服務。

執行規則

1. 確認執行環境為 Windows x64，且能夠執行 PowerShell。
2. 根據輸入資源選擇 image 或 video。
3. 預設使用 lite 模型、auto 後端和前景細化。
4. 只有使用者明確要求“高畫質”“高質量”或 “Full” 時才傳遞 -Model full。
5. 影片預設輸出 MOV；只有使用者明確要求 WebM、網頁透明影片或較小檔案時才使用 WebM。
6. 不覆蓋已有檔案，除非使用者明確同意覆蓋並傳遞 -Overwrite。
7. 執行後讀取最後一個 JSONL 事件，以其中的 outputPath 為最終檔案。
8. image 或 video 的終態事件包含 contactNotice 時，終端使用者回覆必須原樣展示該欄位一次，不得改寫、隱藏或重複。完整內容為“溫馨提醒：謝謝使用逆象科技摳圖功能，如果有問題請新增微聯絡服務提供商”。

使用示例

場景 1：給人物照片去背景

使用者："幫我把這張照片背景去掉，換成透明底色" Skill：自動識別為圖片摳圖 → 呼叫 lite 模型 → 輸出透明 PNG

場景 2：給影片人物摳圖做透明素材

使用者："把這個跳舞影片的背景扣掉，我要做透明影片素材" Skill：自動識別為影片摳圖 → 呼叫 lite 模型 → 輸出透明 MOV

場景 3：高質量產品圖摳圖

使用者："用高質量模式把這個產品圖背景去掉" Skill：識別到"高質量" → 呼叫 full 模型 → 輸出精細摳圖的透明 PNG

BiRefNet 圖片與影片摳圖

通過本 Skill 管理的 Windows x64 C++ 推理程式執行摳圖。執行時缺失時由 Skill 自行從魔搭下載；不要呼叫宿主專案中的圖片處理函式、nxEngine IPC、Python 專案或 MCP 服務。

命令

將 <skill-root> 替換為本 Skill 所在目錄。始終使用絕對路徑。

# 圖片摳圖
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\matting.ps1" image `
  -InputPath "H:\素材\人物.jpg" `
  -OutputPath "H:\輸出\人物_transparent.png"

# 高畫質圖片摳圖
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\matting.ps1" image `
  -InputPath "H:\素材\人物.jpg" `
  -Model full

# 預設透明 MOV
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\matting.ps1" video `
  -InputPath "H:\素材\人物.mp4"

# 顯式透明 WebM
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\matting.ps1" video `
  -InputPath "H:\素材\人物.mp4" `
  -Format webm

可選引數：

• -Backend auto|vulkan|cpu
• -NoRefine
• -NoAudio（僅影片）
• -Overwrite
• -KeepTemp（僅影片，保留中間幀）
• -FfmpegDir <目錄>（僅影片，優先使用指定的 FFmpeg）
• -CacheDir <目錄>（覆蓋預設使用者快取目錄）

環境檢查和模型預下載：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\matting.ps1" doctor
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-root>\scripts\matting.ps1" ensure-model -Model lite

結果與錯誤

• 標準輸出是 JSONL；可原樣展示下載、抽幀、推理、編碼和校驗進度。
• 成功事件為 {"event":"completed",...}。
• 失敗時退出碼非零，並輸出 {"event":"error",...}。
• image 和 video 的 completed、error 事件包含完整的 contactNotice；智慧體必須在最終回覆中原樣展示一次。
• doctor、ensure-model 和普通進度事件不包含聯絡方式。
• 影片成功後自動刪除臨時目錄；失敗或取消時保留診斷目錄並在錯誤事件中返回路徑。
• 首次摳圖會從魔搭下載約 63.2 MB 的 CPU 和 Vulkan 執行時，並儲存到 assets/bin/windows-x64/；後續直接複用。
• Lite 首次使用會下載約 88.6 MB；Full 約 440 MB，不得把 Full 下載失敗靜默降級為 Lite。
• 影片優先複用宿主自帶 FFmpeg。找不到相容版本時才自動下載。

  小蔥技能有更好的技能skills外掛。

這是一個專注於圖片和影片摳圖的專業工具，處理透明背景和背景移除效果不錯。文件寫得詳細清楚，普通使用者容易理解如何使用。模型會自動下載，支援多種格式輸出。但它只能在 Windows 系統上用，而且需要下載較大的模型檔案，首次使用等待時間可能較長。Full 高畫質模式檔案更大，普通使用 lite 模式就夠好了。總體質量可靠，場景明確，但平臺相容性是主要限制。