Sorun Giderme

Uygulama Başlamıyor

Belirti: Colpan.exe tıklanıyor ama açılmıyor.

Çözümler:

DLL Eksikliği

• Tüm dosyaların aynı klasörde olduğundan emin olun
• Visual C++ Redistributable yükleyin

Yetki Sorunu

• Sağ tık → “Yönetici olarak çalıştır”

Antivirüs Engeli

• Colpan klasörünü istisna olarak ekleyin

PDF Görüntülenmiyor

Belirti: PDF paneli boş veya hata veriyor.

Çözümler:

Daemon Kontrolü

1. Durum çubuğunda “PDFc” durumunu kontrol edin
2. Kırmızı ise daemon başlatılamadı

Java Kontrolü

• udf2pdf_portable klasörünün var olduğundan emin olun
• jre-25-custom klasörünü kontrol edin

Port Çakışması

• 39876 portu başka uygulama tarafından kullanılıyor olabilir
• Bilgisayarı yeniden başlatın

PDFc Durum Göstergeleri:

• PDFc ✓ (Yeşil): Daemon çalışıyor
• PDFc ⏳ (Sarı): Daemon başlatılıyor
• PDFc ✗ (Kırmızı): Daemon başlatılamadı

Arama Sonuç Vermiyor

Belirti: Arama yapılıyor ama sonuç çıkmıyor.

Çözümler:

İndeks Kontrolü

• Dizinlerin indeksli olduğundan emin olun
• “İndeks eski” uyarısı varsa güncelleyin

Sorgu Kontrolü

• Syntax hatası olabilir
• Basit sorguyla test edin

Filtre Kontrolü

• Tarih filtresini kontrol edin
• Dosya yolu filtresini kontrol edin

Dizin Aktifliği

• Dizinlerin checkbox’larının işaretli olduğundan emin olun

İndeksleme Çok Yavaş

Belirti: İndeksleme saatlerce sürüyor.

Çözümler:

Dosya Sayısı

• 100.000+ dosya normal olarak uzun sürer
• Dizinleri bölmeyi deneyin

Ağ Dizini

• Ağ üzerindeki dizinler 10x yavaş
• Yerel kopyalama yapın

Disk Performansı

• HDD yerine SSD kullanın
• Disk fragmentasyonunu kontrol edin

Uygulama Donuyor

Belirti: Arayüz tepki vermiyor.

Çözümler:

Büyük Arama

• Sonuç limiti çok yüksek olabilir
• İptal edip daha küçük limitle deneyin

Bellek Yetersizliği

• Diğer uygulamaları kapatın
• Bilgisayarı yeniden başlatın

Bozuk İndeks

• İlgili dizini silin ve tekrar indeksleyin

Türkçe Karakterler Bozuk

Belirti: ı, ş, ğ gibi karakterler doğru görünmüyor.

Çözümler:

Türkçe Dönüşüm

• [✓] Türkçe Dönüştür seçeneğinin işaretli olduğundan emin olun

Font Sorunu

• Sistem fontlarını kontrol edin
• Tema değiştirmeyi deneyin

Tray İkonu Görünmüyor

Belirti: Bildirim alanında Colpan ikonu yok.

Çözümler:

Windows Ayarları

1. Ayarlar → Kişiselleştirme → Görev Çubuğu
2. “Bildirim alanı simgeleri”ni kontrol edin

Yeniden Başlatma

• Uygulamayı kapatın ve tekrar açın

Performans Sorunları

Arama Yavaş

Kontrol	Çözüm
İndeks var mı?	Dizini indeksleyin
Sonuç limiti?	Düşürün (1000 gibi)
Filtre var mı?	Tarih/yol filtresi ekleyin

Bellek Kullanımı Yüksek

Tipik Kullanım	RAM
Boşta	100-150 MB
Arama sırasında	300-500 MB
PDF açık	+50-100 MB

Azaltma:

• Kullanılmayan profillere geçmeyin
• Çok büyük sonuç listelerinden kaçının

AI Asistan Sorunları

Bağlantı Hatası

Belirti: “Bağlantı hatası” veya “Network error” mesajı.

Çözümler:

İnternet Bağlantısı

• İnternet bağlantınızı kontrol edin
• Firewall ayarlarını kontrol edin

CF Worker Erişimi

• CF Worker geçici olarak erişilemez olabilir
• Birkaç dakika bekleyin ve tekrar deneyin

API Key Hatası (Direct Mod)

• API key’in doğru girildiğinden emin olun
• Format: sk-or-v1-xxx
• OpenRouter hesabınızda kredi olduğundan emin olun

Yanıt Gelmiyor

Belirti: Yükleniyor göstergesi sürekli dönüyor.

Çözümler:

1. İsteği iptal edin (X butonu)
2. Soruyu kısaltın
3. CF Worker modunu deneyin

Manticore Search Sorunları

Daemon Başlamıyor

Belirti: Durum: ERROR, “Could not bind to port” hatası.

Çözümler:

Port Kontrolü

1. Komut satırında: netstat -an | findstr 9308
2. Port kullanımdaysa o programı kapatın

Yeniden Başlatma

1. Bilgisayarı yeniden başlatın
2. Colpan’ı açın

Antivirüs

• Manticore’u istisna olarak ekleyin
• searchd.exe için izin verin

Arama Sonuç Vermiyor (Manticore)

Belirti: Manticore READY ama sonuç yok.

Çözümler:

1. Dizinin Manticore’a indexlendiğinden emin olun
2. Sağ tık > “Manticore’a İndeksle”
3. Sorgu syntax’ını kontrol edin

Index Bozuk

Belirti: Hatalı sonuçlar, crash.

Çözümler:

1. Manticore data dizinini silin:

   %TEMP%\Colpan\manticore_data_N\

2. Uygulamayı yeniden başlatın
3. Tüm dizinleri yeniden indexleyin

Belge Dönüştürme Sorunları

RTF Dönüşüm Hatası

Belirti: “RTF parse error” mesajı.

Çözümler:

1. RTF dosyasının geçerli olduğunu kontrol edin
2. Farklı bir RTF kaynağı deneyin
3. LibreOffice ile önce temizleyin

LibreOffice Bulunamadı

Belirti: DOCX/DOC dönüştürme çalışmıyor.

Çözümler:

1. LibreOffice’i kurun
2. PATH’e ekleyin:

   C:\Program Files\LibreOffice\program\

3. Uygulamayı yeniden başlatın

Bozuk PDF Çıktısı

Belirti: Eksik karakterler, bozuk tablo.

Çözümler:

1. Java Daemon dönüştürücüye geçin
2. Font eksikliği olabilir - sistem fontlarını kontrol edin
3. Orijinal UDF’i UYAP editörde açıp kontrol edin

Hata Raporlama

Çözülemeyen sorunlar için:

1. Log dosyasını bulun: %TEMP%\Colpan\colpan.log
2. Hatayı yeniden oluşturun
3. Log dosyasını paylaşın