CodeNomad/docs/help/de/conversations.md
Pascal André 1dabb5110f
docs(help): bring the user guide back in line with the current app (#1079)
docs(help): bring the user guide back in line with the current app

The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer.

Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages.

The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English.

Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
2026-10-21 14:38:29 +02:00

12 KiB

Unterhaltungen

CodeNomad stellt native OpenCode-Sitzungen als Unterhaltungen dar, mit einer Hierarchie für delegierte Arbeit und separaten Bedienelementen für Ihre nächste Eingabe.

Nachrichten stellen Markdown, Code, Diffs und unterstützte Bilder aus Werkzeugergebnissen dar. Textkopie, Vollverlaufssuche und Sprachausgabe verwenden Textprojektionen, keine eingebetteten Bildbytes. Nachrichteninhalt ändert die Sichtbarkeit, ohne gespeicherte Teile zu löschen; Verlauf unterscheidet Anzeigeeinstellungen und Bereinigung.

Kopfzeilen von Denkprozessen und Werkzeugen zeigen, wie lange jeder Schritt gedauert hat, und zählen live mit, solange er läuft; Dauern unter einer Sekunde werden nicht angezeigt. Wenn Tokens in Nachrichteninhalt angezeigt wird (die Voreinstellung Alles zeigt sie), endet jede Agentennachricht nach ihrem letzten Text mit einer Token- und Kostenzeile. Diese Zeile summiert die Nachricht und die Nachrichten mit den Werkzeugen und Denkprozessen, die ihre Aktion Tools und Denkprozesse aus dieser Antwort entfernen abdeckt, innerhalb des geladenen Verlaufs; klappen Sie sie für Denk- und Cache-Zähler auf. Schritte, die nur Werkzeuge ausgeführt haben, haben keine eigene Zeile.

Unterhaltungen finden und navigieren

  1. Wählen Sie eine Zeile unter Sitzungen oder verwenden Sie Neue Sitzung, um eine übergeordnete Unterhaltung zu beginnen.
  2. Klappen Sie den Pfeil einer übergeordneten Sitzung auf, um deren Untersitzungen zu sehen. Ein eingeklappter Pfeil zeigt den dringendsten Zustand seiner Nachfahren: wartet auf Eingabe, arbeitet oder kürzlich beendet (untätig); sein Tooltip zählt sie.
  3. Grenzen Sie die Liste mit Sitzungen suchen..., Hauptsitzungen / Untersitzungen, dem Worktree-Filter und der Sortierung nach Aktivität, Name oder Worktree ein.
  4. Verwenden Sie Zurück und Vorwärts in der Seitenleiste, um zuvor angezeigte Unterhaltungen erneut aufzurufen.

Normales Durchsuchen ist hierarchisch; Such-/Filterergebnisse sind flache Einträge mit eigener Identität und eigenem Worktree jeder Unterhaltung. Eine neu arbeitende Untersitzung wird nur unter der Familie der aktiven Unterhaltung automatisch eingeblendet. Das Einklappen dieses Zweigs beendet diese automatische Einblendung für die derzeit laufenden Nachfahren.

Zurück/Vorwärts ist ein Besuchsverlauf pro Projekt-Tab und Fenster, nicht die Reihenfolge der Liste. Er bleibt im Arbeitsspeicher, überspringt nicht verfügbare/gelöschte Unterhaltungen und wird nach einem Neustart nicht wiederhergestellt. Die Auswahl einer neuen Unterhaltung nach dem Zurückgehen ersetzt den Vorwärtspfad. Vorherige Sitzung / Nächste Sitzung in der Palette durchlaufen stattdessen die sichtbare Liste.

Agent, Modell und Denkaufwand wählen

  1. Verwenden Sie vor dem Senden die Agenten- und Modellauswahl in der Fußzeile des Eingabefelds.
  2. Falls das Modell Varianten anbietet, wählen Sie den Aufwand unter Denken; Standard verwendet weiterhin den nativen Standard.
  3. Senden Sie den nächsten Prompt und prüfen Sie zur Diagnose eines Ergebnisses die Agenten-/Modellmetadaten der Antwort.

Eine neue Unterhaltung beginnt mit dem Agenten, den OpenCode als Standard auflöst und den ein Plugin festlegen kann, sofern Sie keinen anderen wählen. Die Tooltips der Auswahlfelder zeigen ihre Tastenkürzel.

Dies sind Ausführungsentscheidungen für spätere Eingaben, keine Änderungen an früheren Antworten. Das Lesen einer alten Timeline-Passage ersetzt die aktuelle Auswahl im Eingabefeld nicht durch historische Metadaten. Modellsichtbarkeit, Favoriten und Anbieterverbindungen werden unter Anbieter verwaltet.

Entwürfe und Anhänge

  1. Schreiben Sie in der ausgewählten Unterhaltung. Ein Unterhaltungswechsel behält deren Entwurf, statt ihn zu senden.
  2. Wählen Sie für Dateien dieses Geräts Datei anhängen… im Menü Weitere Aktionen des Eingabefelds oder legen Sie sie ab bzw. fügen Sie sie ein; oder geben Sie @ ein, um Projektdateien, Agenten oder Skills auszuwählen.
  3. Prüfen Sie die Anhang-Chips und entfernen Sie alles, was nicht zur nächsten Eingabe gehören soll.
Eingabe Quelle und Wirkung
Geräteanhang Auswahl, Ablegen oder Zwischenablage liest Bytes vom Gerät mit der Oberfläche; dies ist kein Serverpfad
Projekt-@-Referenz Wird im Projekt/der Location der Unterhaltung auf dem Backend aufgelöst, einschließlich ihres Worktrees
Agentenerwähnung Hängt die ausgewählte Agentenreferenz an, statt vergangene Nachrichten zu ändern
Skill Durchsucht die Skills der Location nach Name/Beschreibung und hängt eine entfernbare Skill-Auswahl an

Gerätedateien müssen lesbar sein und ins Anhangsbudget passen: höchstens je 5 MiB, 10 Dateien und insgesamt 20 MiB. Eine abgelehnte Datei wird nicht angehängt; prüfen Sie den Hinweis, statt den Erfolg der gesamten Auswahl anzunehmen.

Die Auswahl eines Skills entfernt das @query-Token und fügt einen Chip hinzu. Senden leert diese Auswahl im Eingabefeld, nicht die von OpenCode bereits mit der gesendeten Nachricht gespeicherten Anweisungen. Historische Nachrichten behalten Skill-Bezeichnungen. Ein beim Bearbeiten eines wartenden Prompts entfernter Skill bleibt auch beim ersetzenden Senden entfernt.

Auf dem Desktop verschiebt Senden den Tastaturfokus in die Unterhaltung, sodass Pfeiltasten, Bildlauftasten und Leertaste sie scrollen; das Tippen eines Zeichens kehrt mit diesem Zeichen zum Eingabefeld zurück. Prompt-Text löschen in Weitere Aktionen (Standard Ctrl/Cmd+K) leert den Entwurf des Eingabefelds.

Entwürfe sind clientseitiger Arbeitszustand, keine gemeinsamen nativen Nachrichten. Die Startwiederherstellung kann unterstützten Eingabezustand behalten; behandeln Sie einen ungesendeten Entwurf oder Anhang aber nicht als Sicherung und nehmen Sie nicht an, dass er auf einem anderen Gerät erscheint. Sichern Sie wichtigen Text vor dem Löschen von Startdaten oder dem Schließen eines Clients mit deaktivierter Wiederherstellung; siehe Desktop.

Befehle und Shell-Modus

  1. Geben Sie / ein, wählen Sie einen gefundenen benutzerdefinierten Befehl und geben Sie dessen Argumente an.
  2. Für einen direkten Shell-Befehl geben Sie am Anfang eines leeren Eingabefelds ! ein, um den Shell-Modus zu aktivieren.
  3. Senden Sie den Befehl. Verlassen Sie den Shell-Modus ohne Ausführung mit Escape oder mit Backspace im leeren Feld.

Nur bekannte Slash-Befehlsnamen nehmen den Weg für benutzerdefinierte Befehle; unbekanntes /text ist ein normaler Prompt. Benutzerdefinierte Befehle verwenden ihre native Definition. Datei-/Bildanhänge werden auf diesem Weg nicht gesendet und bleiben für einen späteren Prompt erhalten; eingefügter Text in Argumenten wird in diese aufgelöst.

Der Shell-Modus führt eine native Sitzungs-Shell-Anfrage aus, statt das Modell um einen Befehlsvorschlag zu bitten. Er kann Dateien ändern und Prozesse auf dem Ausführungshost starten. Profil-Umgebungseinstellungen gelten vor dem nächsten Prompt, benutzerdefinierten Befehl oder Shell-Aufruf; sie starten keinen vorhandenen Dienst neu. Siehe Integrationen und OpenCode-Einrichtung.

Folgeprompts steuern, einreihen und bearbeiten

  1. Aktivieren Sie unter Einstellungen → Allgemein die Option Gesendete Prompts in die Warteschlange stellen, um während einer beschäftigten Sitzung gesendete Folgeprompts einzureihen; lassen Sie sie deaktiviert (Standard), um die laufende Aufgabe zu steuern.
  2. Senden Sie während einer beschäftigten Sitzung einen Folgeprompt mit diesem Verhalten. Für das andere Verhalten wählen Sie Nachricht einreihen oder Jetzt einschieben im Menü Weitere Aktionen des Eingabefelds oder verwenden das alternative Sendetastenkürzel (Standard Alt+Enter unter Windows und Linux, Cmd+Shift+Return unter macOS; siehe Tastenkürzel).
  3. Verwenden Sie in der Prompt-Warteschlange Jetzt einschieben, In Warteschlange verschieben, Prompt bearbeiten oder Prompt entfernen, solange der Eintrag noch wartet.
Zustellung Wirkung
Steuern Native steuernde Eingabe für die laufende Ausführung
Warteschlange Nativer Folgeprompt in der Warteschlange, zurückgehalten für spätere Verarbeitung

Im Ruhezustand verwendet normales Senden unabhängig von diesem Schalter den unmittelbaren Standardweg, und die Alternative in Weitere Aktionen ist nicht verfügbar. Bearbeiten stellt einen wartenden Prompt samt entfernbaren Anhängen im Eingabefeld wieder her; Bearbeitung abbrechen verlässt die Bearbeitung. Ein bereits von OpenCode verarbeiteter Prompt ist kein bearbeitbarer wartender Eintrag mehr. Das Entfernen eines Eintrags macht bereits ausgeführte Arbeit nicht rückgängig.

Schlägt eine Warteschlangenänderung fehl, prüfen Sie vor dem Wiederholen die aktuelle Warteschlange. Die Annahme beweist nicht, dass das Modell einen Folgeprompt bereits verarbeitet hat, und eine Wiederverbindung berechtigt nicht zum erneuten Senden.

Nebenfrage mit /btw stellen

  1. Senden Sie /btw your question in einer vorhandenen Unterhaltung oder /btw, um das Nebenfragefenster zu öffnen.
  2. Lesen Sie die Antwort, verwenden Sie Antwort kopieren oder wählen Sie während der Wartezeit Frage abbrechen.
  3. Schließen Sie das Fenster anschließend.

Dies ist eine separate Modellanfrage mit dem Sitzungskontext. Sie führt keine Werkzeugschleife und keine Aktionen aus und hängt Frage/Antwort nicht an die Unterhaltung an. Datei-/Bildanhänge bleiben im Eingabefeld; eingefügter Text in der Frage wird als Text einbezogen. Dies ist weder eine neue dauerhafte Unterhaltung noch ein alternativer Weg zur Arbeitsvergabe.

Schließen bricht die wartende Nebenanfrage ab, ohne die Hauptsitzung zu unterbrechen. Das Verlassen der aktiven Unterhaltung leert dieses flüchtige Fenster; kopieren Sie benötigte Inhalte vorher. Leere Antworten/Fehler erscheinen hier, nicht als Verlaufsnachrichten.

Abzweigen, rückgängig machen und Fehler beheben

  1. Wählen Sie an einer Nachricht Nach dieser Nachricht abzweigen (Fork), um nach diesem Punkt eine Unterhaltung anzulegen, ohne das Original zu ersetzen.
  2. Prüfen Sie zum Rückgängigmachen Änderungen bis hierhin rückgängig machen (löscht Nachrichten) sorgfältig. Die Palette bietet Letzte Nachricht rückgängig machen und Letzte Nachricht wiederherstellen für die vorgemerkte Rücknahme.
  3. Prüfen Sie bei fehlgeschlagener Ausführung vor erneutem Senden Sitzungsfehler, den Antwortfehler und gegebenenfalls Details unter Senden fehlgeschlagen.

Abzweigen kopiert den Unterhaltungskontext bis zum ausgewählten Punkt; es erzeugt keinen Git-Worktree und isoliert keine Dateien. Zurücksetzen ist nicht bloß Navigation. Prüfen Sie vor dem Fortfahren Dateiauswirkungen und Rücknahmegrenze; nutzen Sie einen Fork für eine alternative Diskussion ohne Umschreiben des ursprünglichen Verlaufs.

Ein Status Wiederholung mit Countdown bedeutet, dass OpenCode einen Anbieterfehler selbstständig erneut versucht; warten Sie darauf oder stoppen Sie die Sitzung, statt erneut zu senden. Ein fehlgeschlagenes Senden stellt den versuchten Entwurf und die Anhänge wieder her, sofern dadurch keine neueren Eingaben überschrieben werden. Ein fehlgeschlagener Lauf kann bereits Werkzeuge ausgeführt haben: Prüfen Sie vor dem Wiederholen Dateien, offene Anfragen und native Aktivität. Nachrichten neu laden oder Sitzung neu laden liest den Zustand; beides ist keine Anweisung, eine Änderung zu wiederholen. Sitzung stoppen unterbricht die Ausführung, macht aber keine Datei- oder externen Dienständerungen rückgängig.