¿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:
- Usa
scripts/local_import.pypara copiar una imagen local en una sesión temporal del director local. - Inicia un servidor estático local.
- 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
- Si el usuario proporciona una ruta de imagen local, lee
references/local-import.mdy ejecutascripts/local_import.py. - 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.
- Confirma que la página cargó y que
document.bodytiene la clasepanorama-loadedcuando haya control del navegador. - Identifica la siguiente tarea del usuario:
- usar el director
- aprender una característica
- personalizar o empaquetar los archivos locales del director
- Para obtener orientación sobre características, lee
references/feature-guide.md. - Para problemas del servidor local, activos, imágenes, rutas o navegador, lee
references/troubleshooting.md. - 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:
- La URL local generada se carga.
- El nombre de la imagen subida/importada aparece en el área de metadatos del archivo.
- El estado de carga vacío está oculto después de cargar.
document.body.dataset.viewModeespanoramapara imágenes panorámicas oflatpara imágenes normales.- 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:
- El proceso del servidor local está en ejecución.
- La URL generada
imports/<imagen>devuelve HTTP 200. panorama-viewer.htmlypanorama-director.jsestán presentes en la carpeta web local.- El puerto no está ocupado por una sesión anterior.
- 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.