Sorun Giderme Rehberi

Yaygın Memo sorunları için çözümler.

1. Port Çakışmaları

Belirti: Memo "address already in use" hatalarıyla başlatılamıyor.

Çözüm:

1. Hangi sürecin portu kullandığını kontrol edin: lsof -i :8080 (Linux/macOS) veya netstat -ano | findstr :8080 (Windows).
2. Çakışan süreci sonlandırın veya Ayarlar → Uzaktan Erişim → API Portu üzerinden Memo'nun portunu değiştirin.
3. Llama portu çakışıyorsa config.yaml içinde llama.port altında sabit bir port belirleyin.

2. VRAM / GPU Sorunları

Belirti: Model yükleniyor ancak yanıtlar çok yavaş veya günlüklerde CUDA hataları görünüyor.

Çözüm:

1. Ayarlar → Model Parametreleri → GPU Katmanları üzerinden GPU katmanlarını azaltın. Sadece CPU için 0 deneyin.
2. Model Mağazası'ndan daha küçük bir model seçin (daha düşük parametre sayılı olanları arayın).
3. Memo'yu çalıştırmadan önce diğer GPU yoğun uygulamaları kapatın.
4. CUDA sürücülerinin güncel olduğundan emin olun: nvidia-smi ile doğrulayın.

3. Llama Sunucusu Bulunamadı

Belirti: "llama server not found" veya "failed to connect to llama" hataları.

Çözüm:

1. Model dosyasının config.yaml → llama.model_path yolunda mevcut olduğunu doğrulayın.
2. llama.cpp sunucu ikili dosyasının PATH'inizde veya Memo ikili dosyasının yanında olduğundan emin olun.
3. ~/.memo/logs/llama.log yolundaki çökme günlüklerini kontrol edin.
4. Önceki örnek düzgün kapanmadıysa ~/.memo/llama.lock dosyasını silmeyi deneyin.

4. Boş Ön Uç Ekranı

Belirti: Web arayüzü yükleniyor ancak beyaz ekran gösteriyor.

Çözüm:

1. Tarayıcı geliştirici araçlarını açın (F12) ve Konsol sekmesindeki hataları kontrol edin.
2. Ctrl+Shift+R (veya macOS'te Cmd+Shift+R) ile sert yenileme yapın.
3. Memo kaynağı için tarayıcı önbelleğini ve yerel depolamayı temizleyin.
4. Flutter web derlemesinin bozuk olmadığını doğrulayın — gerekirse yeniden yükleyin veya yeniden derleyin.

5. Hafıza Getirme Hataları

Belirti: Memo geçmiş konuşmaları veya olguları hatırlamıyor.

Çözüm:

1. Ayarlar → Hafıza bölümünde hafızanın etkin olduğundan emin olun.
2. config.yaml içinde memory.auto_embed değerinin true olduğunu kontrol edin.
3. Gömme modelinin indirildiğini doğrulayın: ~/.memo/models/ dizininde yapılandırılan embedding_model için bakın.
4. vec0 SQLite eklentisi yüklenemediyse Go yedeği kullanılır — performans daha düşük olabilir ancak getirme yine de çalışmalıdır.
5. ~/.memo/memo.db dosyasını silip yeniden başlatarak vektör dizinini yeniden oluşturun (konuşmalar kaybolur).

6. Harici Sağlayıcı Bağlantı Sorunları

Belirti: Harici API'lerde "provider connection failed" veya zaman aşımı hataları.

Çözüm:

1. Ayarlar → API Sağlayıcıları üzerinden API anahtarınızın doğru ve süresinin dolmadığını kontrol edin.
2. İnternet bağlantınızı kontrol edin — harici sağlayıcılar ağ erişimi gerektirir.
3. API temel URL'sinin doğru olduğundan emin olun (varsayılanlar her sağlayıcı için önceden yapılandırılmıştır).
4. 443 portundan giden HTTPS'i engelleyebilecek proxy veya güvenlik duvarı ayarlarını kontrol edin.
5. Sağlayıcının durum sayfasında kesinti olup olmadığını kontrol edin.

7. Ajan Modu Çalışmıyor

Belirti: Ajan modu hataları veya araçlar yürütülmüyor.

Çözüm:

1. Ayarlar → Orkestra üzerinden ajanın etkin olduğundan emin olun.
2. Çalışma dizininin var olduğunu ve yazılabilir olduğunu doğrulayın.
3. Araç izinlerini kontrol edin — bazı araçlar açıkça etkinleştirilmeyi gerektirir.
4. Ajan modu yetenekli bir model gerektirir (7B+ parametre önerilir). Daha küçük modeller geçerli araç çağrıları üretemeyebilir.
5. ~/.memo/logs/agent.log yolunda kum havuzu hatalarını kontrol edin.