CodeNomad/docs/help/de/desktop.md
Pascal André 5994944f84
feat(settings): manage desktop data profiles and drop the startup question (#1123)
Choosing a desktop data profile needed `CODENOMAD_PROFILE` or, on a first
packaged launch with several restorable profiles, a native question that
blocked startup. Settings only named a non-default profile and offered to
delete all the other profiles at once.

Settings > General > Restore previous state now ends with one folded line,
"Data profile: <name>". Unfolded, it lists every profile on the computer,
the open one first and the others by last use, each with its size, creation
date and last use. A radio chooses the profile the next launch opens (any
profile of this configuration; choosing the open one again cancels), "New
profile" creates one by name, "Restart in <name>" restarts into the choice,
and each other profile has its own delete button with a confirmation. A
launch pinned by `CODENOMAD_PROFILE`, its alias or a development run shows
the profiles without letting the user choose; deletion still works.

Without a remembered choice, a packaged launch no longer asks: it opens the
most recently used of the default, `dev` and `dev-v2` profiles (ties go in
that order) and remembers it, as it already did with zero or one candidate.
A launch that finds the selection lock held opens the detected profile
without remembering it instead of waiting.

Implementation: the existing host listing gains the open profile, creation
(folder birth time, links not followed) and last-use (newest client-state
write) dates, the remembered next-launch profile and whether the launch is
pinned. Two host operations are added on both hosts, granted to local and
Preferences windows only and serialized with list and delete: choosing the
next launch's profile (validated with the `CODENOMAD_PROFILE` grammar,
written under the selection lock, overwriting this configuration's entry,
creating a new profile's scope folder inside the lock and removing it again
if the write fails) and restarting through the graceful developer-mode
relaunch. Electron's throwaway question storage, relaunch and private
hand-offs are removed; it still sweeps leftover question folders and drops
the two hand-off variables an older build's relaunch can carry. Tauri keeps
only the invalid-profile error dialog. `CODENOMAD_DESKTOP_PROFILE` and the
server's `desktopProfile` meta field are removed, since nothing displays them.

