Fehlerbehebung und häufige Fragen — Noea Code Dokumentation

Beginnen Sie mit der Meldung zur fehlgeschlagenen Aktion und prüfen Sie dann Projekt-, Agent- und Aufgabenstatus. Die folgenden Abschnitte zeigen Anlaufstellen für häufige Probleme.

Die Einrichtung lässt Sie nicht in den Arbeitsbereich

Für den Einstieg muss mindestens ein Agent installiert, angemeldet und geprüft sein. Installation allein oder das Schließen des Anmeldefensters genügt nicht: Die Liste muss Bereit anzeigen.

Öffnen Sie die Details dieses Agenten, beheben Sie Anmelde-, Netzwerk- oder Prüfprobleme und prüfen Sie erneut. Siehe Installieren und vorbereiten.

Ein Download scheitert oder bleibt in Vorbereitung

Prüfen Sie zuerst Netzwerk und HTTP(S)-Proxy des Systems. Proxy-Umgebungsvariablen haben Vorrang; SOCKS-Proxys werden von diesem Mechanismus nicht unterstützt. Bei ausbleibenden Downloaddaten kann ein Vorbereitungsstatus erscheinen. Beobachten Sie Aktualisierungen und versuchen Sie es erneut, falls ein Fehler gemeldet wird.

Treten Fehler wiederholt auf, kopieren Sie die Agent-Diagnose und notieren Sie, ob das Problem beim Laden der Laufzeitumgebung, Installieren des Agenten oder Prüfen der Verbindung auftrat.

Anmeldung erfolgreich, Agent trotzdem nicht verfügbar

Noea beurteilt die Bereitschaft anhand der Prüfergebnisse. Kontrollieren Sie Konto oder Anbieter, verfügbares Kontingent und Modellkonfiguration. Aktualisieren Sie bei OpenCode die Anbieterliste, bestätigen Sie die Verbindung und prüfen Sie erneut.

Erfordert die Modellauswahl zunächst eine Verbindung, verbinden Sie eine Sitzung und prüfen Sie dann erneut. Eine von einem Agenten unterstützte Einstellung wird nicht automatisch von einem anderen unterstützt.

Ein Projekt öffnet sich nicht

Situation	Vorgehen
Der gewählte Ordner ist kein Noea-Projekt.	Für Code „Implementierungsordner öffnen“ verwenden; für ein bestehendes Projekt dessen tatsächlichen Projektordner wählen.
Der Projektordner wurde verschoben.	Seinen aktuellen Ort über „Vorhandenes Noea-Projekt öffnen“ wählen.
Der Projektordner wurde gelöscht.	Vor dem Öffnen aus Papierkorb oder Sicherung wiederherstellen.
Die Konfiguration ist ungültig.	Originalinhalt erhalten. Konfiguration prüfen oder Diagnose senden; nicht durch erneutes Initialisieren überschreiben.
Eine neuere App-Version hat die Daten geschrieben.	App aktualisieren und erneut öffnen.
Die Datenversion ist inkompatibel.	Kopien von Projekt- und App-Daten behalten und der konkreten Meldung folgen. Inkompatible Daten nicht überschreiben.

Absichten sind lesbar, aber Chats starten nicht

Prüfen Sie den Implementierungsordner unter Einstellungen → Aktuelles Projekt → Projekt. Verknüpfen Sie einen, wenn keiner verknüpft ist, oder ordnen Sie den ursprünglichen Codeordner neu zu, wenn sein alter Pfad nicht erreichbar ist.

Prüfen Sie außerdem, ob der Agent bereit ist. Lesbare Absichtsdateien bedeuten nicht, dass auch Implementierungsordner und Agent bereit sind.

Eine Erläuterung fehlt oder scheint falsch

Sichern Sie die Absicht, untersuchen Sie dann den betreffenden Absatz oder starten Sie Erläutern in der Seitenleiste. Benötigt die Anforderung Codeänderungen, implementieren Sie diese vor der Untersuchung im Chat.

Vorheriger Text bezieht sich auf die Absicht vor einer Bearbeitung. Möglicherweise veraltet bedeutet, dass Nachweisdateien später geändert wurden. Prüfen Sie beides anhand des aktuellen Inhalts erneut; siehe Erläuterungen aktuell halten.

