Troubleshooting Guide__Qoder CN_Intelligent Coding Assistant - Qoder CN Series

Bu konu, Qoder CN başlatma hataları gibi sorunları gidermek için Qoder CN tanılama betiğinin nasıl kullanılacağını açıklar. Betik; sistem ortamı bağlamını, ağ yapılandırmalarını, Qoder CN hizmet durumunu ve ilgili günlükleri otomatik olarak toplayarak sorunları hızlıca belirlemenize ve çözmenize yardımcı olur.

Önemli

Yeni Qoder CN belge sitesi artık kullanıma sunulmuştur. Bu sitedeki içerik, en son ürün özelliklerini ve değişiklikleri yansıtmayabilir. En güncel ürün belgeleri için docs.qoder.cn adresini ziyaret edin.

1. Betiği İndirin ve Çalıştırın

İşletim sisteminiz için tanılama aracını indirin ve çalıştırın:

Windows Ortamı

Betiği indirin: windows_lingma.bat dosyasını indirin.
Betiği çalıştırın: Dosyayı bulun, sağ tıklayın ve Run as administrator seçeneğini seçin.
Sonuçları görüntüleyin: Betik tamamlandığında oluşturulan günlük dosyasını otomatik olarak açar. Günlük yolu komut satırı penceresinde görünür ve genellikle betikle aynı dizinde, Qoder CN_Log_Date_Time.txt adıyla kaydedilir.

Linux/macOS Ortamı

Betiği indirin: linuxormac_lingma_cn.sh dosyasını indirin.
Betiği çalıştırın: Terminali açın, betiğin bulunduğu dizine gidin ve aşağıdaki komutları çalıştırın:
1. Betiğe çalıştırma izni verin.
```
chmod +x Linuxormac_lingma_cn.sh
```
2. Betiği çalıştırın.
```
./Linuxormac_lingma_cn.sh
```
Sonuçları görüntüleyin: Betik tamamlandığında bir günlük dosyası oluşturur. Bu dosya genellikle betikle aynı dizinde yer alır ve Qoder CN_Log_Date_Time.txt olarak adlandırılır.

2. Tanılama Sonuçlarına Yönelik Sorun Giderme Önerileri

Aşağıdaki yönergeler tüm işletim sistemleri (Windows, macOS, Linux) için geçerlidir. Oluşturulan günlük dosyasını kullanarak sorunları şu şekilde giderebilirsiniz:

