ppqwpe/banana-loop

Banana Loop

사용자가 작성한 언어로 응답하세요.

사용자 진입점은 Quick Start입니다. 처음 사용하는 사용자에게 모든 내부 문서를 읽도록 하지 말고 아래의 온보딩 원칙과 에이전트 워크플로우 가이드를 따라 현재 필요한 단계만 안내하세요.

사용자가 채팅에 무엇을 쓸지 묻거나 준비된 예제가 필요하다면 상황에 맞는 복사-붙여넣기 요청 예제에서 하나를 선택하세요. 한 번에 모든 예제를 나열하지 마세요.

첫 사용자 안내

• 스킬, 이미지 또는 시놉시스를 받으면 먼저 접근 가능한 자료를 읽은 후 3-5문장으로 자료 요약 -> 권장 생성 방법 -> 다음 단계를 제공하세요. 아직 읽지 않은 내용은 확인하겠다고 말하고, 읽지 못한 자료를 확인했다고 절대 말하지 마세요. 첫 응답에 설치 지침, 전체 진단 표 또는 긴 코드를 덤프하지 마세요. 구체적인 예시는 첫 응답 템플릿을 따르세요.
• 안내 시 생성 방법을 **① 텍스트 전용 ② 단일 참조 ③ 참조 폴더 (순서대로)**라고 부르세요. 사용자가 결과를 설명하면 에이전트가 일치하는 방법을 선택합니다. 여러 이미지가 있지만 사용자가 한 장만 언급한다면 그것은 ②입니다. 이미지가 첨부되었다고 해서 텍스트 요청에 참조를 강제로 적용하지 마세요.
• 자료만 전달되고 목표가 불분명하다면 간단히 가능한 작업 하나를 제안하고 어떤 결과를 원하는지 물어보세요. 시놉시스의 모든 장면을 자동으로 생성하기 시작하지 마세요. 이미 작업이 요청되었고 정보가 충분하다면 짧은 메모와 함께 진행하고, 동일한 사항에 대해 승인을 받기 위해 멈추지 마세요.
• 먼저 사용자가 원하는 결과와 제공된 자료를 파악하세요. mode, slot, stride, JSON과 같은 내부 용어를 선택사항으로 사용자에게 강요하지 마세요.
• 정보가 부족하다면 결과를 결정짓는 질문만 묶어서 물어보세요. "무슨 작업인지", "자료 위치", "필요한 수량" 중 이미 답변된 것은 건너뛰세요. 간단한 구성이나 스타일 선택은 요청 컨텍스트에서 결정하고 간략하게 언급하세요.
• 현재 단계가 정렬만, 첫 실행, 결과 수정, 중지/재개 중 어떤 것인지 판단하세요. 정렬만 요청되었다면 거기서 멈추세요. 첫 실행 시 완성된 파일을 먼저 제공하고 소량으로 확인하는 방법을 설명하세요. 수정 요청 시 기존 자료, 계획 및 공유 엔진을 재사용하세요.
• 사용자가 하는 일과 에이전트가 하는 일을 분리하세요. 자료 읽기, 이름 연결, 프롬프트 구성, 빌드 및 확인은 에이전트의 작업입니다. 도구로 할 수 없는 것(로그인, 콘솔에 붙여넣기, 폴더 선택)만 사용자에게 구체적으로 안내하세요. 파일 생성을 위해 브라우저 연결을 전제 조건으로 만들지 마세요.
• 첫 번째 핸드오프는 최신 실행 파일 링크, 참조 위치, 지금 해야 할 일, 실제 검증 범위로 끝납니다. 오류가 발생하면 진행 위치와 증상을 확인하고 계속 도와주세요. 짧은 답변을 선호하는 사용자의 선호가 답변 형식보다 우선합니다.
• 준비를 시작하기 전에 지원되지 않는 작업에 대해 사용자에게 알리세요. 구현되지 않은 기능을 사용 가능한 예제로 광고하거나 실패할 코드를 사용자가 시도하도록 하지 마세요.

작업 설명과 제공된 자료를 읽고, 프롬프트, 엔진 및 패널이 포함된 하나의 paste_into_console.js를 빌드하세요. 특정 프로젝트, 계정, 폴더 또는 에이전트에 연결하지 마세요. 파일을 읽고 Python을 실행할 수 있는 에이전트와 함께 사용하세요. 이는 알파 버전입니다.

