Communitygithub.com

AIBlackhole Diretor

Skill para usar e solucionar problemas do diretor de panorama online do AI Blackhole Studio.

O que é AIBlackhole Diretor?

Este skill capacita agentes de IA (como Codex, Claude Code ou Cursor) a trabalhar com sessões locais do diretor de panorama do AI Blackhole Studio. Ele permite importar imagens locais para uma sessão temporária do diretor usando um script Python, iniciar um servidor web estático local e abrir a URL gerada com um visualizador de panorama. O principal fluxo de trabalho envolve a importação de imagens para uma sessão web local, garantindo que nenhum arquivo seja carregado em servidores públicos. O skill também fornece diretrizes para verificar se o visualizador foi carregado corretamente no navegador, identificando as próximas tarefas do usuário (por exemplo, usar o diretor, aprender um recurso ou personalizar os arquivos) e consultando referências de solução de problemas e guias de recursos. Ele suporta verificação de navegador para confirmar o carregamento da página, modos de visualização (panorama ou plano) e interações principais, como adicionar personagens e objetos. Uma referência pública (https://aiblackhole.net/panorama-viewer) existe apenas para fins de diagnóstico ou compartilhamento, e não para uso como caminho padrão. O skill inclui um diretor empacotado em `assets/panorama-director-deploy-v1.2.zip`, que pode ser extraído se nenhum diretório web personalizado for fornecido.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add AIBlackhole/aiblackhole-director-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. Use scripts/local_import.py para copiar uma imagem local para uma sessão temporária do diretor local.
  2. Inicie um servidor estático local.
  3. 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

  1. Se o usuário fornecer um caminho de imagem local, leia references/local-import.md e execute scripts/local_import.py.
  2. 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.
  3. Confirme que a página carregou e que document.body possui a classe panorama-loaded quando o controle do navegador estiver disponível.
  4. Identifique a próxima tarefa do usuário:
    • usar o diretor
    • aprender um recurso
    • personalizar ou empacotar os arquivos locais do diretor
  5. Para orientação sobre recursos, leia references/feature-guide.md.
  6. Para problemas com servidor local, assets, imagem, rota ou navegador, leia references/troubleshooting.md.
  7. 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:

  1. Se a URL local gerada carrega.
  2. Se o nome da imagem enviada/importada aparece na área de metadados do arquivo.
  3. Se o estado vazio de upload está oculto após o carregamento.
  4. Se document.body.dataset.viewMode é panorama para imagens panorâmicas ou flat para imagens normais.
  5. 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:

  1. Se o processo do servidor local está em execução.
  2. Se a URL gerada imports/<imagem> retorna HTTP 200.
  3. Se panorama-viewer.html e panorama-director.js estão presentes na pasta web local.
  4. Se a porta não está ocupada por uma sessão antiga.
  5. 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.

Habilidades Relacionadas