1dabb5110f
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.
9.7 KiB
Dateien und Git
Der rechte Panel-Tab Dateien vereint das Durchsuchen von Checkouts, lokale Änderungen und Commit-Verlauf. Eine Zeile auszuwählen ist etwas anderes, als deren zentrale Leseansicht zu öffnen.
Checkout durchsuchen
- Öffnen Sie Dateien und wählen Sie Arbeitsbereich.
- Wählen Sie Worktree ansehen, wenn Sie einen anderen Checkout wünschen; klappen Sie Ordner nach Bedarf auf.
- Klicken Sie eine Dateizeile zur Auswahl an. Verwenden Sie deren Augenaktion, um die zentrale Vorschau zu öffnen oder zu schließen.
- Verwenden Sie Aktualisieren, wenn der sichtbare Schnappschuss erneut geprüft werden soll.
| Modus | Liest | Wirkung auf die Unterhaltung |
|---|---|---|
| Arbeitsbereich | Dateien im durchsuchten Checkout | Keine Sitzungsverschiebung und kein Branch-Checkout |
| Änderungen | Änderungen im Index und Arbeitsbaum | Git-Änderungen erfolgen nur über ausdrückliche Aktionen |
| Commits | Seitenweiser Commit-Verlauf und Revisionsinhalte | Schreibgeschützter Verlauf; kein Checkout |
Aufgeklappte Ordner bleiben bei Moduswechseln erhalten. Listen/Status/Verlauf verwenden zwischengespeicherte Schnappschüsse und prüfen sie nach relevanten Dateisystemänderungen, Aktivierung oder expliziter Aktualisierung erneut; das Fokussieren des Panels garantiert kein erneutes Lesen. Sichtbare Arbeitsbereichsordner übernehmen auf dem Backend-Host erstellte, bearbeitete, umbenannte oder gelöschte Dateien von selbst, bei andauernder Aktivität höchstens alle fünf Sekunden; eingeklappte Ordner und andere Worktrees werden erst erneut gelesen, wenn Sie sie anzeigen.
Zeilenaktionen umfassen Pfad kopieren und, soweit der Client Backend-Pfade öffnen kann, Dateimanager-/Editor-/Terminal-Aktionen wie Mit Standardanwendung öffnen, Im Ordner anzeigen, Im Dateimanager öffnen und Terminal hier öffnen. Bei wenig Platz können Aktionen unter Weitere Aktionen für {name} erscheinen; der Datei- oder Ordnername ersetzt {name}. Ein Remote-Browser darf einen Serverpfad nicht als lokalen Gerätepfad voraussetzen; siehe Fernsteuerung.
Quelltext bearbeiten und sicher speichern
- Öffnen Sie eine Textdatei im Arbeitsbereich mit ihrer Augenaktion.
- Wählen Sie für Markdown Quellcode anzeigen zum Bearbeiten oder Markdown-Vorschau zum Lesen der Darstellung.
- Bearbeiten Sie und wählen Sie Speichern oder drücken Sie Ctrl/Cmd+S, während der Editor fokussiert ist.
- Wurde die Datei extern geändert, prüfen Sie die Überschreibbestätigung; wählen Sie Abbrechen, um den Entwurf ohne Überschreiben dieser Änderung zu behalten.
Speichern schreibt die tatsächliche Datei im durchsuchten Checkout einschließlich eines verknüpften Worktrees; es sendet keinen Prompt und staged/committet die Änderung nicht. Vor dem Speichern wird die maßgebliche Datei erneut gelesen. Der Konfliktdialog lautet Die Datei wurde vom Agenten geändert. Die Änderungen des Agenten überschreiben?; behandeln Sie Änderungen jedes externen Schreibers mit derselben Sorgfalt.
Ungespeicherte Quelltextentwürfe bleiben beim Schließen oder Wechseln von Leseansichten im Renderer-Speicher nach Projektinstanz, Verzeichnis und Pfad erhalten. Dateisystemaktualisierungen ersetzen sie nicht stillschweigend. Dies ist kein dauerhafter Dateispeicher: Speichern oder kopieren Sie wichtige Änderungen vor einem Client-Neustart/Neuladen. Lese-/Schreibfehler behalten den Entwurf. Explizites Aktualisieren warnt vor dem Verwerfen ungespeicherter Änderungen.
Das Schließen der Leseansicht über die abschließende Schließen-Schaltfläche führt zur Unterhaltung zurück; das Eingabefeld bleibt darunter verfügbar. Ein Sitzungs-/Worktree-Wechsel leert die ausgewählte Leseansicht und garantiert kein Speichern ihres Entwurfs. Eine Browser-Vorschau ersetzt die Leseansicht; eine Datei zu öffnen setzt diese Ansicht auf Chat-Modus zurück.
Schreibgeschützte und begrenzte Vorschauen
- Öffnen Sie ein Bild, eine Binärdatei oder historische Änderung mit der Augenaktion.
- Verwenden Sie bei Diffs nach Bedarf Zur geteilten Ansicht wechseln / Zur einheitlichen Ansicht wechseln, Zeilenumbruch und die Steuerung unveränderter Bereiche.
- Schließen Sie die Leseansicht, um zum Chat zurückzukehren.
| Inhalt | Verfügbares Verhalten |
|---|---|
| Arbeitsbereichstext einschließlich Markdown-Quelltext | Mit explizitem Speichern bearbeitbar |
| Arbeitsbereichsbild | Schreibgeschützte Bildvorschau |
| Andere Binärinhalte | Schreibgeschützter Hinweis auf nicht verfügbare Vorschau |
| Text-Diff aus Änderungen/Commits | Schreibgeschützter Vergleich, kein Editor für eine der Seiten |
| Git-Bild-Diff | Vorher-/Nachher-Bilder aus exakt den verglichenen Revisionen |
Vorschaulesevorgänge sind begrenzt; große/nicht unterstützte Inhalte sind gegebenenfalls nicht verfügbar, statt unbegrenzt geladen zu werden. Für historische Bildvorschauen wird niemals ersatzweise die aktuelle Worktree-Datei verwendet. Ein Vorschaufehler bedeutet nicht, dass die zugrunde liegende Datei fehlt. Öffnen Sie die Datei gegebenenfalls mit einer geeigneten externen Anwendung, ohne nur für eine Vorschau ihre Revision zu ändern.
Stagen, Unstagen und Committen
- Wählen Sie Änderungen und prüfen Sie Gestagte Änderungen und Änderungen.
- Verwenden Sie Datei stagen / Datei unstagen, wählen Sie mehrere Zeilen für die entsprechende Auswahlaktion oder ziehen Sie Zeilen zwischen den Abschnitten.
- Geben Sie oben in Gestagte Änderungen eine Nachricht ein und wählen Sie Commit erstellen.
Eingeklappte Abschnittsköpfe bleiben Ablageziele. Einklappen oder Moduswechsel bewahren deren Zustand und den Commit-Nachrichtenentwurf. Ein langer Abschnitt zeigt seine ersten 200 Dateien, dann eine Zeile wie 480 Dateien nicht angezeigt mit 200 weitere anzeigen, um die nächsten an Ort und Stelle einzublenden; die Abschnittszähler bleiben vollständige Summen, und die aktuelle, in der Vorschau geöffnete und ausgewählte Dateien bleiben angezeigt. Umschalt-Klick-Bereiche umfassen nur angezeigte Zeilen, sodass eine Sammelaktion nie eine Datei einschließt, die Sie nicht sehen. Stagen/Unstagen ändert den Index im durchsuchten Worktree; Committen erfasst ausschließlich gestagte Inhalte. Unstagen verwirft die Änderung im Worktree nicht.
Prüfen Sie gestagte Dateien vor dem Commit, besonders wenn Agenten oder andere Clients dort ebenfalls schreiben. Ein fehlgeschlagener Commit wird nicht automatisch wiederholt. Aktualisieren Sie Status/Verlauf und prüfen Sie vor dem Wiederholen den Fehler, denn eine verlorene Antwort beweist nicht, dass kein Commit erstellt wurde.
Commit-Verlauf lesen
- Wählen Sie Commits und einen Commit, um dessen Nachricht und geänderte Dateien zu lesen.
- Verwenden Sie Geladene Commits filtern… für die geladene Menge oder Ältere Commits laden für eine weitere Seite.
- Öffnen Sie eine geänderte Datei mit ihrer Augenaktion.
Der Textverlauf vergleicht den Commit mit seinem ersten Eltern-Commit (oder einer leeren Basis beim Stamm-Commit). Er wechselt weder HEAD noch verschiebt er Sitzungen. Geladene Commits zu filtern ist keine serverweite Git-Log-Suche. Aktualisieren Sie nach neuen Commits, um vom aktuellen Verlauf auszugehen; vorhandene Seitennavigation behält ihren anfänglichen Verlaufsschnappschuss.
Leerraum und Zeilenenden
- Öffnen Sie Einstellungen → Erweitert → Reine Leerraumänderungen ausblenden.
- Deaktivieren Sie dies, wenn Sie nicht gestagte reine Leerraumänderungen prüfen müssen, die in Änderungen fehlen.
- Prüfen Sie vor dem Commit den tatsächlichen Diff und die gestagten Inhalte.
Die Einstellung ist standardmäßig aktiviert. Sie blendet hauptsächlich passende nicht gestagte Änderungen verfolgter Textdateien aus der Änderungsliste, Zählung, Auswahl, Sammel-Staging und Ziehaktionen aus. Ausgeblendete Dateien bleiben ungestagt. Gestagte Dateien bleiben sichtbar, ebenso nicht verfolgte, hinzugefügte/gelöschte/umbenannte und binäre Dateien. Fehlgeschlagene/nicht unterstützte Erkennung lässt Dateien sichtbar, statt zu raten.
Gits Listenerkennung kann inneren Leerraum, reine CRLF-Änderungen und hinzugefügte/entfernte abschließende Zeilenumbrüche ignorieren. Der Leerraumvergleich in der Diff-Leseansicht ist enger: Einrückung und abschließende Leerzeichen/Tabulatoren, nicht sämtlicher innerer Leerraum. Stagen und Committen arbeiten unabhängig von der Anzeigeeinstellung immer mit dem exakten Inhalt.
Unterschiede bei Zeilenenden und Byte-Order-Mark können statt hervorgehobener Zeilen einen sachlichen Hinweis erzeugen. Das Deaktivieren der Einstellung kann den Editor nicht dazu bringen, jede Zeilenende-/BOM-Änderung oder jeden gleich langen Austausch abschließenden Leerraums darzustellen. Ein optisch leerer Diff beweist keine identischen Bytes.
Git initialisieren
- Öffnen Sie Änderungen oder Commits in einem Ordner ohne Repository.
- Wählen Sie Git initialisieren; dies erfolgt sofort ohne Bestätigung.
- Warten Sie auf die Projekt-/Sitzungsaktualisierung und stagen/committen Sie anschließend ausdrücklich, wenn Sie bereit sind.
Die Initialisierung erstellt .git im ausdrücklich geöffneten Ordner; sie initialisiert kein übergeordnetes Verzeichnis und erstellt keinen ersten Commit. Fehlt Git im Backend, bleiben verzeichnisgebundene Unterhaltungen und das Durchsuchen des Arbeitsbereichs möglich, aber Initialisierung und Git-Vorgänge sind nicht verfügbar. Aktualisieren Sie bei ungewissem Fehler vor dem Wiederholen; keine Initialisierungsanfrage wird automatisch wiederholt. Siehe Projekte.