핵심 작동 원리

세 가지 방법 중 요청에 맞는 것을 선택하세요. 텍스트 전용 생성은 프롬프트만 교체합니다. 단일 참조 생성은 원본을 유지합니다. 여러 참조를 사용한 순차 생성은 하나의 참조 -> 해당 원본에 대한 모든 준비된 프롬프트 실행 -> 기존 참조 삭제 -> 다음 참조 업로드 -> 다음 프롬프트 그룹 실행입니다. 에이전트는 이미지별 프롬프트와 실행 순서를 준비하고, 사용자가 폴더를 연결하고 필요할 때 시작합니다. 하나의 그룹 내에서는 항상 동일한 원본을 유지하고, 생성된 결과를 다음 원본으로 절대 사용하지 마세요.

이미지당 프롬프트 수는 요청에 따라 달라질 수 있습니다. 6개로 고정하거나 모든 이미지에 동일한 문장을 적용하지 마세요. 합성을 위해 사용자에게 캐릭터와 배경을 일치시키도록 요청하지 말고, 다중 참조 기능을 기본 작업으로 확장하지 마세요. 참조 없이 생성하거나 단일 원본을 유지하는 것도 지원됩니다.

현재 엔진 0.3.2-alpha.6의 폴더 모드는 이 순차 교체 구조를 구현합니다. 실제 승인된 요청 검증 범위는 references/release-checks.md에 기록되어 있습니다. 그룹의 요청이 처리되면 다음 이미지로 이동하며, 이미지 렌더링이 완료되기를 기다리는 것으로 설명하지 마세요. 마지막 이미지 이후 종료되며, 사용자가 전체 반복을 요청한 경우에만 무한 반복이 켜집니다. 순차 작업에서는 Shuffle을 OFF로 사용합니다.

작업 이해 및 모드 선택

처음 사용 시 환경 확인 및 에이전트 응답 가이드라인을 읽으세요. 다음 순서로 진행하세요: 환경 확인 -> 컷별 자료 및 프롬프트 -> 완성된 실행 파일과 간단한 시작 가이드 -> 증거 기반 오류 처리. 파일 접근, 코드 실행 및 브라우저 제어 가능 여부를 별도로 확인하고 이미 확인된 사항을 다시 묻지 마세요. 실제 작업 위치와 검증 범위를 명확히 밝히세요. 응답 예제를 사실에 맞게 조정하고, 확인되지 않은 기능을 완료된 것처럼 복사하지 마세요.

요청에서 유지할 것, 변경할 것, 원하는 컷 수, 반복 횟수 및 순서를 식별하세요. 이미 가지고 있는 것을 다시 묻지 마세요. 자료와 목적이 충분하면 에이전트가 아래 모드를 선택하며, 기술적 모드 선택을 사용자에게 맡기지 마세요.

작업	빌드 옵션	동작
① 텍스트 전용	--reference none	프롬프트만 교체합니다. 사이트의 기존 참조는 비워둡니다.
② 단일 참조	--reference manual	사용자가 사이트에 업로드한 원본을 유지하고 프롬프트만 교체합니다.
③ 참조 폴더 (순서대로)	--reference folder	하나의 원본에 대한 프롬프트 그룹을 처리하고, 삭제한 후 다음 번호의 원본을 업로드합니다.

생성된 결과는 자동으로 다음 원본에 연결되지 않습니다. 위 표는 현재 엔진이 지원하는 범위입니다. 다중 참조 합성은 별도로 요청된 경우에만 지원되지 않는다고 설명하고, 기본 순차 실행의 전제 조건으로 만들지 마세요.

폴더 정렬

요청 시 이미지와 시나리오를 직접 보고 목적에 맞게 순서를 설정하세요. 원본을 유지하고 sorted_refs와 같은 별도 폴더에 01_name.png, 02_name.jpg로 복사하세요. 확장자를 유지하고 원본 이름 -> 새 이름 -> 순서 이유를 간략히 보여주세요. 정렬만 요청된 단계에서 프롬프트 생성이나 실행으로 넘어가지 마세요.

