AI Blackhole Diretor
Use este skill para ajudar os usuários a trabalhar com sessões locais do diretor de panorama do AI Blackhole Studio.
Ponto de Entrada
O fluxo de trabalho padrão é local:
- Use
scripts/local_import.pypara copiar uma imagem local para uma sessão temporária do diretor local. - Inicie um servidor estático local.
- Abra a URL gerada
http://127.0.0.1:<port>/panorama-viewer.html?image=....
O skill inclui o pacote do diretor em assets/panorama-director-deploy-v1.2.zip. Se nenhum --web-dir for fornecido, o helper pode extrair e usar este pacote incluído.
Não use https://aiblackhole.net/panorama-viewer como caminho padrão para este skill. O site público pode permanecer como referência de diagnóstico ou compartilhamento, mas a implantação local é o modo principal.
Fluxo de Trabalho Principal
- Se o usuário fornecer um caminho de imagem local, leia
references/local-import.mde executescripts/local_import.py. - Abra a URL de saída do helper no navegador quando o controle do navegador estiver disponível, ou forneça a URL ao usuário quando não estiver.
- Confirme que a página carregou e que
document.bodypossui a classepanorama-loadedquando o controle do navegador estiver disponível. - Identifique a próxima tarefa do usuário:
- usar o diretor
- aprender um recurso
- personalizar ou empacotar os arquivos locais do diretor
- Para orientação sobre recursos, leia
references/feature-guide.md. - Para problemas com servidor local, assets, imagem, rota ou navegador, leia
references/troubleshooting.md. - Mantenha as instruções práticas e voltadas para o usuário. Prefira o helper local para abertura automática de imagens.
Importação de Imagem Local
Quando o usuário fornece um caminho de imagem local e deseja abri-la automaticamente, use:
python <skill-dir>/scripts/local_import.py "<caminho-da-imagem>" --open
Quando o usuário deseja apenas implantar/abrir o diretor local sem uma imagem, use:
python <skill-dir>/scripts/local_import.py --open
Pass --web-dir apenas quando o usuário explicitamente quiser usar uma pasta web personalizada do diretor.
Use a URL de saída do helper para abrir a sessão local. Explique que a imagem é copiada para uma sessão web local temporária e não é enviada para nenhum site público.
Verificações no Navegador
Quando o controle do navegador estiver disponível, verifique:
- Se a URL local gerada carrega.
- Se o nome da imagem enviada/importada aparece na área de metadados do arquivo.
- Se o estado vazio de upload está oculto após o carregamento.
- Se
document.body.dataset.viewModeépanoramapara imagens panorâmicas ouflatpara imagens normais. - Se as principais interações funcionam: adicionar personagem, adicionar objeto, adicionar oclusor, transformar seleção, ocultar/mostrar barra lateral, salvar captura de tela.
Referência Pública Opcional
A URL pública histórica é:
https://aiblackhole.net/panorama-viewer
Não a use para importação automática de arquivos locais. Páginas web públicas não podem ler caminhos de arquivos locais arbitrários; use o helper local.
Ordem de Solução de Problemas
Para sessões locais, verifique:
- Se o processo do servidor local está em execução.
- Se a URL gerada
imports/<imagem>retorna HTTP 200. - Se
panorama-viewer.htmlepanorama-director.jsestão presentes na pasta web local. - Se a porta não está ocupada por uma sessão antiga.
- Erros de console/rede do navegador se a imagem ainda falhar ao carregar.
Não Faça
- Não force o upload de arquivos locais para o site público.
- Não use o site público como caminho padrão para este skill.
- Não modifique uma implantação ativa sem aprovação explícita do usuário.
- Não presuma que erros de carregamento local são causados pelo aplicativo sem antes verificar o processo do servidor, porta, rota, caminho do asset e básicos do console do navegador.