Documentație / Referință
Depanarea problemelor
Ce faci când ceva nu funcționează: pornire, indexare, IA, Claude Code, Git, bază de date și build.
Înainte de toate, două unelte care ajută întotdeauna:
- Ajutor → Jurnal de erori… afișează erorile recente ale IDE-ului.
- Ajutor → Raportează o problemă… creează un
.zip cu tot ce este necesar pentru diagnostic, fără codul sau conversațiile tale. Copiază rezumatul oferă textul gata de lipit.
Întreabă agentul „ce nu funcționează?”. Cu yuli_health verifică dintr-odată problemele, rularea, testele, terminalele și jurnalele Yuli.
Instalare și pornire
| Simptom |
Ce faci |
| Windows afișează un avertisment la rularea instalatorului |
Verifică dacă l-ai descărcat din sursa oficială și dacă editorul certificatului este „Yuli Code”. |
| AppImage-ul nu se deschide în Linux |
Acordă-i permisiunea de execuție cu chmod +x. |
| Versiunea portabilă pornește greu prima dată |
Este normal: dezarhivează aplicația o singură dată pentru fiecare versiune. Ulterior pornește instantaneu. |
| Interfața este în altă limbă |
Opțiuni globale → Aspect → Limbă. Vezi Limbi. |
| Vrei să măsori de ce pornește greu |
Ajutor → Performanța la pornire…. |
Indexare și inteligența codului
| Simptom |
Ce faci |
| Lipsesc referințe sau navigarea este incompletă |
Așteaptă să se termine indexarea (bara de sus a editorului). |
| Lombok sau dependențele nu se rezolvă |
Proiectul poate fi în modul restricționat. Opțiuni globale → Securitate → Proiecte de încredere → Am încredere. |
| Avertismentul „Niciun server de limbaj pentru…” |
Apasă Instalează… și autorizează descărcarea. |
| Indexul pare neactualizat |
Instrumente → Golește cache-ul… șterge indexurile și starea salvată; Yuli le regenerează. |
| Lipsește un JDK, Maven sau Gradle |
Yuli se oferă să-l descarce. Configurează-l în Proiect → Build, rulare și depanare…. |
IA nu răspunde
| Simptom |
Ce faci |
| Eroare de autentificare în Modul Platform |
Verifică cheia API în setările modelului și apasă Testează conexiunea. |
| Un model local nu răspunde |
Verifică dacă serverul rulează și dacă URL-ul serverului este corect. |
| Furnizorul este indisponibil |
Yuli respectă retry-after-ul furnizorului. Așteaptă sau schimbă furnizorul. |
| O sarcină în fundal s-a oprit |
Și-a atins limita de tokeni sau de cost: Mărește limita și reia. |
| Echipa de agenți s-a pus pe pauză |
Și-a atins bugetul. Mărește-l în Mai multe acțiuni → Echipă de agenți. |
Claude Code, Kiro, Codex și Antigravity
| Simptom |
Ce faci |
| Yuli nu găsește agentul |
Instalează-l cu instalatorul lui oficial și apasă Detectează din nou. |
| „Se așteaptă ca Claude Code să folosească uneltele Yuli” |
Aprobă serverul yuli sau apasă Aprobă acum. Verifică cu /mcp. |
/mcp arată yuli cu eroare |
Deschide proiectul în Yuli: uneltele funcționează doar cu Yuli deschis. yuli_status explică motivul. |
| Regulile nu s-au schimbat |
Se încarcă la pornirea sesiunii: repornește-o din bara agentului. |
| Codex spune că lipsește adaptorul |
Instalează codex-acp: npm install -g @openai/codex @agentclientprotocol/codex-acp. |
| Kiro cere actualizare |
Yuli are nevoie de Kiro CLI 1.28.2 sau mai nou. |
| Nu vreau ca Yuli să blocheze ceva |
Dezactivează Impune regulile („Doar avertizare”). Git și secretele sunt protejate întotdeauna. |
Agentul nu face ceva
| Simptom |
De ce |
Ce faci |
| Nu face commit sau push |
Git se activează doar printr-o cerere explicită. |
Cere-o: „fă commit și push”. Aprobă fiecare acțiune. |
| Nu creează o ramură |
Ramurile necesită propria cerere. |
Cere ramura în mod explicit. |
| Nu citește un fișier |
Este un fișier cu secrete (.env, chei, credențiale). |
Este intenționat. Transmite informația fără secret. |
| Nu poate scrie în afara proiectului |
Sandbox-ul îl limitează la proiect. |
Proiect → Acces la foldere… |
| Nu rulează o instrucțiune în baza de date |
Conexiunea nu are Super permisiuni pentru acea clasă. |
Ajustează Acces agent al conexiunii. |
| Nu trece la Testare |
Măsurarea este în așteptare sau a cerut iterare. |
Uită-te în fila Măsurare din panoul Calitate. |
| Nu încheie tura |
Lipsește verificarea pe verde. |
Vezi ce eșuează în Rulare, Teste sau Probleme. |
Git
| Simptom |
Ce faci |
| O operație durează prea mult |
La expirarea limitei apare Reîncearcă. |
| Eroare de certificat cu un server intern |
Marchează încrederea în certificatul lui; Yuli reține decizia pentru fiecare server. |
| Nu pot face commit din cauza gate-ului |
Citește controlul care a eșuat (secrete, integritatea testelor, dimensiune, căi protejate). Corectează-l sau cere o excepție cu dată de expirare. |
| Hook-urile Yuli nu s-au instalat |
Există deja altă unealtă în core.hooksPath (de exemplu, husky). Yuli nu o înlocuiește. |
Bază de date
| Simptom |
Ce faci |
| „Pentru conectarea la Oracle este necesar Oracle Instant Client” |
Instalează Instant Client 19c sau mai nou și adaugă-l în PATH. |
| Eroare de certificat |
Bifează Are încredere în certificatul serverului în conexiune. |
| Agentul nu vede o conexiune |
Accesul ei este setat pe Fără acces. |
| O interogare a agentului a fost întreruptă |
A depășit 45 de secunde sau planul ei estimează o parcurgere prea mare. Restrânge interogarea. |
Containere
| Simptom |
Ce faci |
| „Docker nu este disponibil” |
Pornește Docker și apasă Reîncearcă. |
| „kubectl nu este configurat” |
Instalează kubectl și configurează un context (kubeconfig). |
Tot nu funcționează
- Ajutor → Raportează o problemă…
- Descrie ce făceai și ce te așteptai să se întâmple.
- Partajează fișierul
.zip sau rezumatul pe GitHub.