菜单
그림 1장 업로드 → 풀 리깅 아바타 전자동 서버 파이프라인(Modal) 러너북. spec_from_image(VLM 스펙 초안)+generate_master_sheets --reference(정체성 운반)+See-through GPU+P2~P5+표현력 옵션을 원커맨드로. 트리거 — "업로드로 아바타", "서버에서 리깅", "modal 리깅", "그림 한 장으로 버튜버", "upload e2e", "P2 게이트". 2026-07-09 URO(레포 밖 임의 그림)로 실증 — 실측 $1.8~2.5/명·25~40분.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
정수리 crown reveal + THA3 회전 증류 — 끄덕임/들기/도리도리/대각선을 자연스럽게. THA3 신경망을 모션 오라클로 써서 flow를 리그 키폼으로 받아쓰기(런타임 GPU 0·2048 화질 유지) + gpt-image 정수리 자산을 앞머리 뒤 reveal 레이어로 주입. 트리거 — "머리 회전 자연스럽게", "정수리 reveal", "crown", "끄덕임 개선", "THA 증류", "대각선 시선", "rotation distill". 2026-07-08 유키(snack-yuki-001)로 end-to-end 실증·Vercel 배포.
ChatterBox 의상실에서 "PNG 1장 업로드 → 자동 리깅 → 인앱 Live2D 아바타 수령"을 세우는 배선·배포 런북(CHATTERBOX-RIG-PORT-001 P3). Vtube Modal 파이프라인을 ChatterBox Supabase(avatar_jobs·Storage·Realtime)에 잇는다 — vgen 잡 클론 + FAL→Modal 스왑. 트리거 — "채터박스 아바타 배선", "PNG to live2d 웹연동", "의상실 아바타 생성", "avatar forge", "Modal 웹엔드포인트 배포", "avatar_jobs". 2026-07-09 미미 서버본으로 수령/렌더 반쪽 실증.
AUTORIG 리그(mini_cubism character.json)의 유기적 연결 건강성을 3층으로 진단한다 — L1 구조(파트=메시 짝·고아 디포머·파라미터 구동·draw order 겹침·타깃 실존), ★L2 깊이 게이트(커버리지·단조성=회전 시 가까운 부품이 먼 부품보다 더 움직이나·과대진폭 방지, depth_map 대조), 프로(Strong20) 정량 대조. 결정론 게이트(scan_rig_health.py)는 메인이 돌리고, L3 시각 건강성은 극단포즈 실렌더 A/B로 별도 판정. 트리거 — "리그 건강성", "리그 건강성 체크", "유기적 연결 체크", "디포머/키폼/깊이 점검", "rig health", "리그 QA", "새 캐릭터 빌드 후 검사", "깊이 단조성", "리그 스캔". 깊이 역전 WARN 시 inject_depth_keyforms.py로 교정.
AUTORIG 추출/분리 단계의 *절대 매직넘버*(008 아카네 픽셀에 손튜닝된 lum<150·MIN_PX=5000·LUM_MAX=150 등)를 *이미지 자체 통계*(피부 중앙값·MAD·앵커 면적 비율·영역 분위수)로 바꿔 캐릭터가 바뀌어도 안 깨지게 한다. 무회귀 A/B($0, 006/007/008 재추출 비교)로 검증. 트리거 — "임계값 상대화", "하드코딩 임계값", "캐릭터 바뀌면 추출 깨짐", "새 캐릭터 추출 일반화", "adaptive thresholds", "절대값 상대화", "추출 임계값 캐릭터 적응", "threshold relativization", "AUTORIG-THRESHOLD-REL".
단일 2D 애니 원화 → StdGEN(CVPR2025) 오프라인 3D 의미분해 복원 → 정수리/뒷머리 reveal 자산 베이킹 → 우리 2.5D 리그 주입. 머리 강회전(끄덕임 정수리·턴 귀뒤)의 "disocclusion 픽셀 부재" 천장을 *3D를 자산 생성기로만* 빌려 푼다(런타임은 현 2.5D 경량 유지). Colab A100. 트리거 — "정수리 reveal 생성", "머리 강회전 자산", "StdGEN", "3D 베이킹", "hair 별도메시", "끄덕임 정수리", "disocclusion 생성", "3D reveal bake".
마스터 1장 → THA3(Talking Head Anime 3) 신경망으로 자연스러운 머리 좌우턴/끄덕임 자산 추출. 핵심은 신경망 내부 appearance-flow(editor grid_change) 텐서를 직접 export해 맥 네이티브 cv2.remap 워프 + 리그 디포머 변위로 재사용. 트리거 — "머리 회전", "고개 돌리기/끄덕임", "THA3", "flow 텐서 추출", "head rotation", "2D 머리 턴", "appearance flow", "원본화질 회전 자산". 2026-06-20 008 아카네로 flow export end-to-end 실증(L1=0.0055 검증).
| name | autorig-upload-e2e |
| description | 그림 1장 업로드 → 풀 리깅 아바타 전자동 서버 파이프라인(Modal) 러너북. spec_from_image(VLM 스펙 초안)+generate_master_sheets --reference(정체성 운반)+See-through GPU+P2~P5+표현력 옵션을 원커맨드로. 트리거 — "업로드로 아바타", "서버에서 리깅", "modal 리깅", "그림 한 장으로 버튜버", "upload e2e", "P2 게이트". 2026-07-09 URO(레포 밖 임의 그림)로 실증 — 실측 $1.8~2.5/명·25~40분. |
앱: scripts/modal_rig_app.py (Modal chatterbox-rig). 준비 1회: pip install modal && modal token new(venv ~/.venvs/modal), 시크릿 modal secret create vtube-openai OPENAI_API_KEY="$(cat ~/.config/vtube/openai_api_key)".
# 업로드 경로(임의 그림 1장 → 전자동)
nohup ~/.venvs/modal/bin/modal run --detach scripts/modal_rig_app.py \
--exp-id snack-<id> --upload <그림.png> --expressive [--no-tha4] [--no-crown] \
> /tmp/<id>.log 2>&1 & disown
# 기지 자산 경로: --master/--mouth-sheet/--eye-expr-sheet/--accent-sheet/--character-yaml
# (+ --optimized-dir <분해캐시> --skip-decompose = GPU 0원 재실행)
# 회수(재빌드용): ⚠️ modal volume get 폴더 다운로드는 이 맥서 깨짐(Errno 21·단일 파일만).
# → 필요한 것만 개별 회수: rig/character.json + rig/mini_rig.json + rig/parts/*.png
# (meshes는 character.json 내장, reports/depth_map 불요). OG 마스터=inputs/master.png.
# 목록: modal volume ls rig-jobs-vol jobs/<exp-id>/rig/parts | grep '\.png$' (2026-07-09 URO 실증)
체인: generate_inputs(VLM 스펙 초안→시트 4종, P0 선행검증+FAIL 시트만 자동 리롤 2회 SHEET-AUTO-REROLL-001) → seethrough_decompose(A10G 2048, A100 불요) → build_rig(P2~P5 + 표현력: THA3 flow·THA4 grid GPU 병렬 스폰 → 주입 → scan_rig_health FAIL 0 게이트). 실패한 표현력 단계는 잡을 안 죽이고 degraded에 기록(티어 강등).
무디버깅 자산 게이트(P2 자동, 2026-07-09): deghost → fill_composite_holes.py(중립 합성==마스터 — 컷이 지운 정품 픽셀을 마스터 RGB로 인접 파트에 백필; URO 강아지귀 423k px 통째 소실 적발) → cut_orphan_strokes.py --auto(hair_back의 fill 없는 외곽선 호를 링 알파 최다 파트로 재배정, 자기 파트 지배 시 잔류=아호게 보호). 메시 빌드 전이라 복원 픽셀을 하류가 통째 흡수.
assembly_nohair)에서 잘리고 피부 정규화+lash_tint(spec arap_eye.lash_tint: auto=속눈썹 실측색) 적용.--no-tha4가 안전 기본 후보): 어두운 머리·비표준 화풍에서 재작화 이물(URO). 켤 땐 [[autorig-tha4-eyes]] 함정표 참조.--no-crown 권장): 불투명도 페이드인 중 반투명 돔이 "유령"으로 보임(URO·유키 공통 판정 2026-07-09). 손잡이는 spec crown: 섹션(CROWN-SPEC-001).rig-jobs-vol: jobs/<id>/{upload,inputs,optimized,tha/{input_512,grid_change_flow},tha4_grid,crown} — 분해·THA flow/grid·crown 자산 전부 볼륨 캐시라 재실행 시 재과금 0. 가중치(THA3 834MB·THA4 625MB·ESRGAN·HF 7.8G)=rig-hf-cache 1회.
| 함정 | 증상 | 해법 |
|---|---|---|
로컬 modal run 프로세스 kill | --detach여도 원격 인풋 취소 전파 | nohup+disown 고아화 필수, 완료 감시는 로그/볼륨 폴링 |
| 로컬 네트워크 flaky | ConnectionError로 런처 사망 | --detach라 원격은 계속 — modal app list/logs로 이어받기 |
| 시트 P0 FAIL | 입꼬리 편차 등 | 자동 리롤이 처리. 2회 실패=입력 이미지 부적합 안내 |
| 잇새 세로줄 입 | wide 셀에 이빨 분할선 | 프롬프트 TEETH-BAND-001(통짜 밴드 강제) 반영됨 |
| 순백 배경 잔재(흰 돔) | 정면 머리 위 흰 밴드 | deghost 배경 흰 지대 컷(타이트 실루엣 밖 근백 + border-flood 연결성, 스티커 흰 속살 보존) 반영됨 |
| 유령 호/흰 초승달(끄덕임에 머리 위 호 분리) | See-through가 hair_back에 구운 fill 없는 외곽선 호 — crown 제거해도 지속 | 파이프라인 P2 cut_orphan_strokes.py --auto 재배정이 처리(ORPHAN-STROKE-001). 빌드 후 로컬 수술은 --parts/--to+메시 bbox 주의 |
| 파트 결손(마스터엔 있는데 리그에 없음) | 렌더만 봐선 완성처럼 보임(URO 귀 2짝·미미 블라우스 잠복) | 파이프라인 P2 fill_composite_holes.py가 자동 백필(COMPOSITE-HOLE-001). 빌드 후엔 --meshes-dir(bbox 클립)·--max-size(거대 결손=재빌드) |
| 재실행 시 볼륨 inputs 캐시 = 리롤 전 원본 | P0 시트 게이트 FAIL로 잡 사망, 또는 구판 시트로 조용히 회귀(입 잇새 재발) | 재실행 --mouth-sheet 등은 리롤 통과본으로 — 업로드가 volume inputs를 덮어씀. 성공 시트는 회수해 보존할 것 |
| 합성이 마스터와 다름(줄무늬·베일·색 뮤트) | 어떤 단계가 구운 오염 픽셀(neck_skin 크림박스 등) | recolor_composite_to_master.py(COMPOSITE-DIFF-001) — topmost 파트에 RGB=마스터 강제, --region 표적 수술. 전역 자동배선은 미검증 |
| capture_pose 포즈가 안 먹음 | 키를 params로 씀 → 조용히 무시(전 포즈=중립) | 키는 parameters — 판정 전 포즈별 렌더가 실제로 다른지 확인 |
| 재배포가 새 프로젝트로 샘 | build_player_webapp가 out을 rmtree → .vercel 링크 소실 | 배포 전 vercel link --project <이름> 재실행 + 배포 후 원격-로컬 바이트 대조 |
| 귀가 얼굴에서 분리 | 깊이 주입이 EAR-FOLLOW 정렬(±22/±12)을 교체(부호 반전) | inject_depth_keyforms EAR_ALIGN 제외 반영됨 |
| 턱 붕괴(큰 얼굴) | rig-px 클립 포화로 입만 과이동 | 증류 클립·가드 crypko px 기준(스케일 불변) 반영됨 |
회수 후 scan_rig_health --depth-map(FAIL 0) + capture_pose 몽타주(neutral/nod/turn/blink/mouth — 포즈 키는 parameters!) open → 주인님 육안 → 로컬 웹캠(run_mini_cubism_webcam_drive --project <rig> --port <p>, 웹캠 페이지=/drive) 검수 후에만 배포. 라이브 증상 디버깅은 [[autorig-live-stability]].
scan_rig_health에 입 위치 새니티(눈→턱 0.45~0.75)와 형제 키폼 소실 게이트(2026-07-11) 포함. 후자는 증류가 얇은 파트(닫힌 입선)의 특정 각도 키만 delta 0으로 남기는 은닉 결함 — 정면 렌더·bbox 전부 정상인데 라이브 회전 시 그 파트만 얼굴에서 분리된다. 증류(distill_tha3_rotation.repair_sibling_dropout)가 자동수복하므로 게이트 FAIL은 수복 경로 밖 회귀 신호다. 취향 수준 미학 드리프트는 기하·VLM 심판 모두 미분리 실측이라 자동 게이트 없음(근거·데이터는 [[chatterbox-avatar-forge]]) — 육안 검수가 유일한 미학 게이트다.
# OG 카드용 마스터: 빌더가 <project>/../generated/master.png를 찾음 — inputs/master.png 복사해둘 것
python3 scripts/build_player_webapp.py --project <rig> --out <webapp> --public-url https://<id>webapp001.vercel.app
cd <webapp> && vercel link --yes --project <id>webapp001 --scope kimjuyoung1127s-projects # 빌드가 .vercel 지움 — 매번
vercel deploy --yes --prod --scope kimjuyoung1127s-projects
# 검증: drive.html/og.png 200 + api/project 원격-로컬 md5 대조 (조용한 오배포 방지)
크레딧 소진 시 umjitak@gmail.com 계정 전환([[modal-account-fallback]] — 볼륨·시크릿 재구축, 전환 전 산출물 회수).
미미(P0·P1)·유키 재현전(tier full)·URO(레포 밖 임의 그림, P2 게이트 1호) — evidence-log CHATTERBOX-RIG-PORT-001·URO 하드닝 배치.
이 스킬 = CLI 런북(modal run --upload). 사용자-대면 웹 트리거(PNG 업로드→자동 수령)는 modal_rig_app.py의 submit(fastapi_endpoint)+run_pipeline 오케스트레이터가 담당 — 같은 generate_inputs/seethrough_decompose/build_rig를 원격에서 순차 호출하며 진행을 Supabase avatar_jobs에 PATCH하고 완성 리그를 avatars/<job>/에 발행한다. 배선·배포·함정은 [[chatterbox-avatar-forge]] (2026-07-09 미미 서버본으로 수령/렌더 반쪽 실증). 티어 정책(ARAP 기본·THA4/crown 옵트인)은 여기가 SSOT — 웹 경로도 그대로 상속.