photo-kit은(는) 무엇을 하나요?
모든 픽셀 결정은 scripts/photo_kit.py에서 이루어집니다. 당신의 역할은 이 스크립트를 실행하고, 보고서와 리뷰 시트를 읽고, 조정이 필요한 일부 사진에 대한 재정의를 작성한 후, 해당 사진만 다시 실행한 다음, 폴더를 사람에게 전달하는 것입니다.
다른 방법으로 이미지를 편집하지 마십시오. 검사가 두 번 실패하지 않는 한 스크립트를 다시 작성하지 마십시오.
설정 (프로젝트당 한 번)
- Python 3.10+ 및
pip install -r requirements.txt(Pillow 10.1+, numpy, opencv-python-headless, fontTools, brotli). config.default.json과 다른 항목만 나열하는 프로젝트 설정 JSON (브랜드 로고, 글꼴 파일, 색상, URL, 선택적 재질 견본).
웹 글꼴은 종종 하위 집합으로 분할됩니다.brand.font에 모든 파일을 나열하십시오.
실행
python <skill-folder>/scripts/photo_kit.py process IN_DIR OUT_DIR --config <project-config.json> [--overrides OUT_DIR/overrides.json] [--only stem1,stem2]
python <skill-folder>/scripts/photo_kit.py cards OUT_DIR cards.json --config <project-config.json>
python <skill-folder>/scripts/photo_kit.py verify OUT_DIR
사진당 출력: OUT_DIR/<stem>/00_master.png (무손실), 플랫폼 JPEG, 선택적 브랜드 카드; manifest.csv, report.json, 및 _review/before_after_NN.jpg.
입력 폴더나 웹사이트 소스 트리 내부에 출력 디렉터리를 절대 쓰지 마십시오.
검토 루프 (텍스트 먼저, 이미지 나중)
- 콘솔 요약과
report.json을 읽습니다. 명확한 신호(건너뛴 큰 기울기,TOO SMALL플래그, 명백한 색조, 늘어나 보이는 인물 등)에 대해서만 조치를 취합니다. - 리뷰 시트를 한 번 엽니다. 잘못된 자르기의 경우
{"focus": [x, y]}(마스터의 0–1)을 설정합니다. OUT_DIR/overrides.json을 작성하고 영향을 받은 스템만--only를 사용하여 다시 실행합니다.- 카드: 승인된 헤드라인만 포함하는
cards.json을 작성합니다 (최대 ~45자). 세로형 카드의 세로형 사진에는"fit": "whole"를 사용합니다. verify를 실행하고 (clean이 출력되어야 함), 폴더 경로, 플랫폼 목적, 남은 플래그 및 수정할 수 없는 사진을 보고합니다. 사람이 업로드 전에 모든 것을 감사합니다.
사진 라이브러리 순위 평가
주제별 하위 폴더가 있는 폴더에서 process를 실행합니다. report.json의 quality 점수(sharpness × 해상도 계수)로 순위를 매기고, TOO SMALL 플래그에 패널티를 적용한 후, 상위 후보의 연락처 시트를 검토합니다.
절대 변경되지 않는 규칙
- Google Ads 이미지: 일반 내보내기만 허용 (로고, 텍스트, 프레임 또는 테두리 없음).
- Business Profile: 밝기 보정만; 기본적으로 일반 내보내기.
- 제품을 절대 변경하지 않음: 재색칠, 질감 추가, 결함 제거, AI 채우기 없음. 클러터 자르기는 괜찮습니다.
- 조직 자체 사진만 사용. 고객 얼굴, 집 번호, 타사 사진작가 크레딧 금지.
- 원본 유지; 출력은 항상 새 파일입니다.
- 카드 헤드라인은 승인된 카피에서만 가져옵니다.
튜닝
correction 강도와 card_formats는 프로젝트 설정에서 조정합니다 (스크립트 아님). 사진별 재정의는 예외를 처리합니다.