사용자가 지정한 실제 작업 폴더를 기준으로 읽고 편집하세요. 자료 이름과 컷 순서는 별개의 사항입니다. 이름을 바꾸거나 복사할 때 컷 목록의 파일 링크도 업데이트하고 존재하는지 확인하세요. 복사본을 만든 경우 정확한 경로를 명시하세요. 다른 폴더를 편집한 결과를 원본 폴더 편집으로 보고하지 마세요.

번호는 1-999까지 고유하며, 지원 형식은 PNG, JPG, JPEG 및 WebP입니다. 연결할 폴더 바로 아래에 이미지를 배치하세요. 자세한 규칙은 naming.md를 참조하세요.

프롬프트 구성

사용자가 요청한 만큼의 영어 프롬프트를 작성하세요. 목적에 맞게 주제, 장면, 구도, 조명 및 스타일을 구성하고, 변형에서는 유지할 것과 변경할 것을 분리하세요. 로고, 텍스트, 일러스트레이션 또는 헤어스타일을 변경하라는 요청을 임의로 제거하거나, 포토리얼하게 만들거나, 고정하라는 지시로 바꾸지 마세요. 단일 인물 단일 샷의 경우 여러 뷰나 시트 중복을 원하지 않는다고 명시하세요.

캐릭터 시트가 요청되고 다른 레이아웃이 지정되지 않은 경우 기본값으로 왼쪽 얼굴 클로즈업 -> 중앙 정면 전신 -> 오른쪽 후면 전신을 사용하세요. 세 뷰는 동일한 캐릭터의 의상, 헤어스타일, 아트 스타일 및 공통 배경을 유지합니다. 레이아웃 비율이나 종횡비를 강제하지 마세요. 사용자의 레이아웃, 뷰 수 또는 기존 시트 레이아웃 유지 요청이 우선합니다. 이 기준을 시트 변형 요청에도 적용하지만, 일반적인 의상/헤어 변경이나 장면 작업을 자동으로 시트 작업으로 만들지 마세요. 단일 뷰 또는 시트 없는 지시를 시트 프롬프트에 넣지 마세요. 예제 텍스트는 prompt-styles.md의 캐릭터 시트 항목을 참조하세요.

특정 종횡비가 요청되지 않은 경우 aspect: "site"를 사용하세요. 모델, 종횡비 및 출력 수는 사이트 설정을 그대로 사용합니다. 기본값은 Loop OFF 및 Shuffle OFF이며, 요청 시 변경합니다. 순차 교체에서는 Shuffle OFF를 사용합니다. 소량으로 확인하는 방법을 설명하지만, 요청된 전체 코드를 제공하기 전에 결과를 기다리게 하는 절차를 강요하지 마세요.

스타일 참조: prompt-styles.md. 기본 촬영 계획 사전 설정이 필요한 경우에만 scripts/scan_refs.py 및 scripts/build_prompts.py와 함께 axes.md를 사용하세요. 자유 형식 요청을 네 가지 사전 설정으로 제한하지 마세요.

변경 축은 각 컷의 목적에 맞게 설정하세요. 변환은 얼굴과 몸을 유지하고 의상과 소품을 변경합니다. 캐릭터-배경 합성은 두 참조의 정체성을 유지하고 접지, 원근법 및 그림자를 일치시킵니다. 카메라 비교는 포즈, 장소 및 조명을 유지하고 구도만 변경합니다. 조명 비교는 포즈, 장소 및 구도를 유지하고 조명만 변경합니다. 조합이 요청되면 컷별 조합을 구성하고, 동일한 고정 문장을 모든 자료에 적용하지 마세요.

데이터 형식

{
  "schema_version": 1,
  "mode": "WITH_REF",
  "project": "사용자 프로젝트 이름",
  "aspect": "site",
  "stride": 10,
  "prompts": {
    "1": "원본 참조를 사용하세요. 피사체 디자인을 유지하세요. 배경만 밝은 스튜디오 배경으로 변경하세요.",
    "11": "동일한 원본 참조를 사용하세요. 피사체 디자인을 유지하세요. 배경만 어두운 스튜디오 배경으로 변경하세요."
  },
  "labels": {"1": "밝은 배경", "11": "어두운 배경"}
}

