Initial Dansori character workspace

2026-07-04 10:34:46 +09:00
commit 5a419816ff
2480 changed files with 38692 additions and 0 deletions
@@ -0,0 +1,59 @@
+# 결정 기준
+
+## D1. 최종 구현 방식
+
+WPF 앱에 들어갈 캐릭터는 Live2D Cubism 모델로 제작한다.
+
+산출물:
+
+- `.moc3`
+- `.model3.json`
+- texture atlas PNG
+- `.motion3.json`
+- `.exp3.json`
+- `.physics3.json`
+
+## D2. AI 제작 범위
+
+AI는 다음을 담당한다.
+
+- 캐릭터 정체성 유지.
+- Live2D PSD용 분리 레이어 생성.
+- 움직임으로 드러나는 부위 보강.
+- 표정, 입, 눈, 머리카락, 손 파츠 생성.
+- 레이어 파일명과 투명 알파 검수.
+
+## D3. PSD 구성
+
+- `sori_live2d_material_separation.psd`: 작업용 PSD.
+- `sori_live2d_import.psd`: Cubism import용 PSD.
+- PNG 레이어 번들은 `03_Assets/Live2D/layer_manifest.json`의 `file` 값을 따른다.
+
+## D4. Cubism 파라미터
+
+기본 파라미터는 `04_Rig/live2d_parameters.json`을 기준으로 한다. 표준 이름을 유지해 SDK, 표정, 모션, 외부 컨트롤러 연동을 단순하게 만든다.
+
+## D5. WPF 통합 방식
+
+WPF 앱은 WebView2와 Cubism SDK for Web을 사용해 Live2D 런타임을 호스팅한다.
+
+## D6. 반응 시스템
+
+앱 이벤트는 `motion`, `expression`, `mouth`, `caption`, `sfx` 조합으로 실행한다. 매핑은 `06_Reactions/reactions.json`과 `06_Reactions/clips/*.json`을 따른다.
+
+## D7. 이미지와 색공간
+
+원화 레이어는 투명 알파를 유지하고, Cubism import용 PSD는 RGB, 8bit/channel, sRGB 기준으로 관리한다.
+
+## D8. 레이어명 안정성
+
+PSD 레이어명은 `layer_manifest.json`의 `id`를 따른다. Cubism 작업 중 레이어명, 그룹명, 파일명을 임의로 바꾸지 않는다.
+
+## 열린 항목
+
+| ID | 내용 | 기준 |
+|---|---|---|
+| O1 | 런타임 방식 | WebView2 우선 |
+| O2 | 대사 출력 | 말풍선과 TTS 모두 고려 |
+| O3 | 원화 해상도 | 1600x2800 권장 |
+| O4 | 입 모양 제어 | 볼륨 기반부터 시작, 음소 기반 확장 가능 |
@@ -0,0 +1,40 @@
+# 목적과 방향
+
+## 최종 목적
+
+이소리를 **WPF 앱에 탑재되는 Live2D 인터랙티브 마스코트**로 제작한다. 앱의 상태와 사용자 행동에 맞춰 캐릭터가 자연스럽게 움직이고, 표정과 입 모양, 제스처, 말풍선 또는 TTS가 함께 반응해야 한다.
+
+## 대표 사용 시나리오
+
+| 상황 | Live2D 반응 |
+|---|---|
+| 오류/금지된 동작 | `motion_no` + `exp_negative` + 고개 젓기 + "안돼요" |
+| 성공/완료/칭찬 | `motion_heart` + `exp_love` + 바운스 + "잘됐어요" |
+| 대기/유휴 | `motion_idle_dance` 루프 + 자동 눈깜빡임 + 호흡 + 머리카락 물리 |
+| 인사 | `motion_greet` + `exp_smile` + 손 흔들기 |
+| 안내/설명 | `motion_present` + `exp_neutral` + 말하기 |
+| 생각중/로딩 | `motion_thinking` + `exp_thinking` + 갸웃 |
+
+## 제작 원칙
+
+1. **Live2D Cubism 모델을 최종 산출물로 한다**  
+   WPF 앱에는 Cubism export 산출물을 탑재한다.
+
+2. **AI는 원화 분리와 보강에 집중한다**  
+   AI는 PSD 레이어 원화, 누락 부위 보강, 입/눈/머리카락/손 파츠 생성을 담당한다.
+
+3. **PSD 레이어 품질을 최우선으로 한다**  
+   눈, 눈썹, 입, 얼굴 윤곽, 앞머리, 옆머리, 뒷머리, 목, 어깨, 팔, 손가락, 의상 겹침 부위를 Live2D 제어에 맞게 분리한다.
+
+4. **Cubism 표준 파라미터를 사용한다**  
+   `ParamAngleX/Y/Z`, `ParamEyeLOpen`, `ParamMouthOpenY`, `ParamBodyAngleX/Y/Z`, `ParamBreath`, `ParamHairFront/Side/Back`을 우선 사용한다.
+
+5. **WPF 앱 이벤트는 상황키로 연결한다**  
+   앱은 `success`, `error`, `idle` 같은 상황키만 보낸다. Live2D 런타임은 motion, expression, caption, mouth driver를 선택한다.
+
+## 제작 범위
+
+- Live2D PSD 레이어 원화.
+- Cubism 리깅과 모션.
+- WPF WebView2 런타임 연동.
+- 상황별 반응 데이터.