Community影像github.com

ssjsjdjj/chutu-baidi-touming-v2

出圖-白底透明圖 V2:生成 800×800 白底 JPG、透明 PNG 以及按款彙總的高畫質像素圖層與獨立遮罩 PSD,保留未縮放原始素材,支援邊緣自檢、局部修復、確認鎖定,並可透過「開始 PS 精修」指令執行已排隊的 PS 任務。

chutu-baidi-touming-v2 是什麼?

此技能為產品或模特兒影像去背與精修提供完整工作流程,適用於 Claude Code、Cursor 等可執行自訂腳本的 AI 代理平台。它專注於 Windows 環境,使用獨立的 Python、u2net CPU 及 psd-tools 環境運行。核心功能為:從輸入圖片生成 800×800 的白底 JPG 與透明 PNG,以及包含高畫質未縮放像素圖層與可編輯遮罩的 PSD 檔案。技能內建嚴格的檔案大小限制(500KB)、自動壓縮調整、邊緣自檢與有限修復機制,並要求所有處理步驟皆需經由人工確認才可正式匯出。此外,它支援複雜的 PS 精修佇列,允許使用者將任務排隊,並在閒置時透過「開始 PS 精修」指令自動執行,過程中會使用 PS MCP/JSX 操作以避免干擾使用者。整體設計強調可控性、品質驗證與檔案完整性,避免自動化流程中的未經授權修改。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ssjsjdjj/codex-image-skills/tree/HEAD/kkc/skills/chutu-baidi-touming-v2

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

出圖 白底透明圖 V2

在目前 Windows 帳號的專用 Python、u2net CPU 和 psd-tools 環境執行。使用本目錄 runtime.json 明確指向的直譯器;首次移轉缺少環境時先恢復安裝,不使用系統 Python、不靜默降級成閾值去背。此版本與舊版共用同一帳號已安裝的專用出圖執行環境,程式碼獨立。

交付約定

  • 單張正式交付的白底 JPG、透明 PNG 均不得超過 500KB(以 500,000 位元組驗收);PSD、預覽和診斷圖不受此限制。匯出後逐張檢查實際位元組數;發現超標時必須先自動調整壓縮參數、重新匯出並複檢,達標且品質檢查通過後交付,不因首次超標直接結束處理。保持 800×800、主體細節和 PNG 有效透明 alpha;JPG 可最佳化編碼並在畫質可接受範圍內調整品質參數,PNG 先使用無損壓縮最佳化,顏色數允許時使用逐像素無損的調色板編碼,透明 alpha 保持一致。腳本按 500,000 位元組硬限制在暫存與正式寫入後複檢,清單記錄壓縮嘗試、最終大小和檢查結果;PNG 必須與確認像素一致,JPG 平均像素編碼誤差不超過 5,無法兼顧時在正式寫入前報錯並保留暫存診斷。僅調整編碼且不改變已確認效果時無需再次確認。若合理壓縮後仍超標,或繼續壓縮會損害畫質,則記錄實際大小及已嘗試的調整並說明情況,提出下一步方案;涉及尺寸、商品細節、顏色或透明邊緣變化時重新預覽確認,未達標圖片暫不交付為合格成品。
  • JPG、PNG 固定 800×800,主體較長方向預設佔畫布 80%,等比置中;只有使用者明確要求才調整,範圍 50%~95%。PSD 使用按款統一的高畫質方形畫布,至少 800px,以各圖去背範圍和佔比計算,商品層不向下取樣;高畫質畫布實際尺寸寫入清單。
  • 每張輸入各產生一張白底 JPG 和透明 PNG;每款只產生一份白底 PSD、一份透明 PSD。N 張、K 款的正式檔案數為 2N+2K。
  • 同款不同顏色及同色不同角度均為獨立 RGB 產品像素層,去背透明度儲存在獨立可編輯遮罩,不把已透明像素再乘同一遮罩。保留整張來源圖範圍內的 RGB,遮罩外區域可恢復;已缺失於輸入檔案的細節不能恢復。半透明邊緣採用已確認高畫質修訂的 RGB。
  • 白底 PSD 自下而上為可見白色背景、產品層及隱藏的「原始素材(隱藏)」組;透明 PSD 不含白色背景。僅首個產品層預設可見,原始素材組和組內各層均隱藏。組內按顏色/角度保留 EXIF 轉正後、未經縮放的原始影像像素及原始 alpha 遮罩,便於核對和回退。
  • 產品名稱與對應 PNG 一致,置中和佔比一致。PSD 與 800px 成品分別從同一已確認的高畫質候選產生;跨尺寸內插可能出現細微像素差,不將高畫質 PSD 直接宣稱為與 PNG 逐像素一致。未縮放原圖組用於保留原始細節,普通像素層後續反覆縮放仍會重新取樣。
  • 輸入唯讀。預覽、快取、診斷、清單和日誌放正式輸出目錄之外。衝突時停止,不覆蓋現有檔案。
  • 已有有效透明通道的輸入直接保留並檢查,預設不再次去背或修邊;使用者要求修改邊緣時才設 repair_existing_alpha:true。
  • 圖片可分白底圖/透明圖資料夾,或放同一款式目錄;PSD 始終位於款式目錄。保持使用者已經確認的命名及目錄選擇。

