nai-aclab 1.1.0 → 1.2.0

package/README.md

@@ -4,6 +4,8 @@ NovelAI에서 여러 작가 태그 조합을 시험해보고, 마음에 드는
 
 예를 들어 같은 캐릭터 프롬프트를 두고 작가 태그의 가중치만 바꿔 여러 장을 만든 뒤, 마음에 드는 이미지의 가중치를 다시 불러와 고정해서 더 테스트할 수 있습니다.
 
+이미지에 `화풍 만족도`와 `신체 안정성` 평점을 남기면 앱이 메인 화풍 작가와 안정화 작가의 적절한 가중치를 따로 학습합니다. 자주 함께 쓰는 베이스와 캐릭터 프리셋은 하나의 세트로 묶어 한 번에 선택할 수 있습니다.
+
 ## 이런 분에게 좋습니다
 
 - NovelAI에서 그림체 조합을 여러 번 실험하는 분
@@ -61,12 +63,12 @@ nai-aclab
 
 1. `API 설정` 메뉴로 이동합니다.
 2. NovelAI API 토큰을 입력합니다.
-3. `목업 모드 사용`을 끕니다.
+3. `API 없이 체험하기`를 끕니다.
 4. `설정 저장`을 누릅니다.
 
-API 토큰을 아직 넣고 싶지 않다면 `목업 모드 사용`을 켜둔 채로 UI만 먼저 테스트할 수 있습니다. 목업 모드에서는 실제 NovelAI API를 쓰지 않고 테스트용 이미지를 만듭니다.
+API 토큰을 아직 넣고 싶지 않다면 `API 없이 체험하기`를 켜둔 채로 UI만 먼저 테스트할 수 있습니다. 체험 모드에서는 실제 NovelAI API를 쓰지 않고 테스트용 이미지를 만듭니다.
 
-대부분의 사용자는 `Endpoint`, `Model`, `Sampler`, `Noise Schedule` 같은 값은 기본값 그대로 두면 됩니다.
+대부분의 사용자는 `Endpoint`, `Model`, `Sampler`, `Noise Schedule` 같은 값은 기본값 그대로 두면 됩니다. 처음 설치하면 이미지 모델은 `NAI Diffusion V5 Full`로 설정됩니다.
 
 ![API 설정 메뉴](docs/screenshots/07-api-settings.png)
 
@@ -91,10 +93,41 @@ artist:sample_a
 
 앱은 여기서 `artist:*` 부분만 자동으로 찾아냅니다.
 
-`선택 태그 수`를 비워두면 그 카테고리에 적은 작가 태그를 모두 사용합니다. 일부만 랜덤으로 뽑고 싶을 때만 숫자를 입력하면 됩니다.
+`한 번에 사용할 태그 수`를 비워두면 그 카테고리에 적은 작가 태그를 모두 사용합니다. 일부만 랜덤으로 뽑고 싶을 때만 숫자를 입력하면 됩니다.
+
+아래의 `인식된 artist 태그`에 원하는 태그가 제대로 표시되는지만 확인하면 됩니다. 저장은 입력과 동시에 자동으로 처리됩니다.
 
 ![작가 태그 메뉴](docs/screenshots/02-artists.png)
 
