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 KiB
Fernsteuerung
Fernsteuerung ermöglicht einem gekoppelten Browser- oder Desktop-Client die Nutzung Ihres laufenden CodeNomad-Backends ohne eingehenden Netzwerkport. Sie benötigt weder Serverpasswort, ein nicht an Loopback gebundenes --host noch VPN. Dies ist ein separater Zugriffsweg gegenüber direkten Verbindungen.
Starten und koppeln
- Öffnen Sie auf dem Host Einstellungen → Remote-Zugriff.
- Wählen Sie Fernsteuerung starten. Warten Sie auf Bereit für Remote-Verbindungen; erstmalige Bereitstellung von Tunnelidentität und Zertifikat kann dauern.
- Scannen Sie unter Weiteres Gerät verbinden den QR-Code oder wählen Sie Link kopieren und öffnen Sie diesen Einmallink auf dem vorgesehenen Gerät.
- Behalten Sie die Websitedaten des gekoppelten Browsers. Öffnen Sie die Tunneladresse erneut zur Wiederverbindung, solange das Backend läuft.
Der Link gilt fünf Minuten und funktioniert einmal. Behandeln Sie ihn als Zugangsdaten: Wer ihn einlöst, kann ein gekoppeltes Gerät werden. Der Code steht im URL-Fragment, nicht in der Abfragezeichenfolge. Neuen Kopplungslink erstellen macht den vorherigen ungenutzten Link sofort ungültig. Stop, Backend-Ende und Tunnelfehler stornieren offene Kopplungslinks.
Um einen weiteren CodeNomad-Desktop zu koppeln, wählen Sie auf dessen Startseite CodeNomad-Server verbinden, fügen den Link in Server-URL ein und wählen Verbinden. Ein Kopplungslink öffnet sein Fenster auch über Speichern, weil das Öffnen den Code einlöst. Nur die Tunnel-Origin wird als Lesezeichen gespeichert; der Code bleibt nicht erhalten. TLS-Prüfung bleibt für Kopplungslinks aktiviert.
Gekoppelte Geräte verwalten
- Kehren Sie auf dem Host zu Einstellungen → Remote-Zugriff → Fernsteuerung zurück.
- Prüfen Sie Gekoppelte Geräte und deren Zuletzt gesehen:-Zeit. Jedes Gerät ist nach der Plattform und dem Browser benannt, die es gekoppelt haben, etwa
iPhone · Safari. - Wählen Sie Widerrufen für ein Gerät, das nicht länger zugreifen soll.
Widerruf beendet aktuelle HTTP-/SSE-Verbindungen des Geräts sowie zukünftigen Zugriff. Koppeln Sie zum Wiederherstellen mit einem neuen Link. Ein Gerät verfällt nach 30 Tagen ohne Nutzung. Bei der Grenze von 32 Geräten ersetzt eine neue Kopplung das am längsten nicht gesehene Gerät und schließt dessen Verbindungen.
Das Backend speichert Zugangsdaten-Hashes, keine Rohzugangsdaten, in remote-control-devices.json unter seiner Konfigurationsbasis. Der Client hält ein hostbezogenes Geräte-Cookie mit Secure, HttpOnly, SameSite=Lax. Dessen Browserlebensdauer kann die serverseitige 30-Tage-Inaktivitätsgrenze übersteigen; maßgeblich bleibt das Register. Websitedaten löschen, Browserprofile wechseln oder privates Surfen kann erneute Kopplung erfordern.
Eine Änderung des Direktzugriffspassworts widerruft Geräte nicht. Fernsteuerung beenden trennt den Tunnel, behält aber die Geräteliste; verwenden Sie Widerrufen, um die Berechtigung zu entfernen.
Ohne Positionsverlust erneut koppeln
- Zeigt der Client Dieses Gerät erneut koppeln, lassen Sie diese Seite offen.
- Wählen Sie auf dem Host Neuen Kopplungslink erstellen und öffnen Sie ihn im selben Client-Browser/-Profil. Verbinden Sie bei gespeichertem Desktop-Server mit dem frischen Link neu, damit der vorhandene Remote-Fensterspeicher wiederverwendet wird.
- Kehren Sie zur wartenden Seite zurück und wählen Sie Verbindung prüfen; sie prüft auch erneut, wenn die Seite wieder den Fokus erhält.
Die Wiederherstellung bewahrt die geöffnete Seite und Entwürfe; sie wiederholt keine fehlgeschlagene Aktion. Prüfen Sie vor Wiederholung, ob Senden, Antworten oder Löschen wirksam war. Ein Direktzugriffspasswort kann die Fernsteuerungskopplung nicht wiederherstellen.
Verfügbarkeit und Lebensdauer
| Aktion/Zustand | Wirkung |
|---|---|
| Fernsteuerung starten | Verbindet dieses Backend und merkt die Auswahl für künftige Starts. |
| Remote-Browser schließen | Stoppt weder Host-Backend noch widerruft es das Gerät. |
| Fernsteuerung beenden | Trennt den Zugriff und löscht automatisches Fortsetzen beim Start; behält Gerätedatensätze. |
| Backend-Ende / letztes Desktop-Fenster schließt und App endet | Fernsteuerung geht offline. OpenCodes gemeinsamer Dienst kann weiterlaufen, kann diese Oberfläche aber nicht durch ein gestopptes Backend bereitstellen. |
| Start nach aktiviert gelassener Fernsteuerung | Verbindet im Hintergrund ohne neuen Kopplungslink. Niemals gestartete Installationen aktivieren sich nicht selbst. |
| Fehlgeschlagenes Fortsetzen oder schwerer Tunnelfehler | Gemerkte Auswahl bleibt und der Host zeigt den Fehler; das Aktualisieren-Symbol der Fernsteuerungskarte liest ihren Zustand erneut. Fernsteuerung starten versucht es sofort erneut; Fernsteuerung beenden löscht die Auswahl. Andernfalls versucht es ein späterer Start erneut. |
Automatisches Fortsetzen beim Start ist auf ein Backend pro Konfigurationsverzeichnis begrenzt. Starten Sie keine konkurrierenden Hosts mit gleicher Konfiguration für zusätzliche Tunnelkapazität. Soll ein Host nach Desktop-Ende erreichbar bleiben, betreiben Sie einen separat verwalteten eigenständigen Server; Fernsteuerung ist kein unabhängiger Daemon.
Verfügbare und nicht verfügbare Oberflächen
Gekoppelte Geräte können normale Projekt-/Unterhaltungs-APIs verwenden, Prompts senden, Dateien prüfen und Berechtigungen/Forms unter denselben Zugehörigkeitsprüfungen beantworten. Kopplung ist mächtiger Zugriff, kein schreibgeschützter Freigabelink. Sie gewährt niemals Loopback-Rechte, auch wenn der Tunnel intern auf dem Host weiterleitet.
| Oberfläche | Über Fernsteuerung |
|---|---|
| Normale authentifizierte Oberfläche, Arbeitsbereiche, Unterhaltungen und SSE | Für gekoppelte Geräte verfügbar. |
| Passwortanmeldung/-abmeldung, Passwortänderungen, lokale Token-Ersteinrichtung | Nicht verfügbar; Gerätezugangsdaten sind auch bei deaktivierter direkter Authentifizierung nötig. |
| Fernsteuerungsstatus | Für gekoppelte Geräte lesbar; Verwaltung nicht verfügbar. Start/Stop, Kopplungserstellung, Geräteliste und Widerruf bleiben auf dem Host-Zugriffsweg. |
| Desktop-Remote-Fenster-/Serververwaltung und Proxy-Routen | Nicht verfügbar (/api/remote-servers/, /api/remote-proxy/). |
| SideCar-Inhaltsproxy | Nicht verfügbar (/sidecars/). Dies bedeutet nicht, dass alle SideCar-APIs blockiert sind: Gekoppelte Clients können weiterhin die Registrierungs-APIs /api/sidecars nutzen. |
| Vorschauinhalt und Automatisierungsbrücke | Nicht verfügbar (/previews/, /api/opencode-plugin/). Native Desktop-Fähigkeiten werden nicht zu Browserfähigkeiten. |
| WebSocket-Upgrades | Am Fernsteuerungseingang nicht verfügbar. |
Verwenden Sie eine entsprechend geschützte Direktverbindung, wenn ein Ablauf eine blockierte Proxy-/WebSocket-Oberfläche benötigt. Fernsteuerung wechselt nicht automatisch dorthin.
Relay und Datenschutz
CodeNomad verwendet OpenTunnel und beansprucht eine zufällige Route auf der gemeinsamen Standard-Tunnelidentität des Rechners. Stoppen gibt CodeNomads Brücke frei, nicht die von anderen Anwendungen verwendete gemeinsame Identität.
TLS endet im CodeNomad-Backend. Das Relay leitet Chiffretext weiter und kann Anwendungsinhalte nicht lesen, aber Hostnamen, Verbindungszeiten und Datenmengen beobachten. Tunnelzertifikat und privater Schlüssel bleiben auf dem Host. Schützen Sie Tunnelspeicher und CodeNomad-Konfiguration des Hosts wie Zugangsdaten; eine nicht erratbare Adresse ist keine Autorisierung.
CODENOMAD_REMOTE_CONTROL_API wählt eine selbst gehostete OpenTunnel-API; ohne Wert gilt der gehostete Dienst. Dies ändert die Tunnelbereitstellung, nicht Kopplungsanforderungen oder blockierte Oberflächen. Zum Umgang mit Zugangsdaten und Diagnosen siehe Sicherheit.