步驟計時與人工檢查

每個任務使用獨立的 --journal-root,所有入口指令沿用同一目錄。launch.py 在實際執行前寫開始、執行後寫結束、報錯時寫錯誤與耗時並立即落盤;步驟包括環境、任務檢查、去背、修邊、診斷、PSD 寫入和重開驗證。重跑保留前次記錄,AI 步驟巢狀不重複累加。不能繞過入口裸跑並宣稱計時完整。

使用者回覆「開始檢查」才呼叫 check-start;回覆「檢查完成」或已開始檢查後的明確效果確認才 check-finish。支援 check-pause/check-resume,不把等待人回覆計為檢查用時。未開始不能補造結束。詳細指令見計時流程。任務結束後 workflow-finish 與 timing-status;需要案例卡時同步到案例取證技能。

開始任務

看原圖,明確保留整個模特兒、僅產品還是指定物件。整版海報和多人拼圖不能當作單品直接去背。一次收集未明確的輸入範圍、款式、顏色、同色角度/序號、輸出位置與圖片目錄模式;不重複詢問已有選擇,不根據檔名猜款色,不丟棄同色圖。

複雜背景指定 cutout:rembg;已有透明輸入使用 auto。原圖原本被拍攝邊界截斷時記錄輸入限制,不補造商品或人物。

局部除錯用逐圖 keep_mask(恢復原圖 RGBA)、remove_mask(清除背景)和 protect_mask(保護已有去背像素),不得把某張圖的座標寫進通用腳本。遮罩尺寸與 EXIF 轉正後的原圖一致;白色生效、黑色不動、灰階控制強度。刪除區域與保留/保護區域重疊時報錯。review_regions 可標出 800×800 預覽中必須放大檢查的區域。欄位與範例見工作流與任務單。

任務單沿用 schema_version 2。格式、CLI 和複核記錄見工作流與任務單,首次使用本版必須讀取。檢視指令說明可執行:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<技能目錄>\scripts\run_bg.ps1" -h

自檢與有限修復

preview 為全部圖片建立唯一快取,儲存來源圖雜湊、EXIF 轉正原始素材、原解析度去背圖、初版、最多兩輪原解析度修訂候選、800×800 確認候選及診斷圖。高畫質素材及每個候選都有檔案和 RGBA 雜湊,確認綁定目前所選高畫質候選;匯出前核對高畫質候選經既定佈局產生的 800px 圖與確認候選逐像素一致。模型只在需要去背時執行,後續匯出不重新推理。

  • 數值檢查只輸出疑似風險,不把「深色像素」直接判為黑邊。黑色商品、髮絲、繩線和原本深色邊線可能正常;小連通區域也不一定是殘留背景。
  • 自動修復最多比較兩檔有界的半透明邊緣顏色淨化;每通道改變量分別不超過 16/24,只在疑似邊緣區域操作,透明 alpha 保持完全一致,保護細線和不透明主體內部。局部輪廓與內部孔洞必須使用明確遮罩,不能靠顏色或區域大小猜測刪除,不統一收縮輪廓、刪除碎片或重繪商品。
  • 每輪核對內部顏色、保護區像素和主體損失。檢查不通過的候選不能選擇;風險不下降時保留初版。最多兩輪,仍有問題則保留現場,集中交給人。
  • 已有透明圖不預設套用修復。任務提供 protect_mask 時,必須與 EXIF 糾正後的原圖尺寸一致,其白色區域完全保留。

診斷同時產生白、灰、黑及透明棋盤格背景,並為同一局部提供白/深灰/黑底 100% 原像素對照;優先包含指定 review_regions,再補疑似邊緣與輪廓。必須用影像工具實際檢視每張診斷,重點檢查帽簷、皮膚、髮絲、細繩、透明材質及背景殘留。數字未報警不代表視覺合格。

AI 複核後用 review 記錄每張圖的 passed/hold/rejected 和實際看到的依據;有疑似風險但判為正常時說明原因。無法判斷則 hold,不能編造看圖記錄。獨立後台無人值守若沒有可呼叫的視覺模型,保持視覺待確認;本腳本不內建遠端視覺服務。

預覽與確認

展示全部原圖到款式/色名/角度的對應、全部預覽、預計檔案數與目錄。大批可分頁,但最終確認前須有覆蓋全批的完整預覽;存在疑似問題時附局部對照。

詢問效果(確認/小 7%/大 7%/自訂)和 PS 選項:不用 PS、現在精修指定圖、進入 PS 精修佇列,閒置時輸入「開始 PS 精修」自動開始佇列。已授權的選擇不重複問。使用者指出黑邊等缺陷時,品質退回優先於同次回覆的「確認佔比」。

使用者明確確認目前版之後才執行 approve,證據欄位記錄確認原話或可核驗來源,再執行 batch。AI 自檢通過、模擬演練選擇、沉默和確認舊版都不構成目前真實圖片的使用者確認。來源圖、任務單、任一遮罩、處理程式碼、預覽/診斷圖、所選候選或複核記錄改變後,舊確認失效。確認記錄同時綁定 PNG 檔案雜湊與解碼 RGBA 像素雜湊;正式匯出只讀取已確認快取,不重新推理。