Only a profile whose name leads back to its own folder can be chosen, so a
folder the deprecated alias made under another profile's name (such as
default-<hash>) is listed under its stored name but not offered. The
listing reports the next launch's profile only when the launch would open
it (the launch's own remembered-profile check), and Restart in <name> lists
again first and restarts only while that still names the shown profile.
Choosing with the keyboard keeps focus on the chosen radio.

Validation: UI browser tests for the manager (listing, choose and restart,
new profile and name validation, single deletion, macOS note, pinned
launches, plain browser), Electron native tests (listing dates, current,
next launch, pinned, set-next-launch outcomes, relaunch wiring, preload,
automatic choice, lock and sweep) and Tauri tests (the same cases, grants
and command wiring). Developer doc and help (10 languages) updated.
2026-10-24 09:46:30 +02:00

9 KiB
Raw Permalink Blame History

Desktop-Fenster und Daten

Fenster, Tabs und gemeinsamer Dienst

  1. Verwenden Sie Neue Instanz, um einen weiteren Projekt-/Startseiten-Tab im aktuellen Fenster zu öffnen.
  2. Verwenden Sie das native Fenster → Neues Fenster (Ctrl+Shift+N oder Cmd+Shift+N) für ein separates Anwendungsfenster.
  3. Aktivieren Sie unter Einstellungen → Erweitert die Option Vorhandenes Fenster beim zweiten Start fokussieren, wenn ein weiterer Start das zuletzt verwendete Fenster fokussieren statt ein neues öffnen soll.

Projekt-Tabs, ausgewählte Unterhaltungen und Layout gehören zum Fenster. OpenCode-Sitzungen/-Nachrichten gehören zum gemeinsamen nativen OpenCode-Dienst: Andere Fenster können dieselbe Unterhaltung sehen. Das Schließen eines Projekt-Tabs schließt das Projekt in CodeNomad, nicht seine OpenCode-Sitzungen; öffnen Sie es erneut, um sie wiederzufinden. Ein anderes Fenster, das dieselbe Projektverbindung anzeigt, schließt seinen Tab ebenfalls und zeigt eine Benachrichtigung; separat geöffnete Tabs desselben Ordners sind nicht betroffen. Das Schließen eines ganzen Fensters, Beenden oder Neuladen bewahrt Projektverbindungen für die Wiederherstellung; siehe Projekte. Verwenden Sie geschlossene Fenster nicht als Beweis, dass Agent oder geplante Mission gestoppt wurde.

Native Anwendungsmenüs verwenden die Oberflächensprache von CodeNomad, sobald ein Fenster geladen ist; bis dahin erscheinen sie auf Englisch. Hilfe → Über CodeNomad (auch im macOS-Anwendungsmenü) öffnet Einstellungen → Info mit Version, Updates und Diagnose.

Einstellungen und Startwiederherstellung

  1. Öffnen Sie Einstellungen aus dem zu konfigurierenden Fenster. Lokale Desktop-Einstiege fokussieren das eine native Einstellungsfenster mit Projekt/Location dieses öffnenden Fensters.
  2. Schalten Sie unter Allgemein die Option Vorherigen Zustand wiederherstellen ein oder aus.
  3. Verwenden Sie zum Vergessen des gespeicherten Fensterlayouts Gespeicherten Startzustand löschen. Dies wirkt sofort, ohne Bestätigung.

Wiederherstellung kann Arbeitsbereichs-/SideCar-Tabs und aktive Sitzungen, ungesendeten Text, Scrollpositionen, Panels, Fensterposition und Zoom erneut öffnen. Es handelt sich um fensterbezogenen Client-Zustand, keine Kopie der nativen Unterhaltungsdatenbank. Löschen entfernt gespeicherte Tabs, Entwürfe und Layout; es löscht weder CodeNomad-Konfiguration noch OpenCode-Unterhaltungen. Sichern Sie wichtige ungesendete Entwürfe vorher anderswo.

Das Einstellungsfenster hat keinen separaten Wiederherstellungszustand: Diese Bedienelemente zielen auf das Fenster, das es öffnete. Ist dieses geschlossen oder unbekannt, weil die Einstellungen beim Start wieder geöffnet wurden, folgen sie stattdessen dem zuletzt verwendeten Fenster; eine für ein anderes Fenster vorbereitete Änderung wird nie angewendet, die Bedienelemente zeigen zuerst den Wert des neuen Fensters. Um ein bestimmtes Fenster zu konfigurieren, öffnen Sie die Einstellungen aus diesem Fenster. Projektbezogene Einstellungen verwenden ebenfalls die Location des öffnenden Fensters und bleiben ohne sie nicht verfügbar. Werden die Einstellungen beim Start wieder geöffnet, verbinden sie sich erneut, sobald dieses Projekt fertig geöffnet ist; solange der Ordner noch startet oder in mehreren Tabs geöffnet ist, bleiben sie nicht verfügbar, bis Sie die Einstellungen aus dem gewünschten Fenster öffnen.

Browser- und Remote-Einstellungen sind eingebettet, kein zweiter nativer Einstellungsbesitzer. Ein Fehler beim Öffnen nativer Einstellungen wird gemeldet; er bedeutet nicht, dass stattdessen eine versteckte eingebettete Einstellungsseite geöffnet wurde.

Desktop-Datenprofile

  1. Klappen Sie in den nativen Einstellungen → Allgemein unter Vorherigen Zustand wiederherstellen den Eintrag Datenprofil auf. Er listet alle Profile auf diesem Computer mit Größe, Erstellungsdatum und letzter Verwendung auf, das geöffnete zuerst.
  2. Wählen Sie das Profil, das der nächste Start öffnet, oder wählen Sie Neues Profil und geben Sie einen Namen aus 1–64 Kleinbuchstaben, Ziffern, Punkten, Bindestrichen oder Unterstrichen ein, beginnend mit einem Buchstaben oder einer Ziffer.
  3. Wählen Sie In … neu starten, um sofort zu wechseln; andernfalls öffnet sich das gewählte Profil beim nächsten Start. Erneutes Auswählen des geöffneten Profils hebt die Änderung auf.

Profile aus einer anderen Konfiguration werden aufgelistet, können hier aber nicht gewählt werden. Ohne gemerkte Auswahl prüft ein paketierter Start Standard-, dev- und dev-v2-Profil auf wiederherstellbare Arbeit und öffnet das zuletzt verwendete davon, oder das Standardprofil, wenn keines solche Arbeit enthält. Die Auswahl eines Profils verschiebt, vereint oder löscht keine Profildaten.

Ein vor dem Programmstart gesetztes CODENOMAD_PROFILE hat Vorrang vor dieser Auswahl; Datenprofil zeigt die Profile dann an, ohne eine Auswahl zu erlauben. default oder stable wählt das Standardprofil, und ein ungültiger Name verhindert den Start, statt ein anderes Profil zu wählen. Beispielsweise in PowerShell vor dem Start der gewünschten Desktop-Programmdatei:

$env:CODENOMAD_PROFILE = "review"

Setzen Sie für unabhängige Serverkonfiguration zusätzlich vor dem Start CLI_CONFIG auf eine separate Konfigurationsdatei. Standard ist ~/.config/codenomad/config.yaml. Ein Profilname allein ändert weder diese Datei noch den gemeinsamen OpenCode-Dienst.

Durch Desktop-Datenprofil isoliert Nicht automatisch isoliert
Fenster-/Tab-Wiederherstellung, ungesendete Entwürfe und Desktop-Singleton-/Backend-Geltungsbereich OpenCode-Sitzungen, Nachrichten, Anbieterzugangsdaten und Ausführung
Nativer Chromium-/WebView-Speicher dieses Profils unter Plattformgrenzen CodeNomad-Konfiguration/Einstellungen, Sprachschlüssel, SideCars und Erweiterungsaktivierung bei geteilter Konfiguration
Nativer Vorschauspeicher innerhalb Host/Profil Dateien geöffneter Projekte; Daten entfernter Server

Unter macOS-Tauri teilen Profile System-WebKit-Speicher, Anmeldungen und Cache; verwenden Sie Profilnamen nicht zur sicherheitsbezogenen Kontentrennung. Electron speichert Webdaten im Profil. Installierte Version und Update-Kanal wählen niemals ein anderes Datenprofil. Nicht paketierte Entwicklungsstarts verwenden ohne explizite Auswahl das Profil dev.

Ein gespeichertes Profil löschen

  1. Klappen Sie Datenprofil wie oben auf und aktualisieren Sie bei Bedarf die Liste.
  2. Wählen Sie die Löschschaltfläche des zu entfernenden Profils. Das geöffnete Profil hat keine.
  3. Bestätigen Sie erst nach Sicherung benötigter Entwürfe/Anmeldungen. Prüfen Sie vor Wiederholung Berichte zu unvollständiger Entfernung.

Die Löschung entfernt gespeicherte Tabs, Entwürfe, Layout und zugehörigen Webspeicher/Cache/Anmeldungen dieses Profils, auch bei einem aufgelisteten Profil einer anderen Konfiguration. Sie bewahrt geöffnetes Profil, OpenCode-Unterhaltungen und Projektdateien. Ein geöffnetes Profil oder eines mit unbekanntem Zustand kann nicht gelöscht werden; schließen Sie die relevanten CodeNomad-Fenster, aktualisieren Sie die Liste und versuchen Sie es erneut. Unbekannte Inhalte werden behalten und gemeldet statt pauschal gelöscht.

Der gemeinsame WebKit-Speicher von macOS-Tauri bleibt erhalten, da dessen Löschung andere Profile betreffen würde. Diese Bereinigung ist nicht rückgängig zu machen: Eine erhaltene native Unterhaltung stellt keinen gelöschten ungesendeten Entwurf wieder her. Gespeicherten Startzustand löschen ist die kleinere Aktion, wenn Sie nur das aktuelle Fenster zurücksetzen möchten.

Zoom und Panel-Geometrie

  1. Verwenden Sie nativ Ansicht → Vergrößern, Verkleinern oder Originalgröße; Tastatur/Mausrad folgen ebenfalls der Host-Unterstützung.
  2. Verwenden Sie Linke Seitenleiste und Rechte Seitenleiste an den festen äußeren Kopfecken zum Umschalten. Heften/lösen Sie Schubladen, soweit das Layout dies erlaubt.
  3. Passen Bedienelemente nicht mehr, verringern Sie den Zoom oder verbreitern das Fenster; schmale Layouts verschieben Bedienelemente in Menüs und Panels in Überlagerungen.

Lokale und entfernte Desktop-Hauptfenster reservieren mindestens 390 × 600 CSS-Pixel, skaliert mit Anwendungszoom und begrenzt durch die Monitor-Arbeitsfläche. Hineinzoomen kann ein zu kleines Fenster vergrößern; Herauszoomen verkleinert kein bereits größeres. Einstellungs- und Browser-Vorschau-Unterfenster haben eigene Größenregeln.

Panels lassen vor dem Schweben eine Mindestbreite für die Unterhaltung. Unter 420 CSS-Pixeln Unterhaltungsbreite wird die Timeline ausgeblendet und Kopfaktionen verwenden ihr Überlaufmenü; die gespeicherte Timeline-Einstellung bleibt erhalten. Diese Geometrieänderungen verändern weder Prompt-Entwurf noch native Sitzung. Siehe Einstellungen und Layout und Browser-Vorschauen und SideCars.