Que fait AI Blackhole Director ?
Utilisez cette compétence pour aider les utilisateurs à travailler avec des sessions locales du directeur de panorama d'AI Blackhole Studio.
Point d'entrée
Le flux de travail par défaut est local :
- Utilisez
scripts/local_import.pypour copier une image locale dans une session locale temporaire du directeur. - Démarrez un serveur statique local.
- Ouvrez l'URL générée
http://127.0.0.1:<port>/panorama-viewer.html?image=....
La compétence inclut le package directeur dans assets/panorama-director-deploy-v1.2.zip. Si aucun --web-dir n'est fourni, l'outil peut extraire et utiliser ce package intégré.
N'utilisez pas https://aiblackhole.net/panorama-viewer comme chemin par défaut pour cette compétence. Le site public peut rester une référence de diagnostic ou de partage, mais le déploiement local est le mode principal.
Flux de travail principal
- Si l'utilisateur donne un chemin d'image locale, lisez
references/local-import.mdet exécutezscripts/local_import.py. - Ouvrez l'URL de sortie de l'outil dans le navigateur lorsque le contrôle du navigateur est disponible, ou donnez l'URL à l'utilisateur lorsqu'il ne l'est pas.
- Confirmez que la page s'est chargée et que
document.bodya la classepanorama-loadedlorsque le contrôle du navigateur est disponible. - Identifiez la tâche suivante de l'utilisateur :
- utiliser le directeur
- apprendre une fonctionnalité
- personnaliser ou empaqueter les fichiers locaux du directeur
- Pour des conseils sur les fonctionnalités, lisez
references/feature-guide.md. - Pour des problèmes de serveur local, d'actifs, d'image, de route ou de navigateur, lisez
references/troubleshooting.md. - Gardez les instructions pratiques et tournées vers l'utilisateur. Préférez l'outil local pour l'ouverture automatique d'images.
Importation d'image locale
Lorsque l'utilisateur donne un chemin d'image locale et souhaite l'ouvrir automatiquement, utilisez :
python <skill-dir>/scripts/local_import.py "<chemin-image>" --open
Lorsque l'utilisateur souhaite seulement déployer/ouvrir le directeur local sans image, utilisez :
python <skill-dir>/scripts/local_import.py --open
Passez --web-dir uniquement lorsque l'utilisateur souhaite explicitement utiliser un dossier web personnalisé pour le directeur.
Utilisez l'URL de sortie de l'outil pour ouvrir la session locale. Expliquez que l'image est copiée dans une session web locale temporaire et n'est pas téléchargée sur un site public.
Vérifications du navigateur
Lorsque le contrôle du navigateur est disponible, vérifiez :
- Que l'URL locale générée se charge.
- Que le nom de l'image téléchargée/importée apparaît dans la zone des métadonnées du fichier.
- Que l'état de téléchargement vide est masqué après le chargement.
- Que
document.body.dataset.viewModeestpanoramapour les images panoramiques ouflatpour les images normales. - Que les interactions principales fonctionnent : ajouter un personnage, ajouter un objet, ajouter un occluseur, transformer la sélection, afficher/masquer la barre latérale, enregistrer la capture d'écran.
Référence publique optionnelle
L'URL publique historique est :
https://aiblackhole.net/panorama-viewer
Ne l'utilisez pas pour l'importation automatique de fichiers locaux. Les pages web publiques ne peuvent pas lire des chemins de fichiers locaux arbitraires ; utilisez plutôt l'outil local.
Ordre de dépannage
Pour les sessions locales, vérifiez :
- Que le processus du serveur local est en cours d'exécution.
- Que l'URL générée
imports/<image>renvoie HTTP 200. - Que
panorama-viewer.htmletpanorama-director.jssont présents dans le dossier web local. - Que le port n'est pas occupé par une ancienne session.
- Les erreurs de console/réseau du navigateur si l'image ne se charge toujours pas.
À ne pas faire
- Ne forcez pas le téléchargement de fichiers locaux vers le site public.
- N'utilisez pas le site public comme chemin par défaut pour cette compétence.
- Ne modifiez pas un déploiement en direct sans approbation explicite de l'utilisateur.
- Ne supposez pas que les erreurs de chargement local sont causées par l'application avant de vérifier les bases du processus serveur, du port, de la route, du chemin des actifs et de la console du navigateur.