Keine Änderungen gefunden in der Seitenleiste bedeutet nicht, dass alle Tests bestanden sind oder keine Lücken bleiben.

„Erläutern“ startet nach der Implementierung nicht

Prüfen Sie Einstellungen → Aktuelles Projekt → Automatisierung → Nach dem Implementieren automatisch erläutern. Reine Codeänderungen in normalen Chats, „Direkt implementieren“ sowie fehlgeschlagene oder gestoppte Implementierungen lösen es nicht aus.

Starten Sie „Erläutern“ bei Bedarf manuell. Ist eine Aufgabe beendet, meldet aber noch fehlgeschlagene oder unvollständige Prüfungen, öffnen Sie die Ergebnisse, beheben die Ursache und starten erneut. Siehe alle Regeln für automatische Auslöser.

Ein Vorschlag oder Neuordnungsplan lässt sich nicht annehmen

Meldet ein Vorschlag ein geändertes Dokument, wählen Sie Agent um neuen Vorschlag zur aktuellen Version bitten. Bei einem veralteten Neuordnungsplan wählen Sie Neu ordnen.

Gewöhnliche Vorschläge erlauben das Bearbeiten eingefügter oder ersetzender Texte, aber keine separate Annahme einzelner Änderungen oder Dateien. Neuordnungsentwürfe sind schreibgeschützt; Sie können vorgeschlagene Löschungen vor Annahme des gesamten Plans zum Behalten markieren.

Eine fehlgeschlagene Nachricht erneut senden?

Meldet Noea, dass die Nachricht den Agenten nicht erreicht hat, können Sie es erneut versuchen. Wurde sie möglicherweise zugestellt, prüfen Sie zuerst Verlauf und Dateiänderungen, um doppelte Ausführung zu vermeiden.

Hat der Agent die Nachricht erhalten, die Aufgabe aber mittendrin abgebrochen, senden Sie eine neue Anweisung, den aktuellen Stand zu prüfen und fortzusetzen. Eine Vorschlagskarte mit Implementierung nicht abgeschlossen bietet auch Weiter implementieren.

Nachrichtenbearbeitung, Chatverzweigung und Stoppen eines Laufs setzen Dateiänderungen nicht zurück.

MCP-Server oder Skill wird nicht wirksam

Verwenden Sie für MCP Verbindung testen und prüfen Sie anhand des Ergebnisses Befehl, URL, Autorisierung und Umgebungsvariablen. Prüfen Sie auch nach erfolgreichem Test, ob der Server im Chat ausgewählt ist und der Agent seine Verbindungsmethode unterstützt.

MCP-Konfigurationsänderungen benötigen eine erneute Agent-Verbindung. Hinzufügen oder Entfernen eines Skills benötigt einen neuen Chat. Erläuterungs- und Neuordnungsaufgaben verwenden diese Erweiterungen nicht. Siehe MCP-Server und Skills hinzufügen.

Sichern scheitert oder ein Verweis öffnet sich nicht

Ein Sicherungskonflikt bedeutet, dass eine andere Aktion die Datei auf dem Datenträger während Ihrer Bearbeitung geändert hat. Sichern Sie Ihren aktuellen Inhalt separat oder laden Sie die Datenträgerversion neu. Erneutes Laden verwirft ungesicherte Bearbeitungen.

Prüfen Sie bei einem defekten Verweis, ob Datei oder Material noch existieren und der Implementierungsordner erreichbar ist. Passt eine alte Erläuterung nicht mehr zum Dokument, kehren Sie zu ihrem Absatz zurück, lesen Sie die aktuelle Erläuterung und untersuchen Sie bei Bedarf erneut.

Hilfreiche Informationen an das Team senden

Beschreiben Sie über Feedback in der Seitenleiste Ihr Ziel, das tatsächliche Ergebnis und die Schritte zum Problem. Hinterlassen Sie für Rückfragen eine E-Mail-Adresse oder schreiben Sie an [email protected].

Falls Diagnosedaten benötigt werden, exportieren Sie sie unter Einstellungen → Info oder kopieren Sie sie aus dem Agent-Detailbereich. Diagnosen können lokalen Status und Protokolle enthalten; prüfen Sie sie vor dem Teilen. Feedback hängt diese Dateien nicht automatisch an.