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:
- Verwenden Sie
scripts/local_import.py, um ein lokales Bild in eine temporäre lokale Director-Sitzung zu kopieren. - Starten Sie einen lokalen statischen Server.
- Ö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
- Wenn der Benutzer einen lokalen Bildpfad angibt, lesen Sie
references/local-import.mdund führen Siescripts/local_import.pyaus. - Ö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.
- Bestätigen Sie, dass die Seite geladen wurde und
document.bodydie Klassepanorama-loadedbesitzt, wenn die Browsersteuerung verfügbar ist. - Identifizieren Sie die nächste Aufgabe des Benutzers:
- den Director verwenden
- eine Funktion erlernen
- die lokalen Director-Dateien anpassen oder paketieren
- Lesen Sie für Funktionsanleitungen die Datei
references/feature-guide.md. - Lesen Sie bei Problemen mit dem lokalen Server, Assets, Bildern, Routen oder dem Browser die Datei
references/troubleshooting.md. - 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:
- Die generierte lokale URL wird geladen.
- Der Name des hochgeladenen/importierten Bildes erscheint im Bereich der Dateimetadaten.
- Der leere Upload-Status ist nach dem Laden ausgeblendet.
document.body.dataset.viewModeistpanoramafür Panoramabilder oderflatfür normale Bilder.- 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:
- Der lokale Serverprozess läuft.
- Die generierte
imports/<bild>-URL gibt HTTP 200 zurück. panorama-viewer.htmlundpanorama-director.jssind im lokalen Webordner vorhanden.- Der Port ist nicht durch eine alte Sitzung belegt.
- 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.