Rozwiązywanie problemów i najczęstsze pytania

Zacznij od komunikatu dotyczącego nieudanej operacji, a potem sprawdź stan projektu, agenta i zadania. Poniższe sekcje wskazują właściwe miejsce dla typowych problemów.

Konfiguracja nie pozwala przejść do przestrzeni roboczej

Pierwsza konfiguracja wymaga zainstalowania, zalogowania i zweryfikowania co najmniej jednego agenta. Sama instalacja lub zamknięcie okna logowania nie wystarcza: na liście musi pojawić się Ready.

Otwórz szczegóły tego agenta, rozwiąż problemy z logowaniem, siecią lub weryfikacją i sprawdź ponownie. Zobacz Zainstaluj i przygotuj środowisko.

Pobieranie nie działa lub zatrzymuje się na przygotowaniu

Najpierw sprawdź sieć i systemowy serwer proxy HTTP(S). Zmienne środowiskowe proxy mają pierwszeństwo; ten mechanizm nie obsługuje serwerów proxy SOCKS. Status przygotowania może się pojawić, gdy pobieranie przestaje odbierać dane. Obserwuj aktualizacje stanu i ponów próbę, jeśli zgłoszono błąd.

Jeśli problem się powtarza, skopiuj dane diagnostyczne agenta i zapisz, czy wystąpił podczas pobierania środowiska uruchomieniowego, instalacji agenta czy weryfikacji połączenia.

Logowanie się powiodło, ale agent nadal jest niedostępny

Noea ocenia gotowość agenta na podstawie wyników weryfikacji. Sprawdź konto lub dostawcę, dostępny limit i konfigurację modelu. W OpenCode odśwież listę dostawców, potwierdź połączenie i ponów weryfikację.

Jeśli wybór modelu wymaga wcześniejszego połączenia, połącz sesję i sprawdź ponownie. Ustawienie obsługiwane przez jednego agenta nie musi być obsługiwane przez innego.

Projekt się nie otwiera

Sytuacja	Co zrobić
Wybrany folder nie jest projektem Noea.	Dla kodu użyj Open Implementation Folder, a dla istniejącego projektu wskaż jego rzeczywisty folder.
Folder projektu został przeniesiony.	Wskaż jego bieżącą lokalizację przez Open Existing Noea Project.
Folder projektu został usunięty.	Przed ponownym otwarciem przywróć go z Kosza lub kopii zapasowej.
Konfiguracja jest nieprawidłowa.	Zachowaj pierwotną treść. Sprawdź konfigurację albo prześlij dane diagnostyczne; nie nadpisuj jej przez ponowną inicjalizację.
Dane zapisała nowsza wersja aplikacji.	Zaktualizuj aplikację, a potem otwórz projekt ponownie.
Wersja danych jest niezgodna.	Zachowaj kopie danych projektu i aplikacji, a następnie postępuj zgodnie z konkretnym komunikatem. Nie nadpisuj niezgodnych danych.

Założenia można czytać, ale rozmowy się nie uruchamiają

Sprawdź folder implementacji w Settings → Current Project → Project. Połącz go, jeśli jeszcze nie jest połączony, albo wskaż nową lokalizację pierwotnego folderu kodu, jeśli stara jest niedostępna.

Sprawdź także, czy agent ma status Ready. Czytelne pliki z założeniami nie oznaczają, że folder implementacji i agent również są gotowe.

Brakuje wyjaśnienia lub wydaje się błędne

Zapisz założenia, a następnie przeanalizuj odpowiedni akapit albo uruchom Explain z paska bocznego. Jeśli wymaganie wymaga zmiany kodu, zaimplementuj ją w rozmowie przed analizą.

Previous text oznacza założenia sprzed edycji. May be outdated oznacza, że później zmieniły się pliki stanowiące podstawę wyjaśnienia. Sprawdź oba oznaczenia względem bieżącej treści; zobacz Dbaj o aktualność wyjaśnień.

No changes found na pasku bocznym nie oznacza, że wszystkie testy przechodzą ani że nie ma już żadnych braków.

Explain nie uruchomiło się po implementacji

Sprawdź Settings → Current Project → Automation → Explain automatically after implementing. Zmiany samego kodu w zwykłych rozmowach, Implement Directly oraz nieudane lub zatrzymane uruchomienia implementacji nie uruchamiają tej funkcji.

W razie potrzeby uruchom Explain ręcznie. Jeśli zadanie się zakończyło, ale nadal pokazuje nieudane lub niedokończone kontrole, rozwiń wyniki, usuń przyczynę i uruchom je ponownie. Zobacz pełne reguły automatycznego uruchamiania.

Nie można zaakceptować propozycji lub planu porządkowania

Jeśli propozycja informuje, że dokument się zmienił, wybierz Ask Agent to Re-propose on Current Version. Dla nieaktualnego planu porządkowania wybierz Reorganize.

W zwykłych propozycjach możesz edytować dodany lub zastąpiony tekst, ale nie możesz akceptować osobnych zmian ani plików. Uporządkowane szkice są tylko do odczytu; przed zaakceptowaniem całego planu możesz zachować fragmenty proponowane do usunięcia.

Czy ponownie wysłać wiadomość po błędzie?

Jeśli Noea informuje, że wiadomość nie została dostarczona agentowi, możesz spróbować ponownie. Jeśli mogła dotrzeć, najpierw sprawdź przebieg wykonania i zmiany plików, aby uniknąć podwójnego działania.

Jeśli agent otrzymał wiadomość, ale zatrzymał się w trakcie zadania, wyślij nową instrukcję, aby sprawdził obecny stan i kontynuował. Karta propozycji oznaczona Implementation not finished udostępnia także Continue Implementing.

Edycja wiadomości, utworzenie gałęzi rozmowy lub zatrzymanie uruchomienia nie cofa zmian plików.

Serwer MCP lub umiejętność nie działa

W przypadku MCP użyj Test Connection i sprawdź polecenie, URL, autoryzację oraz zmienne środowiskowe wskazane w wyniku. Nawet po udanym teście upewnij się, że serwer jest wybrany w rozmowie i że agent obsługuje jego metodę połączenia.

Zmiany konfiguracji MCP wymagają ponownego połączenia agenta. Dodanie lub usunięcie umiejętności wymaga nowej rozmowy. Zadania Explain i porządkowania nie korzystają z tych rozszerzeń. Zobacz Dodawaj serwery MCP i umiejętności.

Zapis się nie udaje lub nie można otworzyć odwołania

Konflikt zapisu oznacza, że inna operacja zmieniła plik na dysku podczas Twojej edycji. Zapisz bieżącą treść osobno albo ponownie wczytaj wersję z dysku. Ponowne wczytanie odrzuca niezapisane zmiany.

Jeśli odwołanie nie działa, sprawdź, czy plik lub materiał nadal istnieje i czy folder implementacji jest dostępny. Jeśli stare wyjaśnienie nie pasuje już do dokumentu, wróć do odpowiedniego akapitu, przeczytaj najnowsze wyjaśnienie i w razie potrzeby ponownie przeprowadź analizę.

Przekaż zespołowi przydatne informacje

Użyj Feedback na pasku bocznym, aby opisać cel, rzeczywisty wynik i kroki prowadzące do problemu. Podaj adres e-mail, jeśli chcesz otrzymać odpowiedź, albo napisz na [email protected].

Jeśli potrzebne są dane diagnostyczne, wyeksportuj je przez Settings → About lub skopiuj z panelu szczegółów agenta. Mogą zawierać lokalny stan i dzienniki, więc przejrzyj je przed udostępnieniem. Opinia nie dołącza automatycznie tych plików.