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.
7.5 KiB
Native Integrationen
CodeNomad stellt OpenCodes native MCP-Verbindungen, Plugin-Aktivierung, Skills und benutzerdefinierte Befehle bereit. Sie laufen auf dem Ausführungshost. Sie sind getrennt von Panel-Erweiterungen in der Sandbox und SideCars.
Passende Steuerung wählen
| Integration | Wo handeln | Was die Steuerung ändert |
|---|---|---|
| MCP-Server | Status → MCP-Server | Native Verbindung an der angezeigten Location; installiert keinen Server. |
| Natives Plugin | Status → Plugins | Dauerhafte Aktivierungsregel Global oder Projekt; bei einem Paket-Plugin eine ausdrückliche Prüfung oder Aktualisierung dieses Pakets. Installiert oder entfernt keine Pakete. |
| Skill | @-Menü im Eingabefeld |
Expliziter Anhang an den nächsten Prompt in der Location der Unterhaltung. |
| Benutzerdefinierter Befehl | /-Menü im Eingabefeld |
Führt einen von OpenCode für diese Location angebotenen Befehl aus. |
Konfigurieren/installieren Sie die Integration zuerst mit OpenCodes unterstützter Konfiguration und CLI. Paketinstallation, Quelldeklaration, Regelaktivierung, Dienstverbindung und Werkzeugverfügbarkeit sind getrennte Schritte. Native Integrationen haben die Rechte ihres Hostprozesses unter OpenCodes Berechtigungen; sie sind keine HTML-Panels in einer Sandbox.
MCP verbinden oder trennen
- Konfigurieren Sie den MCP-Server auf dem OpenCode-Ausführungshost gemäß der OpenCode-MCP-Dokumentation.
- Öffnen Sie Status → MCP-Server für das Projekt.
- Verwenden Sie den Schalter neben dem Server zum Verbinden/Trennen. Warten Sie, bis sich die Verbindungsanzeige stabilisiert.
Der Schalter ruft die native Verbindungs-API für die gemeldete Location auf, kein gerätelokales Installationsprogramm und keine fensterbezogene Sichtbarkeitseinstellung. Andere Clients dieser Location können die Verbindungsänderung beobachten. Trennen entfernt weder die Serverdeklaration noch deinstalliert es dessen Programmdatei.
Erscheint kein Server, prüfen Sie aktive Location und native Konfiguration. Prüfen Sie bei Verbindungsfehlern Serverkonfiguration, erforderliche Umgebung und nativen Authentifizierungsablauf; nehmen Sie nicht an, dass der Schalter OAuth abschließt. Prüfen Sie nach dem Wiederverbinden den Status erneut. Verwenden Sie explizites Konfigurationsneuladen nur bei Bedarf und beachten Sie die Unterbrechungen unter OpenCode-Einrichtung.
Plugins global oder projektbezogen aktivieren
- Installieren/deklarieren Sie das native Plugin mit OpenCode; öffnen Sie dann Status → Plugins.
- Zeigen Sie auf den Namen oder fokussieren Sie ihn, um Quelle, Laufzeitfehler und Konfigurationszieldetails zu prüfen.
- Schalten Sie Global oder Projekt bewusst um. Warten Sie den Schreibvorgang ab und verwenden Sie bei unklarem Zustand Plugin-Steuerung aktualisieren.
- Verwenden Sie bei einem aus einem Paket installierten Plugin das Symbol neben seinem Namen. Sein Menü nennt den genauen Vorgang: Updates für … prüfen für das Paket oder … aktualisieren, sobald eine neuere Version gefunden wurde.
Global zielt auf die gefundene globale Konfiguration des verbundenen Daemons. Projekt zielt auf die Konfiguration innerhalb der aktiven Location, nicht auf eine geerbte übergeordnete Datei. Eine spätere Projektregel kann Global übersteuern; der globale Schalter zeigt weiterhin die globale Regel, statt den endgültigen Projektzustand vorzutäuschen. Ohne Projektregel erbt Projekt den aufgelösten globalen Zustand.
Diese Schalter ergänzen exakte Aktivierungsregeln und bewahren Quelldeklarationen sowie unabhängige Konfiguration. Sie bearbeiten keine Plugin-Optionen, installieren keine Pakete und entfernen keine Dateien. Integrierte OpenCode-Plugins werden nicht als Benutzeraktivierungsschalter angeboten. Projekt ist deaktiviert, wenn sein Ziel nicht sicher von Global getrennt werden kann oder die aktive Location verlassen würde.
Eine Paketaktualisierung ändert dieses Paket im gemeinsamen Cache von OpenCode für jede Location, die es verwendet, wie sein Tooltip angibt; sie ändert keine Aktivierungsregeln, startet OpenCode nicht neu und lädt keine Konfiguration neu. Lokale, integrierte und vom SDK bereitgestellte Plugins haben keine Paketaktion. Ein Paket, das vor dem Melden seiner Plugin-ID scheitert, wird unter seinem Paketnamen aufgeführt, mit dem Fehler in seinem Tooltip und Prüf-/Aktualisierungsaktionen, aber ohne Aktivierungsschalter. Eine fehlgeschlagene Prüfung oder Aktualisierung wird gemeldet und nie automatisch wiederholt.
Die Oberfläche behält im verborgenen Zustand ihren letzten Schnappschuss und prüft beim Anzeigen, nach nativen Änderungen/Wiederverbindung und expliziter Aktualisierung erneut. Gespeicherte Regel und aktuelle Laufzeitverfügbarkeit können kurzzeitig abweichen. Bleibt ein Plugin nicht verfügbar, prüfen Sie Tooltip und native Konfiguration vor OpenCode-Konfiguration neu laden; dies betrifft alle geladenen Locations, nicht nur dieses Plugin. Fehlerhafte Konfiguration oder gleichzeitige Bearbeitung wird nicht stillschweigend überschrieben: Beheben Sie das Problem, aktualisieren Sie und wiederholen Sie ausdrücklich.
Skills anhängen
- Geben Sie im Eingabefeld
@ein, durchsuchen Sie die verfügbaren Skills der Location und wählen Sie einen. - Prüfen Sie dessen entfernbaren Anhang neben Dateien/Agenten; entfernen Sie ihn vor dem Senden, falls unbeabsichtigt.
- Senden Sie den Prompt. Skill-Bezeichnungen bleiben an der gesendeten Nachricht.
Die Auswahl hängt die native Skill-ID an und entfernt das @query-Token; sie fügt die Anweisungen nicht in den sichtbaren Entwurf ein. Senden leert die Auswahl im Eingabefeld, nicht die bereits von OpenCode mit dieser Nachricht gespeicherten Anweisungen. Ein Anhang zu entfernen macht kein früheres Senden rückgängig.
Die Skill-Verfügbarkeit kommt aus der Location der Unterhaltung, nicht aus einem globalen CodeNomad-Skill-Katalog. Kann die Liste nicht laden, schließen und öffnen Sie die Auswahl erneut; ist sie leer, prüfen Sie native Suche/Konfiguration. Siehe OpenCode-Skill-Dokumentation und Unterhaltungen.
Benutzerdefinierte Befehle ausführen
- Geben Sie
/im Eingabefeld ein und wählen Sie einen verfügbaren nativen Befehl. - Geben Sie Argumente an und prüfen Sie vor dem Absenden je nach Befehl Agent, Modell und Denken.
- Prüfen Sie bei unklarer Bestätigung die entstandene Unterhaltung, statt wiederholt abzusenden.
Befehle werden von OpenCode für die aktive Location ermittelt. Ihre eigene native Definition kann das Ausführungsverhalten bestimmen; das Menü ist weder Paketinstallation noch uneingeschränkter Konfigurationseditor. CodeNomad wendet vor nativen benutzerdefinierten Befehlen die Sitzungsumgebung des Profils an; ein fehlgeschlagenes Umgebungsupdate blockiert das Senden. /btw ist CodeNomads separater flüchtiger Frageablauf, kein normaler benutzerdefinierter Befehl.
Befehlsdefinitionen und native Konfigurationsvererbung erläutert die OpenCode-Befehlsdokumentation. Aktualisieren/öffnen Sie nach Konfigurationsänderungen zuerst die relevante Oberfläche erneut; verwenden Sie explizites Konfigurationsneuladen nur, wenn die Laufzeit es noch benötigt. Wiederholen Sie niemals einen möglicherweise angenommenen Befehl allein zum Aktualisieren seiner Anzeige.