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.
8.7 KiB
Fragen und Berechtigungen
Native Fragen, Forms und Berechtigungsanfragen werden im Unterbrechungsdock direkt über dem Eingabefeld beantwortet, nicht in wartenden Werkzeugkarten im Verlauf.
Anfrage finden und Quelle prüfen
- Wählen Sie eine Unterhaltung mit Eingabe erforderlich / Berechtigung erforderlich oder klicken Sie auf das Projekt-Anfrageabzeichen, um das Dock an Ort und Stelle zu öffnen.
- Lesen Sie Anfrageart, Unterhaltungstitel und Herkunft vor dem Aufklappen oder Beantworten.
- Verwenden Sie bei mehreren wartenden Anfragen Vorherige Anfrage / Nächste Anfrage. Verwenden Sie Unterhaltung anzeigen nur, wenn Sie zur Quelle navigieren möchten.
| Herkunft | Bedeutung und Verhalten |
|---|---|
| Geöffnete Unterhaltung | Ihre Anfrage kann normal aufgeklappt werden |
| Subagent mit Aus …-Elternangabe | Rekursive Nachfahren der geöffneten Unterhaltung gehören zum lokalen Kontext; die Elternherkunft bleibt sichtbar |
| Andere Unterhaltung | Beginnt als kompakte Vorschau; ausdrücklich aufklappen, um ohne Verlassen der aktuellen Unterhaltung zu antworten |
| Projektanfrage / Dienstanfrage | Ein Form kann ohne zugehörige Unterhaltung sein; es wird kein erfundener Unterhaltungslink angezeigt |
Neue Eingänge ersetzen weder die bearbeitete Anfrage noch navigieren sie weg. Die Auswahl bleibt bei Warteschlangenaktualisierungen auf derselben Anfrage; Pfeile springen an den Enden nicht um. Nach Erledigung bleibt die Anfrage einer anderen, unabhängigen Unterhaltung kompakt, bis Sie sie öffnen.
Anfragen einklappen verbirgt den Inhalt; es verweigert, storniert oder beantwortet nichts. Ein aufgeklappter Editor verkleinert das Eingabefeld vorübergehend auf seine Mindesthöhe, ohne gespeicherte Größe oder Entwurf zu ändern. Sein Inhalt scrollt unabhängig von den festen Antwortaktionen.
Fragen und Forms beantworten
- Klappen Sie die gewünschte Anfrage auf und füllen Sie die Felder aus oder wählen Sie angebotene Antworten.
- Wenn ein Auswahlfeld eigene Antworten erlaubt, erscheint ein zusätzliches Textfeld: Geben Sie dort Ihre eigene Antwort statt einer angebotenen Auswahl ein (oder ergänzen Sie eigene Werte bei einem Mehrfachauswahlfeld). Beantworten Sie jede Pflichtfrage.
- Wählen Sie Absenden; verwenden Sie Abbrechen bei einer Frage oder einem Form nur, wenn Sie diesen nativen Abbruch beabsichtigen.
Teilantworten und Ablehnungsentwürfe überstehen Warteschlangenaktualisierungen und Unterhaltungsnavigation im laufenden Client. Sie sind keine übermittelte Entscheidung und garantieren keine Wiederherstellung nach dem Löschen von Client-Daten. Eine fehlgeschlagene Antwort bleibt bearbeitbar; prüfen Sie vor dem Wiederholen die wartende Anfrage. CodeNomad wiederholt Antworten nicht automatisch.
Einige Forms bieten Externes Formular öffnen für einen Browser-Ablauf. Folgen Sie den Anweisungen und kehren Sie zum Status zurück, statt eine geöffnete Seite als erfolgreiche Antwort zu betrachten. Beliebige Anbieter-/Authentifizierungs-Forms sind nicht zwangsläufig Unterhaltungsartefakte.
Abgeschlossene native Fragewerkzeuge zeigen Frage, ausgewählte Antwort, Optionsbeschreibungen und unveränderten eigenen Text im Verlauf. Andere Optionen hält nicht ausgewählte Alternativen verfügbar. Diese abgeschlossenen Ergebnisse sind vom aktiven Dock getrennt.
Berechtigung erlauben oder ablehnen
- Lesen Sie den angeforderten Vorgang, die Ressourcen und gegebenenfalls Angefordertes Diff. Prüfen Sie, welche Unterhaltung die Entscheidung erhält.
- Geben Sie optional eine Begründung für die Ablehnung oder eine sicherere Alternative ein.
- Wählen Sie Einmalig erlauben, Immer erlauben oder Ablehnen.
| Auswahl | Native Wirkung | Sicherheitsgrenze |
|---|---|---|
| Einmalig erlauben | Genehmigt diese Berechtigungsanfrage | Keine pauschale Genehmigung unabhängiger zukünftiger Vorgänge |
| Immer erlauben | Sendet die native dauerhafte Genehmigung für passende Anfragen im geltenden Sitzungskontext | Kein CodeNomad- oder betriebssystemweiter Vertrauensschalter; prüfen Sie die autorisierte Ressource/das Muster |
| Ablehnen | Verweigert die Anfrage mit optionalem Feedback | Macht vor dieser Anfrage ausgeführte Arbeit nicht rückgängig |
Eine Genehmigung kann die Werkzeugausführung sofort freigeben. Dies ist kein Probelauf. Diff-/Lesegrenzen und Quellenidentitätsprüfungen können Genehmigungen verhindern, wenn der angeforderte Inhalt nicht validiert werden kann; aktualisieren und prüfen Sie die tatsächliche Anfrage, statt aufgrund einer Annahme einen anderen Vorgang zu erlauben.
Erledigt ein anderer Client eine Anfrage, kann sie hier verschwinden. Ein Timeout oder eine fehlgeschlagene Antwort beweist nicht, ob der native Dienst die Entscheidung angenommen hat: Lassen Sie den Abgleich offener Anfragen das Dock aktualisieren, bevor Sie erneut bewusst entscheiden. Eine mehrdeutige Antwort wird niemals als erfundene bestätigte Entscheidung dargestellt.
Berechtigungsbelege lesen
- Suchen Sie Berechtigungsentscheidungen neben dem zugehörigen Verlaufsinhalt, auch bei ausgeblendeten nativen Werkzeugkarten.
- Öffnen Sie für Entscheidungen ohne Quellnachricht Berechtigungsentscheidungen der Sitzung.
- Verwenden Sie Weitere Entscheidungen laden zum Fortfahren oder Erneut versuchen nach einem Lesefehler.
Belege erfassen bekannte Anfragen/Ressourcen, die bestätigte Entscheidung sowie verfügbare Begründung/Herkunft. Entscheidung in CodeNomad, Automatisch · Yolo und Native Entscheidung unterscheiden beobachtete Ursprünge; eine native Erledigung beweist keinen Benutzerklick in diesem Fenster.
Belege sind schreibgeschützte CodeNomad-Anmerkungen, keine nativen Nachrichten oder Berechtigungsregel-Editoren. Sie sind von nativer Vollverlaufssuche, Nachrichtenkopie und Export ausgeschlossen. Sie können während CodeNomads Offline-Zeit verpasste Entscheidungen nicht rekonstruieren; ein erfolgreiches Werkzeugergebnis ersetzt keinen fehlenden Beleg. Eine Sitzungslöschung entfernt deren Belege.
Yolo-Modus und Familienumfang
- Wählen Sie eine Unterhaltung und öffnen Sie Status → Yolo-Modus.
- Aktivieren Sie ihn nur, wenn automatische Berechtigungsfreigaben für die gesamte Familie akzeptabel sind.
- Deaktivieren Sie ihn vor weiterer nicht vertrauenswürdiger Arbeit; prüfen Sie offene Anfragen und bereits laufende Werkzeuge.
Obwohl die Steuerung eine Sitzung nennt, gilt sie effektiv für die ermittelte Familienwurzel und Nachfahren: Aktivieren/Deaktivieren von einem Kind aus betrifft diese Familie. Ein nativer Fork gilt als eigene Wurzel. Dies ist keine globale Genehmigung für alle Projekte oder unabhängigen Unterhaltungen.
Yolo genehmigt nur Berechtigungen. Es beantwortet keine Fragen oder Forms, ergänzt keine fehlenden Angaben, garantiert keinen Ausführungserfolg und umgeht keine Backend-Zugehörigkeitsprüfungen. Das CodeNomad-Backend führt die automatische Genehmigung durch: Ein einzelnes Fenster zu schließen deaktiviert sie nicht, solange das Backend aktiv bleibt; ein gestopptes Backend kann keine Anfragen weiter genehmigen. Die Familieneinstellung wird gespeichert und beim erneuten Laden des Arbeitsbereichs wieder eingelesen.
Yolo auszuschalten widerruft keine bereits angenommene Entscheidung und macht keine Datei-/Netzwerkauswirkungen rückgängig. Prüfen Sie Automatisch · Yolo-Belege und stoppen Sie die Ausführung bei Bedarf ausdrücklich. Für Automatisierung mit menschlichen Freigaben siehe Missionen.
Fehlende oder veraltete Anfragen wiederherstellen
- Prüfen Sie die Verbindungsanzeige und verbinden Sie sich erneut mit demselben Backend/Projekt.
- Lassen Sie die Wiederherstellung offene native Anfragen abgleichen; bekannte Anfragen und Entwürfe bleiben bei unvollständiger Abdeckung erhalten.
- Erscheint die Warnung Fragen und Berechtigungen nicht vollständig wiederhergestellt, nennt sie das Projekt, die Ursache, die Ordner und die betroffenen Sitzungen. Beheben Sie diese Ursache (zum Beispiel ein gelöschter Worktree oder eine Sitzung, die außerhalb dieses Projekts arbeitet); der nächste Wiederherstellungsdurchlauf versucht es automatisch erneut.
Die Wiederherstellung lädt nicht jeden inaktiven Worktree, nur um Anfragen aufzulisten. Eine unvollständige Antwort ist keine maßgebliche leere Warteschlange, und die Warnung erlaubt keine Wiederholung eines Prompts, einer Antwort oder Freigabe. Konfigurationsneuladen kann native Forms/Berechtigungen abbrechen; verwenden Sie es nicht als routinemäßige Anfrageaktualisierung. Siehe Fehlerbehebung und OpenCode-Einrichtung.