From a584cb505d2ce095d69a0502c81ec14f8596663e Mon Sep 17 00:00:00 2001 From: Wickedness Date: Fri, 12 Jun 2026 13:40:58 +0900 Subject: [PATCH] Add facial diversity gate for character assets --- AGENTS.md | 8 ++ README.md | 4 + assets/characters/README.md | 18 +++- assets/characters/jung_naeun_v1.png | Bin 0 -> 2039172 bytes assets/characters/kang_mirae_v2.png | Bin 0 -> 1967240 bytes assets/characters/oh_sera_v1.png | Bin 0 -> 2276763 bytes assets/characters/park_minseo_v1.png | Bin 0 -> 2243464 bytes data/character_assets.json | 114 +++++++++++++++++++++ docs/art/character_image_direction.md | 20 +++- docs/art/facial_identity_matrix.md | 48 +++++++++ docs/art/semirealistic_character_briefs.md | 1 + scripts/validate_assets.py | 109 ++++++++++++++++++++ 12 files changed, 316 insertions(+), 6 deletions(-) create mode 100644 assets/characters/jung_naeun_v1.png create mode 100644 assets/characters/kang_mirae_v2.png create mode 100644 assets/characters/oh_sera_v1.png create mode 100644 assets/characters/park_minseo_v1.png create mode 100644 data/character_assets.json create mode 100644 docs/art/facial_identity_matrix.md create mode 100644 scripts/validate_assets.py diff --git a/AGENTS.md b/AGENTS.md index c9c81f6..49a1180 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,6 +16,12 @@ python3 scripts/validate_content.py ``` +- For character image asset changes, run: + +```bash +python3 scripts/validate_assets.py +``` + ## Creative Direction - This is a romance dating game for adult players. @@ -24,4 +30,6 @@ python3 scripts/validate_content.py - Prefer semi-realistic, high-quality, cinematic character art when creating base images or visual references. - The target look is closer to polished Korean dating-sim key art than pure photography: realistic lighting and fabric, but idealized illustrated faces, refined skin, and expressive character silhouettes. - Even shy, pure-hearted, or reserved characters should retain visible adult charm through styling, silhouette, gaze, posture, and lighting. +- Preserve distinct facial identities across the cast. Do not accept images that look like the same model in different clothes. +- Use `docs/art/facial_identity_matrix.md` when writing prompts or approving character images. - Avoid making characters look underage, childlike, or styled as school students. diff --git a/README.md b/README.md index 48f6478..8a2e970 100644 --- a/README.md +++ b/README.md @@ -9,8 +9,11 @@ - `data/characters.json`: 22명의 성인 여성 캐릭터와 각자의 루트 구조 - `data/locations.json`: 맵 클릭 지점, 주요 시간대, 우연한 만남 태그 - `data/progression.json`: 만남에서 연인 전환까지의 공통 진행 규칙 +- `data/character_assets.json`: 캐릭터 기본 이미지의 통과 상태와 파일 경로 - `docs/game_structure.md`: 게임 루프와 시스템 설계 메모 +- `docs/art/facial_identity_matrix.md`: 캐릭터별 얼굴형, 눈매, 헤어, 표정 차별화 기준 - `scripts/validate_content.py`: 캐릭터 나이와 장소 참조 무결성 검증 +- `scripts/validate_assets.py`: 캐릭터 이미지 매니페스트와 PNG 해상도 검증 ## 콘텐츠 원칙 @@ -22,4 +25,5 @@ ```bash python3 scripts/validate_content.py +python3 scripts/validate_assets.py ``` diff --git a/assets/characters/README.md b/assets/characters/README.md index 65f16d6..9188fe9 100644 --- a/assets/characters/README.md +++ b/assets/characters/README.md @@ -8,9 +8,13 @@ Base standing images should feel like high-end promotional portraits for a matur ## Current Files -- `han_seoyun_v1.png`: current preferred semi-realistic style target. -- `yu_harin_v1.png`: accepted semi-realistic base image. -- `kang_mirae_v1.png`: accepted semi-realistic base image. +- `han_seoyun_v1.png`: semi-realistic style/composition candidate; needs facial diversity revision. +- `yu_harin_v1.png`: semi-realistic base candidate; needs facial diversity revision. +- `kang_mirae_v2.png`: accepted semi-realistic base image with revised facial identity. +- `kang_mirae_v1.png`: earlier semi-realistic base candidate; same-face risk remains. +- `jung_naeun_v1.png`: semi-realistic base candidate; needs facial diversity revision. +- `oh_sera_v1.png`: semi-realistic base candidate; needs facial diversity revision. +- `park_minseo_v1.png`: semi-realistic base candidate; needs facial diversity revision. - `style_references/semirealistic_main_reference.png`: user-approved reference for the target look. - `style_tests/han_seoyun_photoreal_test.png`: pure photoreal comparison candidate. - `style_tests/kang_mirae_photoreal_test.png`: pure photoreal comparison candidate. @@ -23,3 +27,11 @@ Base standing images should feel like high-end promotional portraits for a matur - Use `_v.png` for main candidates. - Use `style_tests/_