## Allgemein

    Theta-Rundgang-CLI.exe --help
    Theta-Rundgang-CLI.exe --version

`-h` und `--help` zeigen die Hilfe. `--version` meldet die installierte Version. Ohne Unterbefehl zeigt die separate CLI ihre Hilfe; die GUI-EXE startet ohne Parameter die Oberfläche.

## `scan`

Prüft den Bilderordner, ohne eine Website zu schreiben.

    Theta-Rundgang-CLI.exe scan --images "U:\Ricoh-Theta\20240121" --profile "profiles\haus-des-gastes.json" --json

`--images <Ordner>` ist erforderlich. `--profile <JSON>` wendet optional eine exakte Projektzuordnung an. `--recursive`/`--no-recursive` durchsucht Unterordner standardmäßig mit. `--include-dark` übernimmt auch nahezu schwarze Bilder. `--include-non-panoramas` erlaubt Bilder außerhalb des ungefähren 2:1-Formats. `--include-derived-images` übernimmt bewusst auch erkannte Vorschau-, Thumbnail-, IrfanView- und Exportordner; standardmäßig bleiben sie aus. `--no-deduplicate` behält Dateikopien und mehrfach belegte Aufnahmezeitpunkte. `--json` gibt das Ergebnis maschinenlesbar aus.

## `analyze`

Ordnet Bilder anhand von Aufnahmezeiten, GPS-Koordinaten und Blickwinkeln, trennt Aufnahmeabschnitte und erzeugt lokale Vorschläge der Typen Aufnahmeort und Zeitraffer.

    Theta-Rundgang-CLI.exe analyze --images "U:\Ricoh-Theta\20240121" --output "E:\Rundgang" --station-gap-seconds 300 --station-radius-m 12 --session-gap-seconds 300 --timelapse-min-images 10 --timelapse-interval-tolerance-percent 50 --open

`--output <Ordner>` ist erforderlich. `--station-gap-seconds` begrenzt den Abstand aufeinanderfolgender Bilder eines Aufnahmeorts standardmäßig auf 300 Sekunden, `--station-radius-m` den GPS-Abstand auf 12 Meter und `--session-gap-seconds` die Abschnittstrennung auf 300 Sekunden. Ein Aufnahmeort benötigt mindestens zwei unterschiedliche Blickwinkel. `--detect-timelapses`/`--no-detect-timelapses` schaltet die GIF-Erkennung. `--timelapse-min-images` fordert standardmäßig mindestens 10 Bilder desselben Blickwinkels; `--timelapse-interval-tolerance-percent` erlaubt höchstens 50 Prozent Unterschied zwischen kleinstem und größtem Intervall. Das GIF läuft fest mit 10 Bildern je Sekunde. `--floorplan` und `--floorplan-page` ab 1 ergänzen optional einen Plan. `--title` setzt den sichtbaren Titel, `--open` öffnet den lokalen Bericht und `--json` gibt eine Zusammenfassung aus. Zusätzlich gelten alle Scan-Filter.

## `build`

Erzeugt die vollständige Rundgang-Website. `--floorplan` ist optional; `--floorplan-page` beginnt mit 1.

    Theta-Rundgang-CLI.exe build --images "U:\Ricoh-Theta\20240121" --floorplan "E:\Grundriss.pdf" --floorplan-page 1 --output "E:\Rundgang" --route-strategy recommended --open

`--images` und `--output` sind erforderlich. `--floorplan` ist optional; `--floorplan-page` beginnt mit 1. `--profile` lädt optional ein exaktes JSON-Profil. `--title` setzt den Seitentitel. `--floor-labels` erwartet kommagetrennte Ebenen. `--route-strategy` wählt die globale Reihenfolge aus `recommended` (Standard), `chronological`, `spatial`, `segments` oder `short`. Zeit-, GPS-, Zeitraffer- und Scan-Optionen entsprechen `analyze`. `--open` öffnet die fertige Website. Der Ausgabeordner darf aus Sicherheitsgründen nicht im Bilderordner liegen.

## `serve`

`--site <Ordner>` ist erforderlich. `--port <Zahl>` verwendet standardmäßig 8765; `0` sucht automatisch einen freien Port. `--open` öffnet den Browser. Der Server bindet nur an `127.0.0.1` und speichert die Auswahl der Ortsvorschläge lokal im Ausgabeordner.

    Theta-Rundgang-CLI.exe serve --site "E:\Rundgang" --port 0 --open

## `verify`

`--site <Ordner>` ist erforderlich. Der Befehl prüft Zuordnungen, Grundrissdateien, Panorama-Assets und den Schutz privater Szenen. `--json` liefert das Ergebnis maschinenlesbar.

    Theta-Rundgang-CLI.exe verify --site "E:\Rundgang" --json

## `web-assets`

Prüft in der installierten EXE die eingebetteten Webassets. Beim Aufruf aus dem Quellprojekt werden die React/Vite-Webassets neu gebaut; nur dafür sind Node.js und npm erforderlich.

    Theta-Rundgang-CLI.exe web-assets

## Update-Prüfung und Rückgabecode 3

Vor fachlichen CLI-Befehlen gilt die tägliche Update-Prüfung aus dem Handbuch. Während der 90-Tage-Frist wird die Downloadseite genannt. Nach Ablauf beendet die CLI fachliche Befehle mit Rückgabecode `3`, bis die notwendige Version installiert ist. `--help` und `--version` bleiben erreichbar.