Communitygithub.com

AI Blackhole Director

Compétence Codex pour utiliser et dépanner le directeur de panorama en ligne d'AI Blackhole Studio.

Qu'est-ce que AI Blackhole Director ?

Cette compétence permet aux utilisateurs de travailler avec des sessions locales du directeur de panorama d'AI Blackhole Studio. Elle automatise l'importation d'images locales via `scripts/local_import.py`, le démarrage d'un serveur statique local, et l'ouverture de l'URL générée pour visualiser et interagir avec le panorama. La compétence prend en charge les environnements locaux comme Codex, en incluant un package directeur intégré (`assets/panorama-director-deploy-v1.2.zip`) qui peut être déployé sans option supplémentaire. Elle fournit des instructions claires pour guider l'utilisateur à travers le flux de travail, la vérification du navigateur (présence de la classe `panorama-loaded`, mode de vue `panorama` ou `flat`), et le dépannage des erreurs de serveur, de port, ou d'actifs. Le mode principal est le déploiement local ; le site public (`https://aiblackhole.net/panorama-viewer`) est réservé au diagnostic ou au partage, et ne doit pas être utilisé pour l'importation automatique de fichiers locaux.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. Utilisez scripts/local_import.py pour copier une image locale dans une session locale temporaire du directeur.
  2. Démarrez un serveur statique local.
  3. 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

  1. Si l'utilisateur donne un chemin d'image locale, lisez references/local-import.md et exécutez scripts/local_import.py.
  2. 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.
  3. Confirmez que la page s'est chargée et que document.body a la classe panorama-loaded lorsque le contrôle du navigateur est disponible.
  4. Identifiez la tâche suivante de l'utilisateur :
    • utiliser le directeur
    • apprendre une fonctionnalité
    • personnaliser ou empaqueter les fichiers locaux du directeur
  5. Pour des conseils sur les fonctionnalités, lisez references/feature-guide.md.
  6. Pour des problèmes de serveur local, d'actifs, d'image, de route ou de navigateur, lisez references/troubleshooting.md.
  7. 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 :

  1. Que l'URL locale générée se charge.
  2. Que le nom de l'image téléchargée/importée apparaît dans la zone des métadonnées du fichier.
  3. Que l'état de téléchargement vide est masqué après le chargement.
  4. Que document.body.dataset.viewMode est panorama pour les images panoramiques ou flat pour les images normales.
  5. 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 :

  1. Que le processus du serveur local est en cours d'exécution.
  2. Que l'URL générée imports/<image> renvoie HTTP 200.
  3. Que panorama-viewer.html et panorama-director.js sont présents dans le dossier web local.
  4. Que le port n'est pas occupé par une ancienne session.
  5. 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.

Skills associés