NAQUADA
Naquada öffnen
Prüfbarer Ablauf

Naquada direkt in Ihrer IDE

Naquada-Erweiterung für VS Code installieren

Verbinden Sie Codex mit dem Naquada-Orchestrator, bestätigen Sie einen Plan und erhalten Sie Bilder, Videos, Audio- und 3D-Dateien direkt am gewünschten Projektpfad.

Vor dem Start

Die Erweiterung steuert die lokale Rust-CLI. Beide Komponenten werden benötigt.

  • VS Code 1.96 oder neuer.
  • Ein Naquada-Konto im Produktionsdienst.
  • Die Naquada-CLI als Befehl naquada.
  • Codex in VS Code, um Pipelines aus dem Chat zu starten.

Prüfung

Sichtbares Ergebnis: naquada --version antwortet im integrierten Terminal.

Beide Komponenten installieren

1

CLI installieren

Folgen Sie zuerst der Anleitung für macOS, Windows oder Linux. Die Sitzung wird im sicheren Systemspeicher abgelegt.

Naquada-CLI-Anleitung →
2

Erweiterung installieren

Installieren Sie „Naquada for Codex“ aus dem Marketplace und laden Sie VS Code neu.

Distributionslink nicht konfiguriert

Vor der Veröffentlichung muss der Betreiber NEXT_PUBLIC_NAQUADA_VSCODE_MARKETPLACE_URL auf den offiziellen Eintrag setzen. Installieren Sie keine Pakete anderer Herausgeber.
VS Code CLI
code --install-extension naquada.naquada-vscode
3

Installation prüfen

Das Naquada-Symbol erscheint in der Aktivitätsleiste und der Anmeldebefehl in der Befehlspalette.

Projekt und Codex verbinden

1

Anmelden

Öffnen Sie die Befehlspalette (⇧⌘P oder Ctrl+Shift+P), starten Sie „Naquada: anmelden“ und bestätigen Sie den Code im Browser.

Terminal
naquada login
2

Aktuellen Ordner verknüpfen

Starten Sie „Naquada: dieses Projekt verknüpfen“. Wählen Sie einen stabilen Namen und Tag. Es entstehen nur .naquada und ein Kontokontext.

Terminal
naquada project link --name "Mein Projekt" --tag mein-projekt
3

Naquada bei Codex registrieren

Starten Sie „Naquada: Codex über MCP verbinden“, bestätigen Sie und laden Sie das Fenster neu. Der CLI-Befehl erledigt dasselbe.

Terminal
naquada setup codex --apply

Konkrete Prüfung

In der MCP-Liste von Codex ist naquada aktiv und die Planungstools sind sichtbar.

Erstes Asset in VS Code erstellen

Fordern Sie ein präzises Ergebnis mit relativem Zielpfad an. Kostenpflichtige Ausführung beginnt erst nach der von Ihren Einstellungen verlangten Freigabe.

Codex-Prompt
Nutze Naquada für ein 512 × 512 Pixel-Art-Symbol einer magischen Truhe mit transparentem Hintergrund. Speichere das Original unter assets/generated/chest.png. Zeige vor der Ausführung Plan und Kostenschätzung.

Prüfen Sie Modell, Konfiguration, Eingaben, Kosten und assets/generated/chest.png, dann bestätigen Sie.

Sichtbar prüfbares Ergebnis

  • Der Lauf erscheint unter „Naquada — Ausführungen und Assets“.
  • Der lokale Beleg nennt Tool, bestätigten Plan und Zielpfad.
  • assets/generated/chest.png existiert und lässt sich öffnen.
  • Der Hash steht in .naquada/runs/<run-id>.json.

Speicherorte verstehen

Naquada-Pfade sind relativ zur Wurzel des geöffneten Projekts.

  • .naquada/runs/ enthält Belege für Status und Wiederaufnahme.
  • .naquada/assets/ ist nur ein temporärer Puffer, keine Synchronisierung.
  • Die geprüfte Datei wird an den verlangten Zielpfad verschoben.
  • Lokale Referenzen werden nur bei ausdrücklicher Auswahl gesendet.

Namenskollision

Überschrieben wird nur bei ausdrücklicher Anweisung. Sonst wird etwa aus image.png die Datei image-02.png.

Was Naquada nie implizit tut

Workspace-Vertrauen und ausdrückliche Zustimmung bleiben Voraussetzung.

  • Kein Scan oder Upload des gesamten Repositorys.
  • Keine automatische Synchronisierung der Online-Bibliothek.
  • Keine Git-Befehle, Commits oder Branch-Änderungen.
  • Kein Asset-Download ohne bestätigten Lauf und lokalen Beleg.
  • Die Sitzung liegt im sicheren Speicher des Betriebssystems.

VS Code schließen, ohne eine Generierung zu verlieren

Die Generierung läuft bei Naquada weiter; der Chat bleibt frei.

  • Nach dem Neustart werden nur bestätigte Belege aus .naquada/runs/ gelesen.
  • Unvollständige Downloads werden fortgesetzt und per SHA-256 geprüft.
  • Eine Benachrichtigung bestätigt die Ablage oder meldet Handlungsbedarf.
  • Die Wiederaufnahme kann in der Naquada-Ansicht manuell gestartet werden.

Diagnose in weniger als einer Minute

Starten Sie „Naquada: Integration diagnostizieren“ oder diesen Befehl.

Terminal
naquada --json doctor
  • authenticated muss true sein.
  • projectLinked muss true sein.
  • apiReachable muss true sein.
  • gitTouched muss immer false sein.

Ergebnis

Bei ok: true sind Konto, Projekt, Produktions-API und Wiederaufnahmeverzeichnisse bereit.