+### 평점으로 취향 학습시키기
+
+이미지를 여러 장 만든 뒤 생성 화면의 실시간 미리보기에서 두 가지 1~5점 평점을 남길 수 있습니다. 히스토리와 가중치 비교에서 이미지를 클릭해 평가해도 됩니다.
+
+| 평점 항목 | 평가 기준 | 다음 생성에서의 변화 |
+| --- | --- | --- |
+| 화풍 만족도 | 완성된 그림체가 내 취향에 맞는지 | 메인 화풍 작가의 포함 확률과 가중치 방향을 조정합니다. |
+| 신체 안정성 | 인체·손발이 자연스럽고 안정화 작가가 메인 화풍을 과하게 덮지 않는지 | 안정화 작가마다 좋은 결과를 낸 가중치를 더 자주 선택합니다. |
+
+4~5점은 좋은 결과, 3점은 중립, 1~2점은 좋지 않은 결과로 해석합니다. 평가가 한두 장뿐일 때는 우연한 결과에 지나치게 끌려가지 않도록 점수를 3점에 가깝게 완화합니다.
+
+알아둘 점:
+
+- `메인 화풍` 역할의 카테고리에는 화풍 만족도만 반영됩니다.
+- `신체 안정화` 역할의 카테고리에는 신체 안정성만 반영됩니다.
+- 안정화 학습은 작가 이름만 보지 않고 `작가 + 실제 가중치` 조합별로 점수를 모읍니다.
+- 아직 평가가 적은 가중치도 가끔 다시 사용하여 더 좋은 값을 놓치지 않도록 합니다.
+- `한 번에 사용할 태그 수`를 비워두면 모든 작가를 사용하므로 포함 확률보다 가중치 선택에 학습 결과가 더 많이 반영됩니다.
+- 타율 테스트는 이미 불러온 작가 조합을 고정해 여러 씬에서 검증하는 기능이므로 평점을 받지 않으며 학습에도 포함되지 않습니다.
+- 학습 내용을 지우고 처음부터 다시 시작하려면 `취향 학습` 메뉴에서 `평점 초기화`를 누르세요.
+
+`취향 학습` 메뉴에서는 메인 화풍 선호 순위와 안정화 작가별 추천 가중치를 따로 확인할 수 있습니다. 작가별 `포함 ×1.20`은 중립 작가보다 선택 가중치가 약 20% 높다는 뜻입니다. 안정화 작가에는 지금까지 시험한 가중치 수, 추천 가중치와 보정 점수가 표시됩니다.
+
+기존 버전에서 남긴 단일 평점은 업데이트 후 `화풍 만족도`로 자동 이전됩니다. 신체 안정성은 업데이트 이후 생성한 결과부터 별도로 평가하면 됩니다.
+
+NAI V5에서는 작가 태그 순서도 결과에 영향을 줄 수 있어, 랜덤 모드에서는 높은 가중치의 태그를 프롬프트 앞과 뒤에 번갈아 배치합니다. 가장 높은 태그가 앞에 올지 뒤에 올지는 생성할 때마다 무작위로 정합니다. 이미지에서 `가중치 불러오기`를 누르면 가중치뿐 아니라 그 이미지의 작가 태그 순서도 함께 고정됩니다.
+
+![취향 학습 메뉴](docs/screenshots/08-learning.png)
+
 ### 2. 프리셋 만들기
 
 `프리셋` 메뉴에서 자주 쓸 프롬프트를 저장합니다.
@@ -103,7 +136,8 @@ artist:sample_a
 - 퀄리티 프롬프트: 품질 관련 태그
 - 캐릭터 프롬프트: 캐릭터별 외형과 행동
 - 네거티브 프롬프트: 피하고 싶은 요소
-- UC 프롬프트: NovelAI의 legacy UC 입력값
+
+공통 네거티브 프롬프트는 NovelAI의 UC에도 같은 내용으로 자동 전송됩니다.
 
 최종 프롬프트는 아래 순서로 조립됩니다.
 
@@ -113,13 +147,15 @@ artist:sample_a
 
 NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지 않고 `|`로 나눕니다.
 
+자주 함께 쓰는 `베이스 + 퀄리티`와 `캐릭터` 프리셋은 아래의 `프리셋 세트`에서 하나로 묶을 수 있습니다. 두 프리셋의 이름이 같으면 별도 설정 없이 자동 세트가 만들어집니다. 이후 생성이나 타율 테스트에서 세트 하나만 고르면 두 프리셋이 함께 선택됩니다.
+
 ![프리셋 메뉴](docs/screenshots/03-presets.png)
 
 ### 3. 이미지 생성
 
 `생성` 메뉴에서 사용할 프리셋과 이미지 크기를 고른 뒤 `이미지 생성`을 누릅니다.
 
-생성 중에는 `실시간 이미지 미리보기`에서 결과를 바로 확인할 수 있습니다.
+생성 중에는 `실시간 이미지 미리보기`에서 결과를 바로 확인할 수 있습니다. 생성이 끝난 이미지 카드에는 화풍과 신체 별점이 각각 나타나므로 메뉴를 이동하지 않고 바로 평가할 수 있습니다.
 
 마음에 드는 이미지가 나오면 히스토리나 가중치 비교 화면에서 `가중치 불러오기`를 누릅니다. 그러면 해당 이미지에 쓰인 작가 가중치가 생성 메뉴에 고정됩니다.
 
@@ -146,10 +182,22 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 
 기본 카테고리는 두 개입니다.
 
