# Prompt Studio 사용 설명서

Prompt Studio는 이미지를 반복해서 뽑고 비교하는 Classic 작업공간 프로필입니다.
가운데에는 이미지 뷰어, 옆에는 최근 생성, 아래에는 프롬프트 작성창과 생성
컨트롤을 둡니다.

어떤 기능인지 헷갈리거나, 작업공간 문제를 재현해서 제보해야 할 때 이 문서를
먼저 확인하세요.

## 기능 지도

| 영역 | 하는 일 | 참고 |
|---|---|---|
| 프롬프트 작성창 | 다음 생성 요청에 보낼 프롬프트를 보관합니다. | 기존 이미지를 선택하는 동작은 보기 전용입니다. 작성창을 덮어쓰면 안 됩니다. |
| 멀티모드 | 현재 프롬프트로 여러 개의 이미지 요청을 시작합니다. | 각 슬롯은 후보 이미지입니다. 콜라주 칸이나 보장된 연속 장면이 아닙니다. |
| 1:1 Direct | 앱이 프롬프트를 덜 바꾸고 원문에 가깝게 전달합니다. | 정확한 문구 비교, 엄격한 템플릿, provider 쪽 prompt syntax 실험에 씁니다. |
| 모델 빠른 메뉴 | 사이드바 상단에서 모델과 추론 강도를 바로 바꿉니다. | 자세한 설명과 전체 설정은 Settings 작업공간에 남아 있습니다. |
| 최근 생성 | Prompt Studio에서 보이는 최근 생성 범위를 보여줍니다. | 화살표 이동은 화면에 보이는 최근 생성 범위와 맞아야 합니다. 영상 항목은 비디오 썸네일로 표시됩니다. 썸네일을 작성창으로 드래그해 참조 이미지로 추가할 수 있습니다. |
| 갤러리 | 로컬 저장 이미지, 전체/즐겨찾기 탭, 폴더를 봅니다. | 즐겨찾기 추가/제거는 보고 있던 갤러리 위치를 유지해야 합니다. |
| 프롬프트 라이브러리 | 저장된 프롬프트를 의도적으로 작성창에 넣습니다. | 라이브러리 삽입/이어가기 같은 명시적 액션만 프롬프트를 가져옵니다. |

## 멀티모드 프롬프트 작성법

멀티모드는 하나의 요청 형태를 여러 후보 슬롯에 반복해서 보냅니다. 여러 대안을
뽑는 기능이지, 한 장 안에 여러 칸을 만드는 기능은 아닙니다.

서로 관련 있는 후보를 원하면 공통 대상을 먼저 적고, 바뀌어도 되는 요소를 뒤에
적으세요.

```text
모든 이미지에서 같은 캐릭터 디자인: 은발의 배달원, 빨간 우비, 작은 검은 가방.
4개의 대안을 만들되 카메라 각도, 조명, 배경 골목만 바꿔 주세요.
얼굴, 옷, 나이, 색감은 유지해 주세요.
```

서로 관계없는 후보를 원하면 그 점을 직접 적으세요.

```text
로컬 이미지 생성 앱을 위한 서로 관계없는 스티커 아이디어 4개.
각 이미지는 마스코트, 색상, 구도가 모두 달라야 합니다.
```

2컷 만화, 전후 비교, 콜라주, 접촉 시트처럼 한 장 안의 구성이 필요하면
멀티모드가 아니라 일반 한 장 생성에서 그렇게 요청하세요.

```text
한 장의 2패널 비교 이미지를 만들어 주세요. 왼쪽은 거친 스케치 UI,
오른쪽은 다듬어진 Prompt Studio UI. 각 패널 안에 작은 라벨을 넣어 주세요.
```

## 1:1 Direct

**1:1 Direct**는 프롬프트의 정확한 문구가 중요할 때 켭니다.

- 문구 차이를 비교할 때
- 구조화된 프롬프트 템플릿을 유지할 때
- provider 쪽 지시문 스타일을 실험할 때
- 문제 재현 중 앱의 문구 보정을 줄이고 싶을 때

Direct와 멀티모드를 동시에 켤 수 있습니다. 이때 각 멀티모드 슬롯은 같은 Direct
프롬프트 요청 형태를 받습니다.

## 추론 강도

추론 강도는 선택한 모델이 생성 전후로 얼마나 많은 계획을 쓰는지에 가까운
설정입니다. 평소에는 기본값으로 시작하고, 제약이 많거나 레퍼런스/구도 조건이
복잡할 때 올리세요.

사이드바의 모델 표시를 누르면 모델과 추론 강도를 빠르게 바꿀 수 있습니다.
자세한 설명과 전체 모델 설정은 Settings 작업공간에 남아 있습니다.

## 갤러리와 프롬프트 안전

Prompt Studio는 보기와 작성을 분리합니다.

- 단순 이미지 선택은 보기 전용입니다.
- 히스토리나 갤러리 이미지를 클릭하면 이미지를 보는 데만 초점이 갑니다.
- 즐겨찾기 추가/제거는 저장 이미지의 metadata만 바꾸며, 보던 갤러리 위치를
  튀게 만들면 안 됩니다.
- 전체/즐겨찾기 탭 전환은 탐색 필터입니다. 프롬프트를 가져오는 동작이 아닙니다.
- 프롬프트 라이브러리 삽입, "이 이미지에서 이어가기", 명시적인 재사용 액션은
  작성창을 바꾸는 의도적 액션입니다.

명시적 프롬프트 가져오기 액션을 썼다면 생성 전에 작성창을 한 번 확인하세요.
단순 이미지 선택은 작성 중인 초안을 건드리지 않아야 합니다.

## Issue #75 정리

v1.1.13 Prompt Studio 문제를 고치면서 아래 동작을 계약으로 고정했습니다.

- 동시에 끝나는 멀티모드 결과는 각 슬롯/request identity를 유지합니다.
- 키보드 이동은 화면에 보이는 최근 생성 범위를 따릅니다.
- 갤러리 버튼은 최근 생성 옆에서 계속 접근 가능해야 합니다.
- 긴 프롬프트가 기본 이미지 뷰어 영역을 과하게 빼앗지 않습니다.
- Direct와 멀티모드 상태를 동시에 볼 수 있어야 합니다.
- 갤러리 즐겨찾기 토글과 탭 전환은 보고 있던 위치를 유지합니다.
- 기존 이미지를 보기 위해 선택하는 것만으로 작성창이 자동 변경되지 않습니다.

## Prompt Studio 문제 제보 방법

이슈를 열 때는 아래를 포함해 주세요.

- `ima2-gen` 버전과 운영체제
- 레이아웃 문제라면 브라우저와 화면 크기
- 작업공간 프로필, 모드 토글, 모델, 추론 강도, 이미지 개수
- 새 `ima2 serve` 세션에서 재현하는 순서
- 전체/즐겨찾기/최근 생성 중 어느 화면에서 생겼는지
- 개인 프롬프트가 드러나지 않는 안전한 스크린샷 또는 화면 녹화

ChatGPT 쿠키, OAuth token 파일, API key, raw upstream response, private prompt
history, generated base64 data는 공유하지 마세요.
