AI Blackhole Director은(는) 무엇을 하나요?
이 스킬은 사용자가 로컬 AI Blackhole Studio 파노라마 디렉터 세션을 작업할 수 있도록 돕습니다.
진입점
기본 워크플로우는 로컬입니다:
scripts/local_import.py를 사용하여 로컬 이미지를 임시 로컬 디렉터 세션에 복사합니다.- 로컬 정적 서버를 시작합니다.
- 생성된
http://127.0.0.1:<port>/panorama-viewer.html?image=...URL을 엽니다.
이 스킬은 assets/panorama-director-deploy-v1.2.zip 패키지를 포함하고 있습니다. --web-dir이 제공되지 않으면 헬퍼가 이 번들 패키지를 압축 해제하여 사용할 수 있습니다.
이 스킬의 기본 경로로 https://aiblackhole.net/panorama-viewer를 사용하지 마세요. 공개 사이트는 진단 또는 공유 참조 용도로 남겨둘 수 있지만, 로컬 배포가 기본 모드입니다.
핵심 워크플로우
- 사용자가 로컬 이미지 경로를 제공하면
references/local-import.md를 읽고scripts/local_import.py를 실행합니다. - 브라우저 제어가 가능한 경우 헬퍼가 출력한 URL을 브라우저에서 열고, 그렇지 않은 경우 사용자에게 URL을 전달합니다.
- 브라우저 제어가 가능할 때 페이지가 로드되었고
document.body에panorama-loaded클래스가 있는지 확인합니다. - 사용자의 다음 작업을 식별합니다:
- 디렉터 사용
- 기능 학습
- 로컬 디렉터 파일 사용자 지정 또는 패키징
- 기능 안내는
references/feature-guide.md를 참조하세요. - 로컬 서버, 에셋, 이미지, 경로 또는 브라우저 문제는
references/troubleshooting.md를 참조하세요. - 지침은 실용적이고 사용자 중심으로 유지하세요. 자동 이미지 열기를 위해 로컬 헬퍼를 선호하세요.
로컬 이미지 가져오기
사용자가 로컬 이미지 경로를 제공하고 자동으로 열기를 원할 때 사용:
python <skill-dir>/scripts/local_import.py "<image-path>" --open
사용자가 이미지 없이 로컬 디렉터만 배포/열기를 원할 때 사용:
python <skill-dir>/scripts/local_import.py --open
사용자가 명시적으로 사용자 지정 디렉터 웹 폴더를 사용하려는 경우에만 --web-dir을 전달하세요.
헬퍼가 출력한 URL을 사용하여 로컬 세션을 엽니다. 이미지가 임시 로컬 웹 세션에 복사되며 공개 웹사이트에 업로드되지 않는다고 설명하세요.
브라우저 확인
브라우저 제어가 가능할 때 다음을 확인하세요:
- 생성된 로컬 URL이 로드됩니다.
- 업로드/가져온 이미지 이름이 파일 메타데이터 영역에 표시됩니다.
- 로드 후 빈 업로드 상태가 숨겨집니다.
document.body.dataset.viewMode가 파노라마 이미지의 경우panorama, 일반 이미지의 경우flat입니다.- 주요 상호작용이 작동합니다: 캐릭터 추가, 객체 추가, 오클루더 추가, 선택 변형, 사이드바 숨기기/표시, 스크린샷 저장.
선택적 공개 참조
기존 공개 URL:
https://aiblackhole.net/panorama-viewer
자동 로컬 파일 가져오기에 이 URL을 사용하지 마세요. 공개 웹페이지는 임의의 로컬 파일 경로를 읽을 수 없습니다. 대신 로컬 헬퍼를 사용하세요.
문제 해결 순서
로컬 세션의 경우 다음을 확인하세요:
- 로컬 서버 프로세스가 실행 중입니다.
- 생성된
imports/<image>URL이 HTTP 200을 반환합니다. - 로컬 웹 폴더에
panorama-viewer.html과panorama-director.js가 존재합니다. - 포트가 이전 세션에 의해 점유되지 않았습니다.
- 이미지가 여전히 로드되지 않는 경우 브라우저 콘솔/네트워크 오류를 확인합니다.
하지 말아야 할 것
- 로컬 파일을 공개 사이트에 강제로 업로드하지 마세요.
- 이 스킬의 기본 경로로 공개 웹사이트를 사용하지 마세요.
- 명시적인 사용자 승인 없이 라이브 배포를 수정하지 마세요.
- 로컬 로딩 오류가 발생할 때 서버 프로세스, 포트, 경로, 에셋 경로, 브라우저 콘솔 기본 사항을 확인하기 전에 앱이 원인이라고 가정하지 마세요.