• manual 및 folder: mode는 WITH_REF입니다. stride는 가장 높은 참조 번호의 배수(최대 1000)입니다. 슬롯 = 참조 번호 + 변형 인덱스 × stride. 위 예제는 원본 01의 두 가지 변형입니다. 원본 01과 02를 각각 한 번씩 처리하려면 슬롯 1과 2를 사용하세요. 한 번호의 모든 변형은 다음 원본으로 이동하기 전에 처리됩니다.
• none: mode는 PROMPT_ONLY입니다. 오름차순 슬롯 번호 순서로 실행되며 stride는 순서에 영향을 미치지 않습니다(생략 시 30). 필요에 따라 많은 슬롯에서 고정 반복을 구성하세요. 예제는 examples/EXAMPLES.md를 참조하세요.

JSON 직렬화를 통해 _prompts.json으로 저장하세요. JSON은 에이전트의 편집 및 빌드를 위한 자료이며, 콘솔에 직접 넣을 파일이 아닙니다.

실행 파일 빌드

console-workflow.md를 읽으세요. Python 3.10 이상이 필요하며, 아래 경로는 이 스킬 폴더를 기준으로 합니다.

python scripts/build_console.py "workfolder/_prompts.json" --reference manual --out "workfolder/paste_into_console.js"

작업에 맞게 manual을 none 또는 folder로 변경하세요. 무한 반복 또는 셔플이 요청된 경우에만 --infinite 및 --shuffle을 추가하세요. 기존 assets/engine.js 및 assets/console-panel.js를 재사용하고, 프로젝트별로 새 엔진을 작성하지 마세요.

완성된 JS에 대해 구문 검사 및 scripts/verify.js 검사를 실행하세요. 최종 응답에서 실행 JS 링크, 해당하는 경우 참조 폴더, 그리고 간단한 사용 순서를 제공하세요. JSON이나 엔진 소스만 전달하고 사용자가 조립하도록 하지 마세요.

사용 가이드

F12 -> Console -> 전체 코드 붙여넣기 -> Enter -> 시작. 차단 경고가 표시되는 경우에만 사용자에게 코드를 확인하고 직접 allow pasting을 입력하도록 안내하세요. manual의 경우 먼저 원본을 업로드하세요. folder의 경우 패널에서 이미지 폴더를 연결하세요. none의 경우 사이트의 기존 참조를 지우세요.

모델에 대한 무제한 권한이 필요하며, 코드가 이를 켜고 런타임에 확인합니다. 실행 탭을 열어두고 컴퓨터 절전 모드를 끄세요. 패널에서 Loop, Shuffle 및 Stop을 제어하세요. Fold는 실행을 계속하고 Close 및 stop은 추가 요청을 차단합니다. 확인되지 않은 수락 마커가 기록되고 실행이 다음 항목으로 이동하며, 성공으로 간주되지 않습니다.

알파 검증 범위

릴리스 환경 및 재확인 방법은 릴리스 검증 기록을 따르세요. 종횡비는 변경되거나 고정되지 않으며, 사이트 설정을 읽습니다. 이는 모든 브라우저, 화면 또는 사이트 변경과의 호환성을 보장하지 않습니다. 오류 발생 시 Log · diagnostics에서 저장된 단계, 번호 및 오류 코드를 확인하고 해당 클래스를 수정하세요. 실패 전에 승인된 전체 요청 세트를 다시 실행하지 마세요.

alpha.5에서는 세 가지 모드에 걸쳐 5번의 실제 승인이 확인되었습니다. 순차 참조는 첫 번째 원본에서 2번 -> 원본 교체 -> 다음 원본에서 1번으로, Test once 후 Resume이 수행되었습니다. 모델, 종횡비 및 출력 수는 유지되었습니다. 최종 이미지 품질 및 기타 브라우저 환경은 검증되지 않았습니다. 모든 환경에서 오류가 없다고 제시하지 마세요. 오류 처리는 troubleshooting.md를 참조하세요. alpha.6은 엔진 내부만 정리했으며 사이트 처리 코드는 변경되지 않았습니다.

순차 참조 실행: 표준 및 검증

2026-10-01 사이트에서 순서는 References(+) -> Upload media -> 업로드 목록에 새 카드가 나타남 -> 해당 카드 선택 -> 참조가 생성 양식에 첨부됨이었습니다. 파일 업로드 완료와 참조 첨부 완료는 다릅니다. 엔진은 연결된 폴더에서 파일을 전달하고, 새 카드를 자동으로 선택한 다음 목록을 닫습니다. 사용자가...