Sorun Türü	Sorun Öğesi	Çözüm
Ağ	Proxy ayarlarını kontrol edin	Betik, proxy'nin etkin olup olmadığını denetler. Ayarların beklendiği gibi olduğunu doğrulamak için "[Network Settings]" veya "[Proxy Settings]" bölümünü kontrol edin. Proxy kullanıyorsanız, ayarlarda Qoder CN için ağ proxy'sini yapılandırmanız gerekir.
Qoder CN Hizmet Durumu	Qoder CN işlem varlığı	Betik öncelikle Qoder CN işleminin varlığını doğrular (Windows için Lingma.exe, macOS ve Linux için lingma). Bir hata oluşursa yükleme yolunun doğru olup olmadığını kontrol edin. .lingma dizinini silin, IDE'yi yeniden başlatın ve .lingma dizininin yeniden oluşturulmasını sağlayın.
	Sürüm ve başlatma testi	"[version test]" ve "[Start Qoder CN]" bölümlerini inceleyin. Qoder CN sürüm bilgilerini ve genel ağ sunucusuna bağlanabildiğini doğrulayın. "failed" hatası alınıyorsa, hata mesajındaki URL'i kullanarak genel ağa erişim sağlamak için ayarlarda bir proxy yapılandırın.
	İşlem başlar ancak oturum açma yanıt vermez	Windows: İşlem dosyasını Windows Güvenlik Duvarı izin listesine ekleyin (Denetim Masası\Sistem ve Güvenlik\Windows Defender Güvenlik Duvarı\İzin verilen uygulamalar). Ardından tekrar oturum açmayı deneyin: C:\Users\xxx\.lingma\bin\2.X.X\x86_64_windows\lingma.exe.macOS/Linux: Sistem güvenlik duvarı ayarlarını kontrol edin. Qoder CN işleminin ağ erişim izinlerine sahip olduğundan emin olun.
	Uyumsuz bir program bildirilirse	IDEA kullanıyorsanız, yetersiz heap belleği nedeniyle sıkıştırma açma işlemi başarısız olabilir. Sağ alt köşedeki Qoder CN simgesine tıklayın, Gelişmiş Ayarlar'ı seçin ve yolu sistem diski olmayan bir yola (boş bir klasörle biten) değiştirin. Ardından IDEA'yı yeniden başlatın. Not Bazı şirketlerin ikili programları dahili olarak kilitlediğini ve çalıştırmalarını engellediğini unutmayın.
	"Qoder CN başlatılıyor" mesajı görüntülenirse (veya bir başlatma hatası bildirilir ve hizmet yanıt vermezse) ne yapılmalıdır?	İşletim sistemi ve sistem mimarisi desteğini doğrulayın. Destekleniyorsa Görev Yöneticisi'nde (Windows), Etkinlik Monitörü'nde (macOS) veya Sistem Monitörü'nde (Linux) lingma işlemini kontrol edin. Desteklenmiyorsa Qoder CN'i en son sürüme yükseltin ve aşağıdaki adımları deneyin: Qoder CN işlemini sonlandırın. .lingma dizinini silin (Windows: C:\Users\[kullanıcıadı]\.lingma; macOS/Linux: ~/.lingma). IDE'yi yönetici ayrıcalıklarıyla (Windows) veya sudo ayrıcalıklarıyla (macOS/Linux) yeniden başlatın. Sorun devam ederse .lingma/bin/x.x.x/ dizininde başlatma komutunu çalıştırın.Windows: Komut satırında (cmd) `Lingma.exe start` komutunu çalıştırın.macOS/Linux: Terminalde `./lingma start` komutunu çalıştırın. İşlem göründükten sonra tekrar oturum açmayı deneyin. Uyumsuz bir program bildirilirse bu büyük olasılıkla sıkıştırma açma hatasından (muhtemelen yetersiz IDE heap belleği) kaynaklanır. Sağ alt köşedeki Qoder CN simgesine tıklayın, Gelişmiş Ayarlar'ı seçin ve yolu sistem diski olmayan bir yola (boş bir klasörle biten) değiştirin. Ardından IDE'yi yeniden başlatın.
Sistem Uyumluluğu	Sistem ve donanım bilgileri	Betik, işletim sistemi sürümlerini ve CPU modellerini toplar. "[Operating System Information]" bölümünü inceleyin. Bilgilerin Qoder CN'in sistem gereksinimlerini karşıladığını doğrulayın.
Günlük Analizi	Qoder CN uygulama günlükleri	Oluşturulan günlük dosyası, "lingma.log" dosyasının son birkaç satırını (genellikle 80 satır) kaydeder. Bu sayede Qoder CN çalışma zamanındaki belirli hatalar veya uyarılar tespit edilebilir. Günlükteki hata mesajlarını kendiniz analiz edin.
	Dizin yapısı ve dosya boyutu	Betik ayrıca Qoder CN yükleme dizininin yapısını ve her bir dosyanın boyutunu sağlar. Bunu alan kullanımı kontrolleri veya dosya bütünlüğü doğrulaması için kullanabilirsiniz.
	Bağımsız olarak gideremediğiniz sorunlar	"Qoder CN Genel Önizleme Tartışma Grubu (sık sorulan soruların cevapları için önce grup duyurusuna bakın)" adlı DingTalk grubuna katılın, grup numarası: `53770000738` ve resmi destek asistanıyla iletişime geçin.