Communitygithub.com

AI Blackhole Director

Habilidad de Codex para usar y solucionar problemas del director de panoramas en línea AI Blackhole Studio.

¿Qué es AI Blackhole Director?

Esta habilidad permite a los usuarios trabajar con sesiones locales del director de panoramas de AI Blackhole Studio. Está diseñada para desarrolladores y agentes de IA que necesitan importar imágenes locales, iniciar un servidor local y abrir el visor de panoramas correspondiente. La habilidad incluye un paquete empaquetado del director (assets/panorama-director-deploy-v1.2.zip) que se puede extraer y usar automáticamente si no se especifica un --web-dir. El flujo principal implica ejecutar un script de importación local, iniciar un servidor estático local y abrir la URL generada. Además, la habilidad proporciona guías para características, solución de problemas de conexión local, verificación del navegador y recomendaciones para no usar el sitio público como ruta predeterminada. Está destinada a plataformas como Codex y asistentes de codificación similares.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace AI Blackhole Director?

Usa esta habilidad para ayudar a los usuarios a trabajar con sesiones locales del director de panoramas de AI Blackhole Studio.

Punto de Entrada

El flujo de trabajo predeterminado es local:

  1. Usa scripts/local_import.py para copiar una imagen local en una sesión temporal del director local.
  2. Inicia un servidor estático local.
  3. Abre la URL generada http://127.0.0.1:<puerto>/panorama-viewer.html?image=....

La habilidad incluye el paquete del director en assets/panorama-director-deploy-v1.2.zip. Si no se proporciona --web-dir, el asistente puede extraer y usar este paquete incluido.

No uses https://aiblackhole.net/panorama-viewer como ruta predeterminada para esta habilidad. El sitio público puede seguir siendo una referencia de diagnóstico o para compartir, pero la implementación local es el modo principal.

Flujo de Trabajo Principal

  1. Si el usuario proporciona una ruta de imagen local, lee references/local-import.md y ejecuta scripts/local_import.py.
  2. Abre la URL de salida del asistente en el navegador cuando haya control del navegador, o proporciona la URL al usuario cuando no lo haya.
  3. Confirma que la página cargó y que document.body tiene la clase panorama-loaded cuando haya control del navegador.
  4. Identifica la siguiente tarea del usuario:
    • usar el director
    • aprender una característica
    • personalizar o empaquetar los archivos locales del director
  5. Para obtener orientación sobre características, lee references/feature-guide.md.
  6. Para problemas del servidor local, activos, imágenes, rutas o navegador, lee references/troubleshooting.md.
  7. Mantén las instrucciones prácticas y orientadas al usuario. Prefiere el asistente local para abrir imágenes automáticamente.

Importación de Imágenes Locales

Cuando el usuario proporcione una ruta de imagen local y quiera abrirla automáticamente, usa:

python <directorio-de-la-habilidad>/scripts/local_import.py "<ruta-de-la-imagen>" --open

Cuando el usuario solo quiera implementar/abrir el director local sin una imagen, usa:

python <directorio-de-la-habilidad>/scripts/local_import.py --open

Pasa --web-dir solo cuando el usuario quiera explícitamente usar una carpeta web personalizada del director.

Usa la URL de salida del asistente para abrir la sesión local. Explica que la imagen se copia en una sesión web local temporal y no se sube a ningún sitio web público.

Verificaciones del Navegador

Cuando haya control del navegador, verifica:

  1. La URL local generada se carga.
  2. El nombre de la imagen subida/importada aparece en el área de metadatos del archivo.
  3. El estado de carga vacío está oculto después de cargar.
  4. document.body.dataset.viewMode es panorama para imágenes panorámicas o flat para imágenes normales.
  5. Las interacciones principales funcionan: agregar personaje, agregar objeto, agregar oclusor, transformar selección, ocultar/mostrar barra lateral, guardar captura de pantalla.

Referencia Pública Opcional

La URL pública histórica es:

https://aiblackhole.net/panorama-viewer

No la uses para la importación automática de archivos locales. Las páginas web públicas no pueden leer rutas de archivos locales arbitrarias; usa el asistente local en su lugar.

Orden de Solución de Problemas

Para sesiones locales, verifica:

  1. El proceso del servidor local está en ejecución.
  2. La URL generada imports/<imagen> devuelve HTTP 200.
  3. panorama-viewer.html y panorama-director.js están presentes en la carpeta web local.
  4. El puerto no está ocupado por una sesión anterior.
  5. Errores de consola/red del navegador si la imagen aún falla al cargar.

No Hacer

  • No fuerces la subida de archivos locales al sitio público.
  • No uses el sitio web público como ruta predeterminada para esta habilidad.
  • No modifiques una implementación en vivo sin la aprobación explícita del usuario.
  • No asumas que los errores de carga local son causados por la aplicación antes de verificar el proceso del servidor, puerto, ruta, ruta de activos y conceptos básicos de la consola del navegador.

Skills relacionados