Communitygithub.com

490437477-sys/codex-skills-backup

Codex 스킬 + 플러그인 스킬 + 도구 구성 백업

codex-skills-backup란 무엇인가요?

이 스킬은 Alibaba Cloud Vision Intelligence Platform을 활용하여 이미지의 주요 객체를 분할하고 흰색 배경 이미지, 투명 PNG 또는 크롭된 이미지를 생성합니다. 사용자는 이미지가 포함된 디렉터리 또는 단일 이미지 파일을 입력으로 제공할 수 있으며, 기본적으로 입력 디렉터리(또는 파일이 위치한 디렉터리) 아래에 `白底图` 서브디렉터리를 생성하여 결과를 저장합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 '백그라운드 도구'로 구성되어 있습니다. 지원되는 세분화 모델로는 상품, 일반, 인체, 식품, 동물, HD 일반, 의류, 로고, 차량, 하늘 등이 있으며, 각 모델은 흰색 배경, 마스크(투명 PNG), 크롭 중 원하는 출력 형식을 선택할 수 있습니다. 사용자는 명확한 CLI 명령어와 옵션(-m, -f, -o)을 통해 스킬을 제어할 수 있으며, 환경 변수나 스크립트 내 자리 표시자를 통해 Alibaba Cloud 자격 증명을 구성해야 합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add 490437477-sys/codex-skills-backup

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

흰색 배경 이미지

Alibaba Cloud Vision Intelligence Platform을 통해 이미지의 주요 객체를 분할하고 흰색 배경 이미지, 투명 PNG 또는 크롭된 이미지를 출력합니다. 기본 동작: 원본 디렉터리(또는 원본 파일과 동일한 디렉터리)에 白底图 서브디렉터리를 생성하여 결과를 저장하며, -o 옵션으로 덮어쓸 수 있습니다.

기본 출력 위치

입력기본 출력 디렉터리
디렉터리 ./photos/./photos/白底图/
파일 ./photos/a.jpg./photos/白底图/a.jpg

다른 위치로 출력하려면 -o /path/to/out 옵션을 명시적으로 지정합니다.

사전 조건

pip install alibabacloud_imageseg20191230 alibabacloud_tea_openapi alibabacloud_tea_util Pillow

자격 증명 구성

환경 변수를 우선 사용하며, 설정되지 않은 경우 스크립트에 내장된 자리 표시자를 사용합니다(프로덕션 환경에서는 반드시 환경 변수로 변경).

setx ALIBABA_CLOUD_ACCESS_KEY_ID "your-key"
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET "your-secret"

사용 방법

scripts/aliyun_seg.py 스크립트를 직접 실행합니다.

디렉터리 일괄 처리 (기본 출력: 원본 디렉터리/白底图)

python scripts/aliyun_seg.py ./photos                      # 상품 분할 + 흰색 배경 이미지
python scripts/aliyun_seg.py ./photos -m body              # 인체 분할
python scripts/aliyun_seg.py ./photos -f mask              # 투명 배경 PNG
python scripts/aliyun_seg.py ./photos -o ./out -f crop     # 객체 영역으로 크롭, ./out 에 출력

단일 이미지 (기본 출력: 원본 파일과 동일한 디렉터리/白底图)

python scripts/aliyun_seg.py ./photos/a.jpg                # → ./photos/白底图/a.jpg
python scripts/aliyun_seg.py ./photos/a.jpg -o result.png  # → ./result.png

도구

python scripts/aliyun_seg.py --list-models                 # 지원되는 모든 모델 리스트

지원되는 모델

모델설명반환 형식
commodity상품 분할 (흰색 배경 이미지 기본값)whiteBK / mask / crop
common일반 분할whiteBK / mask / crop
body인체 분할whiteBK / mask / crop
food식품 분할whiteBK / mask / crop
animal동물 분할whiteBK / mask / crop
hd_commonHD 일반 분할분할 결과 이미지만
cloth의류 분할분할 결과 이미지만
logo로고 분할분할 결과 이미지만
vehicle차량 분할분할 결과 이미지만
sky하늘 분할분할 결과 이미지만

반환 형식

  • whiteBK — 흰색 배경 (기본값, 가장 일반적)
  • mask — 투명 배경 PNG
  • crop — 객체 경계 상자로 크롭

내부 흐름 (오류 발생 시 참고)

  1. Pillow로 이미지의 가장 긴 변을 확인하여 2000px를 초과하면 비율을 유지하며 축소합니다 (Alibaba Cloud의 하드 제한 ≤ 2000×2000).
  2. *AdvanceRequest.image_urlobject = open(...)을 사용하여 바이너리 파일을 업로드합니다.
  3. client.segment_xxx_advance(req, runtime)을 호출합니다.
  4. resp.body.data.image_url은 서명된 OSS CDN URL이며, urllib.request.urlretrieve를 사용하여 로컬에 다운로드합니다.
  5. 출력 파일 이름은 원본 파일의 stem을 유지하며, 확장자는 반환 형식에 따라 결정됩니다 (mask→png, 그 외에는 원본과 동일).

주의 사항

  • 이미지가 2000×2000px를 초과하면 스크립트가 자동으로 축소하며 원본 해상도는 유지되지 않습니다.
  • 투명 배경(mask) 출력의 확장자는 .png이며, 그 외에는 입력 확장자를 따릅니다.
  • 자격 증명이 스크립트에 하드코딩되어 있는 것은 자리 표시자이며, 프로덕션 환경에서는 환경 변수를 사용하는 것이 좋습니다.
  • PNG / JPG / JPEG / WebP / BMP 입력을 지원합니다.
  • 네트워크: 스크립트가 Alibaba Cloud가 반환한 서명된 URL을 다운로드하므로, 머신이 공용 네트워크에 접근 가능해야 합니다.

관련 스킬