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.
5.6 KiB
Mobil und PWA
Verwenden Sie die Browseroberfläche auf Telefon oder Tablet, um Arbeit auf dem Backend-Host fortzusetzen. Die PWA-Installation ändert, wie die Oberfläche geöffnet wird, nicht den Ort von Projekten, Zugangsdaten oder Agentenausführung.
Mit Telefon oder Tablet verbinden
- Öffnen Sie auf dem Host Einstellungen → Remote-Zugriff → Fernsteuerung und wählen Sie Fernsteuerung starten.
- Scannen Sie den Kopplungs-QR-Code mit Ihrem Mobilgerät und öffnen Sie den Link im Browser, den Sie weiterverwenden möchten.
- Alternativ konfigurieren Sie Direktzugriff, öffnen die erreichbare vertrauenswürdige HTTPS-URL des Hosts und melden sich mit dessen Serverpasswort an.
Fernsteuerung erfordert Gerätekopplung; Direktverbindungen benötigen Routing, erreichbaren Listener und Authentifizierung. Verwenden Sie auf dem Telefon nicht localhost, um Ihren Arbeitsplatzrechner zu erreichen. Verlust von Websitedaten oder Profilwechsel kann erneute Anmeldung/Kopplung erfordern; siehe Fernsteuerung.
PWA installieren
- Öffnen Sie die funktionierende CodeNomad-URL über vertrauenswürdiges HTTPS in einem Browser mit Installationsunterstützung.
- Verwenden Sie in Chrome/Edge und ähnlichen Browsern die Installationsaktion in der Adressleiste oder die angebotene Browseraktion Install CodeNomad. Verwenden Sie auf iPhone/iPad in Safari Share → Add to Home Screen; der genaue Wortlaut hängt von OS/Browser ab.
- Öffnen Sie den neuen Starter und schließen Sie dort Anmeldung/Kopplung ab, falls dessen Browserspeicher separat ist.
Installation gilt pro Gerät/Browser und Origin. Sie installiert weder Node, Git noch OpenCode auf dem Telefon, startet kein Backend und gewährt keine nativen Desktop-Integrationen. Das Entfernen des Starters löscht keine Host-Unterhaltungen; widerrufen Sie beim Entzug des Zugriffs ein gekoppeltes Gerät separat.
Sicherer Kontext und Zertifikate
Entfernte PWA-Installation und Mikrofonzugriff benötigen einen vom Browser anerkannten sicheren Kontext. Verwenden Sie ein vertrauenswürdiges HTTPS-Zertifikat für exakt den Hostnamen/die IP. Ein erzeugtes lokales Zertifikat muss vom Client-Gerät/Browser ausdrücklich als vertrauenswürdig eingestuft werden; Warnseite oder Umgehung sind keine zuverlässige Installationseinrichtung. Browserausnahmen für localhost gelten für dieses Gerät, nicht für eine HTTP-LAN-Adresse eines anderen Hosts.
Fehlt die Installation, prüfen Sie zuerst HTTPS-Vertrauen und Browserunterstützung und öffnen Sie dann die Seite im vollständigen Browser statt im eingebetteten QR-/In-App-Browser. Prüfen Sie bei Mikrofonfehlern Browser-/OS-Websiteberechtigungen und Sprache. Deaktivieren Sie zur Installationsreparatur weder Authentifizierung noch TLS-Prüfung.
Touch-Layouts nutzen
Öffnen Sie Navigation und Werkzeuge über Linke Seitenleiste und Rechte Seitenleiste. In schmalen Layouts überlagern Panels die Unterhaltung, statt eine Desktop-breite Fläche zu erzwingen; ein schwebendes Panel zu öffnen schließt das andere. Aktionen im Unterhaltungskopf wandern bei Platzmangel ins Überlaufmenü.
Das Eingabefeld behält Agent, Modell und Denken in der Fußzeile. Seine Größe folgt der sichtbaren Unterhaltung einschließlich Bildschirmtastatur; lange Entwürfe bleiben scrollbar. Auf reinen Touch-Geräten öffnet Senden die Bildschirmtastatur nicht erneut, damit Sie die Antwort lesen können; tippen Sie zum Fortfahren auf das Eingabefeld. Während eine Sitzung läuft, bietet das Menü Weitere Aktionen des Eingabefelds Nachricht einreihen oder Jetzt einschieben an, je nachdem, was Ihr normales Senden nicht tut, ohne ein Tastenkürzel einer Hardwaretastatur zu benötigen. Eine Unterbrechung verkleinert das Eingabefeld vorübergehend, ohne gespeicherte Höhe oder Entwurf zu ändern. Beantworten Sie Berechtigungen/Fragen im Dock darüber und halten Sie dessen Aktionsfußzeile erreichbar. Siehe Unterhaltungen und Berechtigungen.
Fähigkeits- und Verbindungsgrenzen
| Funktion | Mobiler Browser / PWA |
|---|---|
| Projekte, Unterhaltungen, Dateien und Berechtigungen | Arbeiten auf dem verbundenen Backend-Host unter dessen Zugriffskontrollen. Geräteanhänge werden vom Telefon hochgeladen; Projektreferenzen auf dem Host aufgelöst. |
| Native Desktop-Fenster, OS-Menüs und hostnative Automatisierung | Werden nicht durch PWA-Installation bereitgestellt. |
| Browser-Vorschau | Erhält keine nativen Gastbrowserfähigkeiten; Ersatzdarstellung bleibt browserbegrenzt. |
| SideCar-Inhalte und WebSockets | Hängen vom Verbindungsweg ab; Fernsteuerung blockiert SideCar-Inhaltsproxy, Vorschauinhalte und WebSocket-Upgrades. Siehe deren genaue Einschränkungen. |
| Mikrofon, Zwischenablage, Benachrichtigungen und Installationsaufforderung | Hängen von Browser-/OS-Unterstützung, sicherem Kontext und Benutzerrechten ab. |
| Offline-Arbeit | Kein Offline-Backend und kein zwischengespeicherter API-Verlauf. Statische Oberflächendateien können im Cache liegen, Dokumente und API-Antworten sind aber kein Offline-Arbeitsbereich. |
Halten Sie das Backend erreichbar. Mobile OS-Suspendierung oder Netzwerkwechsel kann den Ereignisstrom trennen; Rückkehr verbindet neu und liest aktuellen Zustand ohne garantierte Ereigniswiederholung. Prüfen Sie vor Wiederholung, ob eine Aktion abgeschlossen wurde. PWA-Schließen stoppt kein eigenständiges Backend; das Beenden der Host-Desktop-App samt Backend macht Fernsteuerung bis zum nächsten Start unverfügbar.