Communitygithub.com

AI Blackhole Director

Fertigkeit für Codex zur Verwendung und Fehlerbehebung des Online-Panorama-Directors von AI Blackhole Studio.

Was ist AI Blackhole Director?

Diese Fertigkeit ermöglicht es Codex-Agenten, mit lokalen AI Blackhole Studio Panorama-Director-Sitzungen zu arbeiten. Sie bietet einen vollständigen Arbeitsablauf: Importieren lokaler Bilder über ein Skript, Starten eines lokalen statischen Servers und Öffnen der generierten Panorama-Viewer-URL. Die Fertigkeit enthält das Director-Paket als gebündelte ZIP-Datei, das bei Bedarf extrahiert werden kann. Sie unterstützt die Fehlerbehebung bei lokalen Servern, Assets, Bildern, Routen und Browser-Problemen über eine referenzierte Troubleshooting-Datei. Zudem bietet sie Anleitungen zu Funktionen und ermöglicht die automatische Bildöffnung, ohne dass Dateien auf die öffentliche Website hochgeladen werden. Der primäre Modus ist die lokale Bereitstellung – die öffentliche Website wird nur als Diagnose- oder Freigabe-Referenz verwendet.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht AI Blackhole Director?

Verwenden Sie diese Fertigkeit, um Benutzern bei der Arbeit mit lokalen AI Blackhole Studio Panorama-Director-Sitzungen zu helfen.

Einstiegspunkt

Der Standard-Workflow ist lokal:

  1. Verwenden Sie scripts/local_import.py, um ein lokales Bild in eine temporäre lokale Director-Sitzung zu kopieren.
  2. Starten Sie einen lokalen statischen Server.
  3. Öffnen Sie die generierte URL http://127.0.0.1:<port>/panorama-viewer.html?image=....

Die Fertigkeit enthält das Director-Paket unter assets/panorama-director-deploy-v1.2.zip. Wenn kein --web-dir angegeben wird, kann der Helfer dieses gebündelte Paket extrahieren und verwenden.

Verwenden Sie nicht https://aiblackhole.net/panorama-viewer als Standardpfad für diese Fertigkeit. Die öffentliche Website kann als Diagnose- oder Freigabe-Referenz dienen, aber die lokale Bereitstellung ist der primäre Modus.

Kern-Workflow

  1. Wenn der Benutzer einen lokalen Bildpfad angibt, lesen Sie references/local-import.md und führen Sie scripts/local_import.py aus.
  2. Öffnen Sie die Ausgabe-URL des Helfers im Browser, wenn die Browsersteuerung verfügbar ist, oder geben Sie dem Benutzer die URL, wenn dies nicht der Fall ist.
  3. Bestätigen Sie, dass die Seite geladen wurde und document.body die Klasse panorama-loaded besitzt, wenn die Browsersteuerung verfügbar ist.
  4. Identifizieren Sie die nächste Aufgabe des Benutzers:
    • den Director verwenden
    • eine Funktion erlernen
    • die lokalen Director-Dateien anpassen oder paketieren
  5. Lesen Sie für Funktionsanleitungen die Datei references/feature-guide.md.
  6. Lesen Sie bei Problemen mit dem lokalen Server, Assets, Bildern, Routen oder dem Browser die Datei references/troubleshooting.md.
  7. Halten Sie die Anweisungen praktisch und benutzerorientiert. Bevorzugen Sie den lokalen Helfer für das automatische Öffnen von Bildern.

Lokaler Bildimport

Wenn der Benutzer einen lokalen Bildpfad angibt und möchte, dass es automatisch geöffnet wird, verwenden Sie:

python <skill-dir>/scripts/local_import.py "<bild-pfad>" --open

Wenn der Benutzer nur den lokalen Director bereitstellen/öffnen möchte, ohne ein Bild, verwenden Sie:

python <skill-dir>/scripts/local_import.py --open

Übergeben Sie --web-dir nur, wenn der Benutzer explizit einen benutzerdefinierten Director-Webordner verwenden möchte.

Verwenden Sie die Ausgabe-URL des Helfers, um die lokale Sitzung zu öffnen. Erklären Sie, dass das Bild in eine temporäre lokale Websitzung kopiert wird und nicht auf eine öffentliche Website hochgeladen wird.

Browser-Prüfungen

Wenn die Browsersteuerung verfügbar ist, überprüfen Sie:

  1. Die generierte lokale URL wird geladen.
  2. Der Name des hochgeladenen/importierten Bildes erscheint im Bereich der Dateimetadaten.
  3. Der leere Upload-Status ist nach dem Laden ausgeblendet.
  4. document.body.dataset.viewMode ist panorama für Panoramabilder oder flat für normale Bilder.
  5. Die Hauptinteraktionen funktionieren: Charakter hinzufügen, Objekt hinzufügen, Occluder hinzufügen, Auswahl transformieren, Seitenleiste ein-/ausblenden, Screenshot speichern.

Optionale öffentliche Referenz

Die historische öffentliche URL ist:

https://aiblackhole.net/panorama-viewer

Verwenden Sie diese nicht für den automatischen Import lokaler Dateien. Öffentliche Webseiten können keine beliebigen lokalen Dateipfade lesen; verwenden Sie stattdessen den lokalen Helfer.

Fehlerbehebungsreihenfolge

Überprüfen Sie bei lokalen Sitzungen:

  1. Der lokale Serverprozess läuft.
  2. Die generierte imports/<bild>-URL gibt HTTP 200 zurück.
  3. panorama-viewer.html und panorama-director.js sind im lokalen Webordner vorhanden.
  4. Der Port ist nicht durch eine alte Sitzung belegt.
  5. Browser-Konsole-/Netzwerkfehler, wenn das Bild weiterhin nicht geladen wird.

Nicht tun

  • Laden Sie keine lokalen Dateien zwangsweise auf die öffentliche Website hoch.
  • Verwenden Sie die öffentliche Website nicht als Standardpfad für diese Fertigkeit.
  • Ändern Sie keine Live-Bereitstellung ohne ausdrückliche Zustimmung des Benutzers.
  • Gehen Sie nicht davon aus, dass lokale Ladefehler von der App verursacht werden, bevor Sie Serverprozess, Port, Route, Asset-Pfad und Browser-Konsole grundlegend überprüft haben.

Verwandte Skills