Communitygithub.com

AI Blackhole Director

Codex 스킬로, AI Blackhole Studio 온라인 파노라마 디렉터를 사용하고 문제를 해결하는 데 도움을 줍니다.

AI Blackhole Director란 무엇인가요?

이 스킬은 AI Blackhole Studio의 로컬 파노라마 디렉터 세션을 사용하고 문제를 해결하는 데 특화된 Codex 스킬입니다. 사용자가 제공한 로컬 이미지를 임시 로컬 디렉터 세션으로 복사하고, 정적 서버를 시작한 후 생성된 URL을 통해 브라우저에서 직접 파노라마 뷰어를 열 수 있도록 지원합니다. 스킬에는 번들 디렉터 패키지가 포함되어 있어 별도의 웹 디렉터리 없이도 즉시 사용 가능하며, 브라우저 제어가 가능한 경우 페이지 로드 및 메타데이터 확인, 뷰 모드 검증, 주요 상호작용(캐릭터 추가, 객체 추가, 변환 등)을 자동으로 점검합니다. 로컬 로딩 오류 발생 시 서버 프로세스, 포트, 경로, 에셋 파일 존재 여부 등 단계별 트러블슈팅을 지원하며, 공개 사이트를 기본 경로로 사용하지 않도록 주의합니다. 주로 Codex 환경에서 활용되며, 개발자와 AI 에이전트 사용자 모두에게 실용적인 가이드를 제공합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add AIBlackhole/aiblackhole-director-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

AI Blackhole Director은(는) 무엇을 하나요?

이 스킬은 사용자가 로컬 AI Blackhole Studio 파노라마 디렉터 세션을 작업할 수 있도록 돕습니다.

진입점

기본 워크플로우는 로컬입니다:

  1. scripts/local_import.py를 사용하여 로컬 이미지를 임시 로컬 디렉터 세션에 복사합니다.
  2. 로컬 정적 서버를 시작합니다.
  3. 생성된 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를 사용하지 마세요. 공개 사이트는 진단 또는 공유 참조 용도로 남겨둘 수 있지만, 로컬 배포가 기본 모드입니다.

핵심 워크플로우

  1. 사용자가 로컬 이미지 경로를 제공하면 references/local-import.md를 읽고 scripts/local_import.py를 실행합니다.
  2. 브라우저 제어가 가능한 경우 헬퍼가 출력한 URL을 브라우저에서 열고, 그렇지 않은 경우 사용자에게 URL을 전달합니다.
  3. 브라우저 제어가 가능할 때 페이지가 로드되었고 document.body에 panorama-loaded 클래스가 있는지 확인합니다.
  4. 사용자의 다음 작업을 식별합니다:
    • 디렉터 사용
    • 기능 학습
    • 로컬 디렉터 파일 사용자 지정 또는 패키징
  5. 기능 안내는 references/feature-guide.md를 참조하세요.
  6. 로컬 서버, 에셋, 이미지, 경로 또는 브라우저 문제는 references/troubleshooting.md를 참조하세요.
  7. 지침은 실용적이고 사용자 중심으로 유지하세요. 자동 이미지 열기를 위해 로컬 헬퍼를 선호하세요.

로컬 이미지 가져오기

사용자가 로컬 이미지 경로를 제공하고 자동으로 열기를 원할 때 사용:

python <skill-dir>/scripts/local_import.py "<image-path>" --open

사용자가 이미지 없이 로컬 디렉터만 배포/열기를 원할 때 사용:

python <skill-dir>/scripts/local_import.py --open

사용자가 명시적으로 사용자 지정 디렉터 웹 폴더를 사용하려는 경우에만 --web-dir을 전달하세요.

헬퍼가 출력한 URL을 사용하여 로컬 세션을 엽니다. 이미지가 임시 로컬 웹 세션에 복사되며 공개 웹사이트에 업로드되지 않는다고 설명하세요.

브라우저 확인

브라우저 제어가 가능할 때 다음을 확인하세요:

  1. 생성된 로컬 URL이 로드됩니다.
  2. 업로드/가져온 이미지 이름이 파일 메타데이터 영역에 표시됩니다.
  3. 로드 후 빈 업로드 상태가 숨겨집니다.
  4. document.body.dataset.viewMode가 파노라마 이미지의 경우 panorama, 일반 이미지의 경우 flat입니다.
  5. 주요 상호작용이 작동합니다: 캐릭터 추가, 객체 추가, 오클루더 추가, 선택 변형, 사이드바 숨기기/표시, 스크린샷 저장.

선택적 공개 참조

기존 공개 URL:

https://aiblackhole.net/panorama-viewer

자동 로컬 파일 가져오기에 이 URL을 사용하지 마세요. 공개 웹페이지는 임의의 로컬 파일 경로를 읽을 수 없습니다. 대신 로컬 헬퍼를 사용하세요.

문제 해결 순서

로컬 세션의 경우 다음을 확인하세요:

  1. 로컬 서버 프로세스가 실행 중입니다.
  2. 생성된 imports/<image> URL이 HTTP 200을 반환합니다.
  3. 로컬 웹 폴더에 panorama-viewer.html과 panorama-director.js가 존재합니다.
  4. 포트가 이전 세션에 의해 점유되지 않았습니다.
  5. 이미지가 여전히 로드되지 않는 경우 브라우저 콘솔/네트워크 오류를 확인합니다.

하지 말아야 할 것

  • 로컬 파일을 공개 사이트에 강제로 업로드하지 마세요.
  • 이 스킬의 기본 경로로 공개 웹사이트를 사용하지 마세요.
  • 명시적인 사용자 승인 없이 라이브 배포를 수정하지 마세요.
  • 로컬 로딩 오류가 발생할 때 서버 프로세스, 포트, 경로, 에셋 경로, 브라우저 콘솔 기본 사항을 확인하기 전에 앱이 원인이라고 가정하지 마세요.

관련 스킬