使用者提出問題時儲存「原話→對應版本→修復動作→前後對照→重新確認狀態」。人提出意見但尚未複核,不記錄為人工驗證閉環;AI 獨自發現的問題不能記作員工人工除錯。本技能不自動給績效分。

正式匯出與驗收

batch 僅使用已確認的 RGBA 快取,先暫存全部 JPG、PNG 和 PSD,重新開啟檢查後再排它寫入正式目錄:

  • PNG 解碼後的 RGBA 像素與確認候選一致(允許無損調色板編碼),透明 alpha 有效;JPG 角點白色、尺寸正確,壓縮差異在容差內。
  • 重新開啟兩份高畫質 PSD,檢查實際畫布尺寸、圖層名、預設可見性、產品 RGB 與獨立遮罩及其偏移,逐層切換核對高畫質合成;核對隱藏組原始素材逐像素未縮放儲存,並驗證停用產品遮罩可恢復被遮區域。高畫質合成允許 RGB 四捨五入誤差,遮罩及原始素材必須精確一致。
  • 寫入後再次核對數量、雜湊和格式;PSD 失敗或寫入中斷不能報告整批完成,不把失敗任務轉 PS 佇列冒充成功。

技術檢查狀態、AI 看圖狀態和人工確認狀態分開保留。含 hold/rejected 的批次不交付為已通過;正常結果和例外項在一張批次確認卡集中處理。

Photoshop 與驗證

白底、透明 PNG 和分層 PSD 無需 Photoshop。精修詢問保留「允許現在用 PS 局部精修指定圖」和「暫不使用 PS,保留返修狀態」,並增加第三項:「進入 PS 精修佇列,閒置時輸入『開始 PS 精修』自動開始佇列」。入隊只儲存明確的圖片、修圖範圍、原檔案雜湊和任務位置,當下不佔用 PS;不要把已完成圖片再次入隊。

使用者在聊天明確輸入「開始 PS 精修」(僅忽略大小寫與空格,相容「開始 ps 精修」「開始 PS 精修」)時,視為使用者主動聲明現在可使用 PS,並授權按順序執行已排隊的任務;立即啟動消費,不再問「是否開始」,也不因輸入口令剛重置閒置計時而額外等待 600 秒。先讀取佇列並領取任務,隨後在同一回合實際使用 PS 工具精修、檢視新預覽並記錄結果,不能只回覆「已準備好」。佇列為空時直接說明,不開啟 PS。

任務間和 PS 原子步驟的安全邊界檢查新的輸入事件;使用者恢復操作或無法可靠區分新輸入來源時暫停,保留已完成預覽及剩餘佇列,不強行中斷正在儲存的檔案。優先使用不會注入鍵鼠事件的 PS MCP/JSX 操作;GetLastInputInfo 本身不能區分人和 SendInput 自動化,不能把自己的模擬輸入誤報為人恢復操作。執行前發現未收尾的 running 任務時先核對自己的文件、工作檔案和日誌,再決定恢復位置,不能重複疊加濾鏡。

只按本次入隊範圍操作自己的文件並另存,原圖和其他文件不動。佇列資料中的腳本路徑或指令不直接執行;實際操作由目前回合的 PS 工具和視覺複核完成。完成一項先儲存工作檔案和新預覽,結果記錄實際使用 PS 及 passed/hold 觀察,記為 preview_ready 後再取下一項;hold 不能稱為修圖已合格。失敗或來源檔案變化記錄原因並暫停,不無限重試。修訂效果仍需使用者確認後才能正式匯出。沒有口令時不常駐監聽、不定時輪詢、不建立自動化任務;不自動安裝付費軟體或登入服務。佇列指令與任務格式見PS 精修佇列。

技能更新後用本版專用 Python 執行 scripts/selftest.py --skill <技能目錄> --work <全新測試目錄>。測試涵蓋風險提示、正常黑色保護、細線保護、透明輸入保留、確認失效、禁止未確認匯出、兩種目錄模式、按款 PSD、多角度、來源圖雜湊、故障現場和本機 u2net 推理。真實商品只產生預覽作回歸;未經使用者確認不把真實圖產生的修訂版當作可用標準答案。

高畫質遮罩專項回歸使用專用 Python 執行 scripts/selftest_hd_masks.py --work <全新測試目錄>,檢查大於 800 的素材、混合尺寸同款、半透明遮罩、誤刪區域恢復、未經縮放原始素材、高畫質候選快取篡改使確認失效,以及 JPG/PNG 仍為 800px。PSD 單邊超過 30000px 時報錯,不靜默縮小高畫質來源檔案。

壓縮規則專項回歸:用 runtime.json 指定的專用 Python 執行 scripts/selftest_image_size.py --work <全新測試目錄>,驗證超標 JPG/PNG 自動壓縮、PNG 像素及半透明 alpha 無損、500,000 位元組邊界、正式寫入後複檢,以及無法兼顧大小和畫質時在寫入前停止。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能