Terminalöffner
Verwenden Sie scripts/open-terminal.js, um eine ausführbare Datei und jedes Argument als
separate Prozesseinträge zu erhalten. Verwenden Sie niemals einen Shell-Kommando-String. Halten Sie jeden
spawn-Aufruf auf shell: false. Standardmäßig wird ein nicht-startenen Plan verwendet. Verwenden Sie --launch
ausschließlich, wenn der Benutzer explizit ein echtes Fenster anfordert und das argv überprüft wurde.
Der gestartete Prozess übernimmt die vollständige Umgebung des aufrufenden Prozesses,
einschließlich Variablen mit Geheimnissen. Der Launcher filtert die
Umgebung nicht. Führen Sie ihn in einer Shell aus, deren Umgebung für den Zielbefehl sicher ist.
Einen Befehl starten
Übergeben Sie Launcher-Optionen vor --, dann genau eine ausführbare Datei, gefolgt von ihrem
Argument-Array:
node skills/terminal-opener/scripts/open-terminal.js \
--launch \
--cwd /absolute/host/pfad \
-- ssh -t example.test befehl-mit-argumenten
Führen Sie zuerst den normalen Modus aus. Lassen Sie WezTerm zunächst seinen Mux mit einem neuen Fenster versuchen, dann den
Launcher auf einen getrennten wezterm start-Prozess zurückfallen, falls der Mux nicht
verfügbar ist. Wenn der Fallback verwendet wird, lesen Sie muxFailure aus der JSON-Ausgabe (oder der
menschenlesbaren Fehlerzeile), um zu diagnostizieren, warum der Mux-Pfad fehlgeschlagen ist.
Von der Terminalkonfiguration wiederherstellen
Fügen Sie --recover oder --standalone hinzu, wenn Benutzerkonfiguration oder Mux-Zustand den
den angeforderten Befehl beeinträchtigen könnten. Starten Sie einen getrennten WezTerm-Prozess mit:
--skip-config start --always-new-process
Erwarten Sie, dass der Wiederherstellungsmodus absichtlich alle Benutzer-Terminalkonfigurationen überspringt.
Vor dem Start inspizieren
Lassen Sie --launch weg (oder fügen Sie --dry-run hinzu) und fügen Sie --json hinzu, um die genaue
ausführbare Datei, das argv, das Arbeitsverzeichnis, den Terminaladapter, den primären Start und den
Fallback zu inspizieren, ohne ein Fenster zu öffnen. Behandeln Sie den JSON-Plan als die Kompositionsgrenze
für Aufrufer.
Führen Sie --detect --json ohne einen Befehl aus, um die Terminalverfügbarkeit zu überprüfen. Folgen Sie
der zurückgegebenen action, wenn der Adapter fehlt oder nicht unterstützt wird. Verwenden Sie WezTerm
für den aktuellen Adapter; behandeln Sie andere angeforderte Terminals als nicht unterstützte Pläne,
nicht als auszuführende Befehle.