菜单
AUTORIG rig(자체 2D 모델)를 정적 웹앱으로 빌드해 Vercel에 배포하고 OBS로 방송까지 거는 전체 파이프라인. 트리거 — "버튜버 모델 배포", "모델 남에게 주기", "방송 링크 만들기", "OBS 방송 셋업", "지피쨩/위벨 배포", "rig 웹앱화", "사용자 산출물(PLAYER)". 2026-06-15 005 지피쨩으로 end-to-end 실증 완료.
用 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 배포.
그림 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분.
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".
| name | vtuber-deploy |
| description | AUTORIG rig(자체 2D 모델)를 정적 웹앱으로 빌드해 Vercel에 배포하고 OBS로 방송까지 거는 전체 파이프라인. 트리거 — "버튜버 모델 배포", "모델 남에게 주기", "방송 링크 만들기", "OBS 방송 셋업", "지피쨩/위벨 배포", "rig 웹앱화", "사용자 산출물(PLAYER)". 2026-06-15 005 지피쨩으로 end-to-end 실증 완료. |
자체 rig(rig_v0_project: character.json + parts PNG + mini_rig.json)를 동적 백엔드 0의 정적 웹앱으로 만들어 정적 호스팅(Vercel 등)에 올리고, OBS green screen 방송까지 거는 검증된 경로.
핵심 사실(2026-06-15 PoC 입증):
getUserMedia, parts 경로는 상대경로(/project/)라 포터블.OBS green screen은 부품 틈·분해 고스팅마다 초록이 비쳐 흰 구름·세로 선이 된다(흰색이라 크로마키로 안 빠짐). 베이지 배경판(일반 프리뷰)엔 가려 안 보이다 초록서 드러나니 배포 전 합성 ground truth로 점검(아래 "검증은 반드시 합성"). 보이면 분해 단계(파트 겹침 여백)에서 surgical하게 잡는다.
⚠️ deghost_front_hair.py는 LEGACY (2026-06-22) — 기본 실행 금지. face-bbox 하단 컷 휴리스틱이 긴 앞머리를 통째 삭제한다(008 나비=이마 베이지 노출 · 010 루비=앞머리 45→42 소멸, 두 번 주인님 거부 [[deghost-removes-long-front-hair]]). 2048 See-through는 halo가 적어 대개 불요. 짧은 뱅 + 풀캔버스 halo가 합성 ground truth로 실측된 단발성 경우에만 수동 1회(긴 앞머리 캐릭터 금지):
# (LEGACY · 짧은 뱅 halo 실측 시에만) python3 scripts/deghost_front_hair.py --project experiments/<id>/rig_v0_project
검증은 반드시 합성 ground truth로 (헤드리스 swiftshader 렌더는 **옅은 알파를 거의 안 그려 거짓 "깨끗"**을 준다 — 2026-06-18 3회 헛돔):
# 파트 PNG를 draw_order순 초록[0,177,64] 위에 알파 합성 = 브라우저가 합성하는 것과 동일
# 옅은 구름 = (dev>8)&(dev<120) 픽셀의 x열 합 피크 <50이면 깨끗. 내부 갭 = greenish & cov<0.9.
# 배포 검증도 배포 URL의 /project/parts/*.png를 받아 같은 합성으로.
근본: see-through 분해가 hair_front 등 레이어에 garbage/halo 할당 → 분해 단계 정비가 진짜 해결(후속). 현재는 위 후처리.
외곽 흰 프린지(어두운 배경서 흰 윤곽)는 P4에서 defringe_white_halo.py가 자동 감쇠(DEFRINGE-HALO-001, dedup 다음). 실루엣 파트(hair/headwear/ear/clothes)의 반투명 near-matte 가장자리를 파트 코어 밝기에 상대화해 감쇠(머리색 무관·하드코딩 아님). 밝은 배경 무회귀·검정서 halo 제거 실측(2026-07-04 유키). SHOWCASE는 애초에 베이지라 안 보이지만, OBS 투명 송출 등 어두운 합성 대비.
python3 scripts/build_player_webapp.py \
--project experiments/<id>/rig_v0_project \
--out /tmp/<id>_webapp \
--public-url https://<프로젝트>.vercel.app
# --public-url = OG og:url·og:image 절대 URL(카톡 공유 필수)
# --og-subtitle = OG 태그라인 override(선택; 기본 브랜드 태그라인 "From a single image to a live VTuber.")
# --og-title = 로고 자산 없을 때만 쓰는 텍스트 워드마크 폴백(기본 SNACK)
결과: index.html·vendor/pixi·src/(앱) + project/parts/*.webp + api/project(character+mini_rig+base_url 구운 JSON) + drive.html + og.png.
build_player_webapp.py가 좌측에 SNACK 로고 워드마크(scripts/templates/snack_logo.png — 흰배경 키잉된 투명 PNG, .gitignore 예외로 커밋됨)+브랜드 태그라인("From a single image to a live VTuber.", 2줄 자동 줄바꿈), 우측에 <project>/../generated/master.png(투명여백 크롭→높이맞춤→바닥정렬)를 합성해 og.png(1200×630) 자동 생성. 모델 무관(어떤 캐릭터든 자기 자신). twitter:card=summary_large_image. 로고 자산 없으면 --og-title 텍스트 워드마크(기본 SNACK)로 폴백, 태그라인은 --og-subtitle로 override.source_path도 .webp로 구워짐. bbox 크롭은 캔버스 백엔드(drawImage 2048²)를 깨므로 금지 — WebP가 정답.?obs=1 방송 opt-in.?clean=1 = SHOWCASE: 캐릭터 풀스크린 단색 베이지 + 수치·웹캠 프리뷰 숨김(주인님 "캐릭터만 크게") + 하단 표정 스트립(📷얼굴인식·윙크·방긋·놀람·지토·하트·눈물, EXPR-STRIP-001). ⚠️**transparent=1 금지** — 투명 캔버스가 뒤 다크 컴포짓을 비쳐 "검정 배경+흰 프린지"가 뜬다(2026-07-04 실측). clean만 주면 앱이 베이지(#f4f0e8) 칠함.?panel=1 = 웹캠 패널·중립보정·수치(드라이버 셋업/디버그). ?obs=1 = 초록 호환.if(IS_IOS) return runJeeliz()). 순수 WebGL이라 iOS 구동, 11 morph+3축을 jeelizChannels()가 기존 convert() ch로 흡수(새 어댑터 무). 튜닝=방향 S_YAW=-1·S_ROLL=1·pitch 0.15·입 floor 0.2~0.62+EMA·is_detected() 폴링 FREEZE·합성 시선([[ios-jeeliz-tracker-branch]], SPEC IOS-JEELIZ-TRACKING-001). vendor=scripts/templates/vendor/jeeliz/(Apache-2.0, build가 out/vendor/jeeliz/로 복사). 카메라 거부/실패 시에만 정지 폴백. HTTPS 필수.getUserMedia 크래시 가드(폰 LAN http는 카메라 불가 → 관전 안내).로컬 확인:
cd /tmp/<id>_webapp && python3 -m http.server 8077
# 공유(SHOWCASE 기본): http://127.0.0.1:8077/drive.html · 방송(초록): 위 URL + ?obs=1
# 셋업 UI(보정): http://127.0.0.1:8077/drive.html?panel=1
cd /tmp/<id>_webapp
vercel deploy --yes --prod --scope <팀slug> # 예: kimjuyoung1127s-projects
⚠️ 빌드는 디렉토리를 rmtree — 기존 프로젝트(예: nabiwebapp)에 올리려면 배포 전 링크 필수(안 하면 새 랜덤 프로젝트 생성):
vercel link --yes --project <프로젝트명> --scope <팀slug>
⚠️ Deployment Protection은 재배포마다 다시 켜진다(PLAYER-SHARE 실측) — 매 prod 배포 후 ssoProtection null PATCH를 다시 때려야 401이 안 뜬다. CLI 토큰으로:
TOKEN=$(python3 -c "import json;print(json.load(open('$HOME/Library/Application Support/com.vercel.cli/auth.json'))['token'].strip())")
TEAM=$(curl -s "https://api.vercel.com/v2/teams" -H "Authorization: Bearer $TOKEN" | python3 -c "import sys,json;print(json.load(sys.stdin,strict=False)['teams'][0]['id'])")
curl -s -X PATCH "https://api.vercel.com/v9/projects/<프로젝트명>?teamId=$TEAM" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"ssoProtection": null}'
# 검증: curl -o /dev/null -w "%{http_code}" https://<프로젝트>.vercel.app/api/project → 200
배포 후 공유 URL = https://<프로젝트>.vercel.app/drive.html (SHOWCASE 기본, 방송은 ?obs=1 초록). OG는 /drive.html에만(루트 / 없음). ⚠️Vercel 프로젝트명 정확히: 유키=yukiwebapp001(≠yuki_webapp — 엉뚱한 프로젝트로 배포하면 클린 URL이 옛 파일 서빙). 매 prod 배포 후 ssoProtection=null PATCH 필수(§ssoProtection).
⚠️ 카톡 OG는 캐시 — 미리보기 안 바뀌면 https://developers.kakao.com/tool/clear/og에서 초기화(카카오 로그인) 또는 URL에 ?v=2 부스트.
OBS 설치 위치 주의: OBS를 응용 프로그램 폴더에 설치하고 거기서 실행할 것. DMG(/Volumes/...)에서 바로 실행하면 화면 기록 권한이 안 잡혀 캡처가 까만 화면이 된다.
https://<프로젝트>.vercel.app/drive.html?obs=1 열기 → 카메라 허용 → green 배경 + 얼굴 트래킹 확인| 증상 | 원인 | 해결 |
|---|---|---|
| OBS 브라우저 소스에 모델 안 뜸/트래킹 X | 브라우저 소스는 웹캠 원천 차단 | Chrome에서 트래킹 + OBS는 화면 캡처 |
| 화면 캡처가 까만 화면 | OBS를 DMG에서 실행 | 응용 프로그램에 설치 후 실행 + 화면 기록 권한 |
| 윈도우 목록에 Chrome 없음 | 창이 다른 스페이스/전체화면 | "응용 프로그램 캡처 → Chrome" |
| 공개 URL이 401 | Vercel Deployment Protection | ssoProtection null (2단계) |
| OBS 캡처에서 모델 정지 | Chrome 창이 가려져 백그라운드 throttle | Chrome 창 보이게 두기 / chrome://flags "window occlusion" Disabled |
| 모델 위 노란 박스 | 에디터 오버레이(#overlay-canvas) | ?obs=1이 자동 숨김 (없으면 URL에 obs=1) |
| 초록 위 좌우 흰 구름 기둥 | 앞머리 분해 halo | 2048 분해는 대개 없음. 있으면 분해 단계서 정비(⚠️deghost_front_hair.py는 LEGACY — 긴 앞머리 통째 삭제, §0) |
| 목/셔츠 초록 세로선 | 목 파트가 턱보다 좁아 측면 노치 | (목 grow 도구 폐기 — 분해 단계 파트 겹침 여백으로 해결) |
| 뒤에 캐릭터 겹침 | 바디 백킹을 캐릭터색으로 실루엣보다 크게 깖 | 백킹 끄기(--backing 기본 OFF) — 후광 부작용 |
| "고쳤는데 그대로 보임" | ① CDN/브라우저 캐시 ② swiftshader 렌더가 옅은 알파 누락 | ① 고유 배포 URL(매 배포 새 hostname=캐시無)로 확인 ② 합성 ground truth로 검증(§0) |
| 재배포했는데 다시 401 | ssoProtection이 재배포마다 재활성 | 매 배포 후 PATCH 재실행(2단계) |
| 재배포했는데 clean URL이 옛 버전(고유 배포 URL엔 새 코드·alias만 옛것·age 큰 cache HIT) | <프로젝트>.vercel.app이 수동 alias라 --prod가 안 옮김(promote는 "이미 production" 409) | vercel alias set <새-배포-URL> <프로젝트>.vercel.app --scope <팀> 후 라이브 grep으로 새 마커 확인(010 루비 실측 2026-06-28) |
| 캐릭터 작음(옛 패널) | 옛 패널 레이아웃 | 기본이 SHOWCASE(데스크톱·모바일 공통 풀스크린·수치/셀프뷰 숨김·표정 스트립, SHOWCASE-DEFAULT-001) |
| 검은 배경에 흰 윤곽/프린지 | ① SHOWCASE에 transparent=1 줘 투명 캔버스가 다크 컴포짓 노출 ② See-through 실루엣 프린지 | ① clean만(transparent 금지)=앱이 베이지 단색 칠함 ② defringe_white_halo.py(P4 자동, 머리색 상대화) |
| 아이폰서 얼굴 안 움직임 | (구) MediaPipe iOS 미지원 | 이제 Jeeliz Weboji로 iOS 트래킹 작동(2026-07-04). 안 움직이면 카메라 권한/HTTPS 확인. 얼굴 없을 때 스윙=is_detected() 폴링 0.6s FREEZE로 정지, 근접 입 깜빡=floor 0.2~0.62+EMA |
| 폰서 "getUserMedia undefined" 크래시 | http LAN=비보안 origin → navigator.mediaDevices undefined | 가드로 크래시 대신 안내(관전 유지). 실제 웹캠은 배포 https(안드로이드) 또는 PC |
| 로딩 느림(preview loading) | parts 49장 2048² 풀캔버스 PNG 7.2MB | WebP q90 자동 변환(빌드, 87%↓) — bbox 크롭 금지(캔버스 백엔드 깨짐) |
| 카톡서 움직임 정지 | 인앱브라우저 getUserMedia 차단 | 인앱 감지 배너 "기본 브라우저로 열기"(자동) — 크롬/사파리서 정상 |
| 방향 반대(좌↔우) | 프리뷰 셀카 거울 vs 원본 랜드마크 구동 | convert() 수평·롤축 M=-1 반전(MIRROR-OFF-001) |
| 카톡 OG 옛 미리보기 | 카카오 OG 캐시 | developers.kakao.com/tool/clear/og 초기화 / ?v=2 |
docs/ref/vision/PRODUCTION-VISION.md.