تشغيل أي مهارة في Manus بنقرة واحدة

avatar-deploy

النجوم٠

التفرعات٠

آخر تحديث١٣ يوليو ٢٠٢٦ في ٠٠:٢٩

Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시.

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

تشغيل في Manus

المصدر

Jason-hub-star

Jason-hub-star/chatterbox

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

تشغيل في Manus

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

مطوّرو البرمجياتمهن الحاسوب والرياضيات·SOC 15-1252

مستكشف الملفات

2 ملفات

SKILL.md

readonly

name	avatar-deploy
description	Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시.
user_invocable	true
tags	["avatar","deploy","vtube","verification","storage"]
trigger	Vtube rig 를 ChatterBox 에 새 아바타로 배포·검증할 때
version	1

avatar-deploy

Vtube mini_cubism rig 를 ChatterBox 에서 선택 가능한 아바타로 꼽는다(배포 → 매니페스트 등록 → 실렌더 검증). 기계적 배포는 scripts/deploy-avatar.mjs 가 하고, 이 스킬은 그 위에 ①발굴(어느 rig=어느 캐릭터, 배포할 만한가) ②렌더 검증(성역) 을 얹는다. 검증 없이 "배포됨"으로 치지 않는다 — 업로드는 성공해도 rig 데이터가 깨져 안 그려질 수 있다.

Use When

Vtube 에서 만든 아바타(캐릭터)를 ChatterBox 방/설정에서 쓰게 하고 싶을 때
"아바타 배포/추가/넣기", "새 캐릭터 슬롯", "Vtube 아바타 온보딩" 요청 시
배포된 아바타가 실제로 렌더되는지 실측이 필요할 때

환경 함정 (매번 여기서 시간 날림 — 반드시)