-- 메인 그림체 작가
-- 그림체 안정화 작가
+- 메인 그림체 작가: `메인 화풍` 학습 역할
+- 그림체 안정화 작가: `신체 안정화` 학습 역할
+
+필요하면 직접 카테고리를 추가할 수 있습니다. 새 카테고리를 만들 때 `학습 역할`에서 어떤 평점을 사용할지 선택하세요.
 
-필요하면 직접 카테고리를 추가할 수 있습니다.
+이 화면은 태그 입력, 인식 결과, 사용할 태그 수와 가중치 범위를 설정하는 데 사용합니다. 평점 결과와 학습 상태는 별도의 `취향 학습` 메뉴에서 확인합니다.
+
+### 취향 학습
+
+이미지 생성 결과에 남긴 평점이 다음 랜덤 생성에 어떻게 반영되는지 확인하는 화면입니다.
+
+- 화풍 만족도와 신체 안정성의 평가 이미지 수
+- 메인 화풍 작가 선호 순위와 포함 배율
+- 안정화 작가별 추천 가중치와 시험한 가중치 수
+- 카테고리별 학습 역할과 선택 확률 보정 여부
+- 모든 평점과 학습 결과 초기화
 
 ### 프리셋
 
@@ -166,6 +214,7 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 - 마우스 휠로 확대/축소
 - 드래그로 확대된 이미지 이동
 - 마음에 드는 이미지의 가중치 불러오기
+- 이미지에 화풍 만족도와 신체 안정성 평점 남기기
 - 히스토리 선택 삭제 또는 전체 삭제
 - 이상형 월드컵 실행
 
@@ -192,7 +241,7 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 여기서 `씬`은 아래 조합을 뜻합니다.
 
 ```text
-씬 = 베이스+퀄리티 프리셋 + 캐릭터 프리셋 + 생성 개수
+씬 = 베이스+퀄리티 프리셋 + 캐릭터 프리셋 + 이미지 해상도 + 생성 개수
 ```
 
 사용 순서:
@@ -205,6 +254,8 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 
 생성 중 멈추고 싶으면 `생성 중지`를 누르면 됩니다. 현재 처리 중인 이미지가 끝난 뒤 남은 생성을 멈춥니다.
 
+타율 테스트 화면에서는 실시간 미리보기와 전체 진행 상태가 가장 먼저 표시됩니다. 작가 가중치와 순서는 모든 씬에서 그대로 유지되며, 타율 테스트 결과는 취향 학습 평점에서 제외됩니다.
+
 ![타율 테스트 메뉴](docs/screenshots/04-batting-test.png)
 
 ## 이미지 크기
@@ -232,7 +283,7 @@ NovelAI V4+의 멀티 캐릭터 프롬프트는 캐릭터를 쉼표로 합치지
 
 API 토큰은 일반 설정 파일에 저장하지 않고 별도 secret store에 저장합니다. 앱 화면으로 다시 내려보내지도 않습니다.
 
-생성 히스토리에는 이미지 표시와 작가 가중치 비교에 필요한 최소 정보만 저장합니다. 최종 프롬프트, 네거티브 프롬프트, UC 프롬프트, 생성 요청 JSON, 로컬 절대 경로는 별도로 저장하지 않습니다.
+생성 히스토리에는 이미지 표시와 작가 가중치 비교에 필요한 최소 정보만 저장합니다. 최종 프롬프트, 네거티브 프롬프트, 생성 요청 JSON, 로컬 절대 경로는 별도로 저장하지 않습니다.
 
 NovelAI가 이미지 파일 안에 저장하는 생성 정보는 그대로 남을 수 있습니다. 이 정보는 이미지 자체의 메타데이터입니다.
 
@@ -254,7 +305,7 @@ Windows에서 Python을 설치할 때는 `Add Python to PATH` 옵션을 켜는
 
 ### 이미지가 실제로 생성되지 않고 테스트 이미지만 나옵니다
 
-`API 설정`에서 `목업 모드 사용`이 켜져 있는지 확인하세요. 실제 NovelAI 생성을 하려면 목업 모드를 꺼야 합니다.
+`API 설정`에서 `API 없이 체험하기`가 켜져 있는지 확인하세요. 실제 NovelAI 생성을 하려면 체험 모드를 꺼야 합니다.
 
 ### 기본 endpoint가 아닌 주소라는 경고가 나옵니다