Sorun giderme ve SSS
Ajan başlamıyor
- Terminali açın ve ajanın CLI'sini elle çalıştırın. Orada da başarısız olursa sorun Nethür'de değil, CLI'nin kendisinde bir kimlik doğrulama veya kurulum sorunudur.
- CLI'nin Nethür'ün gördüğü
PATHüzerinde olduğundan emin olun (Ayarlar → Ajanlar sayfasına bakın). - Sekmedeki Yeniden başlat rozetini deneyin.
Diff görünümü yanlış / takılı
- Diff araç çubuğundaki yenile simgesine tıklayın — Nethür çalışma alanını yeniden okur.
- Harici
gitişlemleri (rebase, reset) yenilemeler arasına girebilir.
Çalışma alanı oluşturma başarısız
- Başlangıç ref'i getirilmemiş olabilir. Depoda bir terminal açın ve
git fetch originçalıştırın. - Hedef dizinde o dal için zaten bir worktree olabilir — silin veya yeni bir dal adı seçin.
Nethür CLI "komut bulunamadı" diyor
CLI'yi Ayarlar → Genel → Nethür CLI altında kaydedin. macOS'ta ~/.local/bin içine bir shim kurar; bunun kabuğunuzun PATH'inde olduğundan emin olun.
SSH bağlanıyor ama uzak terminaller başarısız
- Uzak makinede Node ve ilk kurulumda relay kurulumu için ağ erişimi olduğunu doğrulayın.
- Linux'ta terminaller hiç açılmıyorsa bir C/C++ araç zinciri kurun: make, g++/clang++, python3 (SSH worktree'leri sayfasına bakın).
- Araçları kurduktan sonra yeniden bağlanın; Nethür yerel modülleri yeniden kurabilsin.
SSH dosyalarda çalışıyor ama "Klasör indir" çalışmıyor
Klasör indirme özyinelemeli SFTP aktarımı gerektirir. Yalnızca sistem SSH'si olan bağlantılarda dosya indirme yine çalışabilir. Yedek olarak terminalden tar/scp kullanın.
"VS Code'da aç" devre dışı veya yalnızca yerel
- Bir SSH worktree kullanın (etkin çalışma zamanı olan Uzak Nethür Sunucusu değil).
- Açma komutunu Cursor veya çok argümanlı bir kabuk komutu değil, VS Code / Insiders olarak ayarlayın.
- Host kaldırıldıysa SSH hedeflerini yenileyin.
Kerberos oturumu başarısız
klistçıktısının host realm'i için geçerli bir bilet gösterdiğinden emin olun.- OpenSSH yapılandırmasında o Host için
GSSAPIAuthentication yesolduğunu doğrulayın, sonra Ayarlar → SSH altında hedefi yeniden içe aktarın veya yeniden test edin.
Tarayıcı browser_no_tab diyor
Geçerli çalışma alanında açık sekme yok. nethur tab create --url ... ile bir tane açın veya tarayıcı panelini elle açıp gezinin.
Performans ve bellek
- Etkin kullanmadığınız çalışma alanlarını kapatın. Her çalışma alanı dosya izleyicilerini canlı tutar.
- Çok sayıda tarayıcı sekmesi olan bölünmüş düzenler en çok RAM kullananlardır — ihtiyacınız olmayan tarayıcıları kapatın.
GitHub PR paneli / kontroller / Görevler hataları
Hız limitleri, hatalı gh kimlik doğrulaması, eksik kapsamlar ve depo erişim sorunları Kaynak Kontrolü ve PR Kontrolleri panelinde görünür. Tam matris için GitHub hatalarını giderme sayfasına bakın (Ayarlar'daki GitHub API Bütçesi iyi görünürken REST'in neden hâlâ engellenebileceği dahil).
Hızlı kontroller:
gh auth status -h github.com
gh api user
gh api rate_limit --jq '.resources.core'Günlükler
Yardım → Günlükleri aç Nethür'ün günlüklerini içeren dizini açar. Hata bildirirken bunları ekleyin.
Sorun bildirme
- Yardım → Geri bildirim gönder (uygulama içi) — ekran görüntülerini iletişim kutusuna yapıştırın veya sürükleyin ya da görsel dosyaları seçin; küçük önizlemeler göndermeden önce görünür. Hatanın yeniden üretilmesi zorsa günlükleri ekleyin.
- hata bildir — hatalar ve özellik istekleri.