_mini_rig 는 렌더 필수 — 배포 project.json 에 mini_rig.json 을 _mini_rig 로 인라인 안 하면 loader.ts:normalizeRig 가 아리아형 fallback bbox 로 그려 오작동(rigMath.ts 경고). deploy-avatar.mjs 가 병합하지만, mini_rig.json 이 없는 rig 는 배포 금지.
character.json ≠ 배포 형식 — 소스 rig_v0_project/character.json(project_kind mini_cubism_v0)에 _mini_rig 병합해야 배포용 project.json 이 된다(단순 복사 아님). parts source_path 는 상대(parts/x.png), 로더가 base URL 자동 파생.
헤드리스 Chrome 은 외부 DNS 없음 — 프로덕션 *.supabase.co 를 직접 못 fetch. 렌더 검증은 배포한 것과 동일 병합 번들을 앱 same-origin public/<id>-test/ 로 스테이징 → ?project=/<id>-test/project.json(로더 origin 화이트리스트: same-origin 허용). 검증 후 public/<id>-test/ 삭제.
vite dev 는 없는 파일에도 200(SPA fallback) — /<id>-test/project.json 이 200 이어도 index.html 일 수 있다. content-type 이 application/json 인지, 앞부분이 {"schema_version"... 인지 확인.
렌더러/페이지는 범용(이름만 rig) — RigAvatar(src/lib/pixi/rig)·AvatarInspectorPage(/avatar-inspect)는 아무 rig 나 렌더. DEV 는 window.__rigAvatar 노출. "aria" 는 캐릭터명이지 코드 전용 아님.
playwright-core 는 --no-save 임시 설치, 검증 후 npm remove. 시스템 Chrome executablePath: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome, WebGL args --use-gl=angle --use-angle=swiftshader --enable-unsafe-swiftshader.
키·값 미출력 — .env(VITE_SUPABASE_URL·SUPABASE_SERVICE_ROLE_KEY)에서 값 echo 없이 사용. deploy-avatar.mjs 가 .env 자동 로드.
발굴 시 백업 폴더 제외 — rig_v0_project.bak_*·_BROKEN 는 배포 금지. 캐릭터명은 Vtube/characters/*.yaml·config/pipeline_profile.*.yaml("(배포본)" 마커)로 매핑. character.json mtime 으로 최신 판단.
입 상태 QA 게이트(ISS-04, 2026-07-13 poon995 실측 이관) — deploy-avatar.mjs·publish-avatar-job.mjs 가 발행 전 scripts/qa-mouth-lips.mjs(립 안료 연속성: mouth_state_* 립안료/closed < 0.35 → FAIL)를 강제한다. AUTORIG 이 열린 입 상태를 입술 안료 없이 생성하면 발화 밴드(MouthOpenY 0.245~0.47)에서만 입술이 사라져 보여 정지 초상 검수로는 못 잡는다. FAIL 시 정공=자산 재생성, 임시=closed_master 크로스페이드(0.30→0.60, poon995 선례). 육안 판정 도구는 scripts/render-mouth-matrix.mjs(상태×각도 몽타주). 비상 우회 QA_MOUTH_SKIP=1.

Steps

발굴(필요 시): 넓은 Vtube 탐색은 Explore(haiku)로 — 배포가능 rig(rig_v0_project/{character.json,mini_rig.json,parts/}, render_mode mesh) 목록 + 캐릭터명 + 이미 ChatterBox 에 있는지. 어느 걸 배포할지는 사용자 로스터 결정(프로덕션 쓰기라 확인).
배포: node scripts/deploy-avatar.mjs <rigDir> <id> <name> (id=소문자·숫자·하이픈). 병합·parts 검증·업로드·매니페스트 갱신·원격 완전성(전 parts 200)까지 자동. 코드 수정 0.
렌더 검증(성역): templates/render-verify.mjs 참고 — 병합 번들 public/<id>-test/ 스테이징 → vite dev → 헤드리스 /avatar-inspect?project=/<id>-test/project.json → __rigAvatar 생성·setParams 무예외·스크린샷 육안 확인·콘솔에러 0.
정리: rm -rf public/<id>-test; pkill -f vite; npm remove --no-save playwright-core.
확인: avatars/manifest.json 에 항목 추가됨 → 설정에서 선택 가능. evidence-review 로 결과 기록.

Verify

배포 스크립트 "원격 검증 N/N 200" + 렌더 __rigAvatar 생성 + 스크린샷을 실제로 열어 캐릭터가 온전히 그려졌는지 육안 확인(parts 조립·색·표정). 업로드 성공만으로 "됨" 처리 금지.
package.json 에 playwright 잔존 없음.
성공 사례: akane(47 parts·6/6)·ruby(45·6/6)·yuki(44·6/6) 배포+실렌더.

Failure / Fallback

렌더 캔버스 빈/깨짐 → _mini_rig 미병합(함정 1) 또는 parts 누락. 스크립트의 parts 검증·원격 200 재확인.
로더 project.json JSON 파싱 실패 → vite SPA fallback(함정 4). 스테이징 실파일 확인.
ERR_NAME_NOT_RESOLVED → 프로덕션 URL 직접 로드(함정 3). same-origin 스테이징으로.
rig 에 mini_rig.json 없음 → 배포 금지(렌더 부정확). Vtube 파이프라인에서 재생성.

참고

레지스트리: src/lib/avatars.ts(fetchAvatarPresets = Storage avatars/manifest.json 동적 로드, 재빌드 없이 반영)·isValidAvatarUrl(우리 버킷 project.json 만 저장 허용). 렌더: src/lib/pixi/rig(RigAvatar).
Storage 레이아웃: avatars/<id>/project.json + avatars/<id>/parts/*. 캐릭터 "aria/akane/ruby/yuki" 는 실제 캐릭터.
ponytail: 유저 업로드(MOD-02) 붙으면 매니페스트→DB avatars 테이블, 유저별 avatars/<userId>/.

المزيد من هذا المستودع

نفس المستودع

hub-map-pipeline

Jason-hub-star/chatterbox

ChatterBox 허브 맵 파이프라인 — 광장/구역 블록·내부 관(館) 원화 생성→핫스팟·앵커 캘리브레이션→manifest 배선→유도 3단 인터랙션→E2E. 새 맵(밤 variant·신규 구역 블록·새 내부 관·다른 씬 허브)을 만들 때 사용. 화풍 고정 생성은 scene-pipeline 참조.

2026-07-130

scene-pipeline

Jason-hub-star/chatterbox

ChatterBox 씬 에셋 파이프라인 — 화풍 고정 이미지 생성(gpt-image edits+레퍼런스)→WebP→매니페스트 등재, 입장 영상(Seedance i2v→Topaz 업스케일→WebM). 새 씬/시간대 variant/씬 영상을 만들 때 사용.

2026-07-130

avatar-deploy

Jason-hub-star/chatterbox

2026-07-130

text-to-audio

Jason-hub-star/chatterbox

ChatterBox 음원 자산 파이프라인 — BGM/앰비언트/SFX 를 프롬프트로 생성(fal Stable Audio 2.5 · CassetteAI SFX) → 주인님 청취 게이트 → loudnorm+AAC → public/sounds/ 안착. "BGM 만들어", "음원 생성", "효과음 뽑아", "앰비언트", "사운드 추가" 요청 시. 2026-07-13 G6 BGM 3곡 세션에서 밟은 함정을 고정.

2026-07-120

bepo

Jason-hub-star/chatterbox

구현 완료 슬라이스를 프로덕션에 올리고 라이브로 실증한 뒤 문서·커밋까지 닫는 일괄 마감 절차 — db push(서울 pooler)·함수 deploy(재시도·실측)·CF Pages·프로드 통합/2탭 E2E·백로그 §0/GAP/drift 문서 마감. "배포하고 라이브테스트", "라이브로 올려", "페이즈 마감", "배포 몰아치기" 요청 시.

2026-07-120

cf-pages-deploy-verify

Jason-hub-star/chatterbox

ChatterBox 프론트(Vite SPA)를 Cloudflare Pages 에 배포하고 실렌더로 검증하는 하네스 — 2계정 non-interactive 선택·프로젝트 선생성·account_id env 전용·번들 비밀키 감사·SPA폴백·헤드리스 React 마운트 확인 등 매번 재발견하던 CF 배포 함정을 고정. "CF 배포/프론트 배포/pages 배포/배포판 검증/재배포/ㄱ 배포" 요청 시.

2026-07-120

name	avatar-deploy
description	Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시.
user_invocable	true
tags	["avatar","deploy","vtube","verification","storage"]
trigger	Vtube rig 를 ChatterBox 에 새 아바타로 배포·검증할 때
version	1

avatar-deploy

Use When

Vtube 에서 만든 아바타(캐릭터)를 ChatterBox 방/설정에서 쓰게 하고 싶을 때
"아바타 배포/추가/넣기", "새 캐릭터 슬롯", "Vtube 아바타 온보딩" 요청 시
배포된 아바타가 실제로 렌더되는지 실측이 필요할 때

환경 함정 (매번 여기서 시간 날림 — 반드시)

_mini_rig 는 렌더 필수 — 배포 project.json 에 mini_rig.json 을 _mini_rig 로 인라인 안 하면 loader.ts:normalizeRig 가 아리아형 fallback bbox 로 그려 오작동(rigMath.ts 경고). deploy-avatar.mjs 가 병합하지만, mini_rig.json 이 없는 rig 는 배포 금지.
character.json ≠ 배포 형식 — 소스 rig_v0_project/character.json(project_kind mini_cubism_v0)에 _mini_rig 병합해야 배포용 project.json 이 된다(단순 복사 아님). parts source_path 는 상대(parts/x.png), 로더가 base URL 자동 파생.
헤드리스 Chrome 은 외부 DNS 없음 — 프로덕션 *.supabase.co 를 직접 못 fetch. 렌더 검증은 배포한 것과 동일 병합 번들을 앱 same-origin public/<id>-test/ 로 스테이징 → ?project=/<id>-test/project.json(로더 origin 화이트리스트: same-origin 허용). 검증 후 public/<id>-test/ 삭제.
vite dev 는 없는 파일에도 200(SPA fallback) — /<id>-test/project.json 이 200 이어도 index.html 일 수 있다. content-type 이 application/json 인지, 앞부분이 {"schema_version"... 인지 확인.
렌더러/페이지는 범용(이름만 rig) — RigAvatar(src/lib/pixi/rig)·AvatarInspectorPage(/avatar-inspect)는 아무 rig 나 렌더. DEV 는 window.__rigAvatar 노출. "aria" 는 캐릭터명이지 코드 전용 아님.
playwright-core 는 --no-save 임시 설치, 검증 후 npm remove. 시스템 Chrome executablePath: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome, WebGL args --use-gl=angle --use-angle=swiftshader --enable-unsafe-swiftshader.
키·값 미출력 — .env(VITE_SUPABASE_URL·SUPABASE_SERVICE_ROLE_KEY)에서 값 echo 없이 사용. deploy-avatar.mjs 가 .env 자동 로드.
발굴 시 백업 폴더 제외 — rig_v0_project.bak_*·_BROKEN 는 배포 금지. 캐릭터명은 Vtube/characters/*.yaml·config/pipeline_profile.*.yaml("(배포본)" 마커)로 매핑. character.json mtime 으로 최신 판단.
입 상태 QA 게이트(ISS-04, 2026-07-13 poon995 실측 이관) — deploy-avatar.mjs·publish-avatar-job.mjs 가 발행 전 scripts/qa-mouth-lips.mjs(립 안료 연속성: mouth_state_* 립안료/closed < 0.35 → FAIL)를 강제한다. AUTORIG 이 열린 입 상태를 입술 안료 없이 생성하면 발화 밴드(MouthOpenY 0.245~0.47)에서만 입술이 사라져 보여 정지 초상 검수로는 못 잡는다. FAIL 시 정공=자산 재생성, 임시=closed_master 크로스페이드(0.30→0.60, poon995 선례). 육안 판정 도구는 scripts/render-mouth-matrix.mjs(상태×각도 몽타주). 비상 우회 QA_MOUTH_SKIP=1.

Steps

발굴(필요 시): 넓은 Vtube 탐색은 Explore(haiku)로 — 배포가능 rig(rig_v0_project/{character.json,mini_rig.json,parts/}, render_mode mesh) 목록 + 캐릭터명 + 이미 ChatterBox 에 있는지. 어느 걸 배포할지는 사용자 로스터 결정(프로덕션 쓰기라 확인).
배포: node scripts/deploy-avatar.mjs <rigDir> <id> <name> (id=소문자·숫자·하이픈). 병합·parts 검증·업로드·매니페스트 갱신·원격 완전성(전 parts 200)까지 자동. 코드 수정 0.
렌더 검증(성역): templates/render-verify.mjs 참고 — 병합 번들 public/<id>-test/ 스테이징 → vite dev → 헤드리스 /avatar-inspect?project=/<id>-test/project.json → __rigAvatar 생성·setParams 무예외·스크린샷 육안 확인·콘솔에러 0.
정리: rm -rf public/<id>-test; pkill -f vite; npm remove --no-save playwright-core.
확인: avatars/manifest.json 에 항목 추가됨 → 설정에서 선택 가능. evidence-review 로 결과 기록.

Verify

배포 스크립트 "원격 검증 N/N 200" + 렌더 __rigAvatar 생성 + 스크린샷을 실제로 열어 캐릭터가 온전히 그려졌는지 육안 확인(parts 조립·색·표정). 업로드 성공만으로 "됨" 처리 금지.
package.json 에 playwright 잔존 없음.
성공 사례: akane(47 parts·6/6)·ruby(45·6/6)·yuki(44·6/6) 배포+실렌더.

Failure / Fallback

렌더 캔버스 빈/깨짐 → _mini_rig 미병합(함정 1) 또는 parts 누락. 스크립트의 parts 검증·원격 200 재확인.
로더 project.json JSON 파싱 실패 → vite SPA fallback(함정 4). 스테이징 실파일 확인.
ERR_NAME_NOT_RESOLVED → 프로덕션 URL 직접 로드(함정 3). same-origin 스테이징으로.
rig 에 mini_rig.json 없음 → 배포 금지(렌더 부정확). Vtube 파이프라인에서 재생성.

참고

레지스트리: src/lib/avatars.ts(fetchAvatarPresets = Storage avatars/manifest.json 동적 로드, 재빌드 없이 반영)·isValidAvatarUrl(우리 버킷 project.json 만 저장 허용). 렌더: src/lib/pixi/rig(RigAvatar).
Storage 레이아웃: avatars/<id>/project.json + avatars/<id>/parts/*. 캐릭터 "aria/akane/ruby/yuki" 는 실제 캐릭터.
ponytail: 유저 업로드(MOD-02) 붙으면 매니페스트→DB avatars 테이블, 유저별 avatars/<userId>/.