Sorun giderme

slopcode ile ilgili bir sorunu ayiklamak icin once loglari ve diskte tuttugu yerel verileri kontrol edin.

Loglar

Log dosyalari su konuma yazilir:

macOS/Linux: ~/.local/share/slopcode/log/
Windows: WIN+R tuslayip %USERPROFILE%\.local\share\slopcode\log yapistirin

Log dosyalari zaman damgasiyla adlandirilir (ornegin 2025-01-09T123456.log) ve en yeni 10 log dosyasi tutulur.

Daha ayrintili ayiklama bilgisi icin --log-level komut satiri secenegini kullanabilirsiniz. Ornek: slopcode --log-level DEBUG.

Depolama

slopcode, oturum verilerini ve diger uygulama verilerini diskte su konumda saklar:

macOS/Linux: ~/.local/share/slopcode/
Windows: WIN+R tuslayip %USERPROFILE%\.local\share\slopcode yapistirin

Bu dizin sunlari icerir:

auth.json - API anahtarlari, OAuth tokenlari gibi kimlik dogrulama verileri
log/ - Uygulama loglari
project/ - Oturum ve mesaj verileri gibi projeye ozel veriler
- Proje bir Git deposundaysa ./<project-slug>/storage/ altinda saklanir
- Git deposu degilse ./global/storage/ altinda saklanir

Masaüstü uygulaması

slopcode Desktop arka planda yerel bir slopcode sunucusu (slopcode-cli sidecar) calistirir. Sorunlarin cogu bozuk bir plugin, hasarli cache veya hatali sunucu ayarindan kaynaklanir.

Hızlı kontroller

Uygulamayi tamamen kapatip yeniden acin
Uygulama hata ekrani gosteriyorsa Restart’a tiklayip hata detaylarini kopyalayin
Yalnizca macOS: slopcode menusu -> Reload Webview (arayuz bos/donukse yardimci olur)

Eklentileri devre dışı bırakın

Desktop uygulamasi acilista cokuyorsa, takiliyorsa veya garip davranislar gosteriyorsa once pluginleri devre disi birakin.

Global config’i kontrol edin

Global config dosyanizi acin ve plugin anahtarini arayin.

macOS/Linux: ~/.config/slopcode/slopcode.jsonc (veya ~/.config/slopcode/slopcode.json)
macOS/Linux (eski kurulumlar): ~/.local/share/slopcode/slopcode.jsonc
Windows: WIN+R tuslayip %USERPROFILE%\.config\slopcode\slopcode.jsonc yapistirin

Plugin tanimliysa anahtari kaldirarak veya bos bir diziye cekerek gecici olarak devre disi birakin:

{
  "$schema": "https://slopcode.dev/config.json",
  "plugin": [],
}

Eklenti dizinlerini kontrol edin

slopcode diskten yerel plugin de yukleyebilir. Bu dizinleri gecici olarak tasiyin (veya klasoru yeniden adlandirin) ve uygulamayi yeniden baslatin:

Global plugins
- macOS/Linux: ~/.config/slopcode/plugins/
- Windows: WIN+R tuslayip %USERPROFILE%\.config\slopcode\plugins yapistirin
Project plugins (sadece proje bazli config kullaniyorsaniz)
- <your-project>/.slopcode/plugins/

Uygulama duzelirse soruna neden olan plugini bulmak icin pluginleri tek tek yeniden etkinlestirin.

Cache’i temizleyin

Pluginleri kapatmak ise yaramazsa (veya plugin kurulumu takili kaldiysa), slopcode’un cache’i yeniden olusturmasi icin cache’i temizleyin.

slopcode Desktop’u tamamen kapatin
Cache dizinini silin:

macOS: Finder -> Cmd+Shift+G -> ~/.cache/slopcode
Linux: ~/.cache/slopcode dizinini silin (veya rm -rf ~/.cache/slopcode calistirin)
Windows: WIN+R tuslayip %USERPROFILE%\.cache\slopcode yapistirin

slopcode Desktop’u yeniden baslatin

Sunucu bağlantı sorunlarını düzeltin

slopcode Desktop ya kendi yerel sunucusunu baslatir (varsayilan) ya da sizin tanimladiginiz bir sunucu URL’sine baglanir.

“Connection Failed” penceresi goruyorsaniz (veya uygulama acilis ekranini gecemiyorsa), ozel bir sunucu URL’si olup olmadigini kontrol edin.

Desktop varsayilan sunucu URL’sini temizleyin

Ana ekranda sunucu adina (durum noktali) tiklayarak Server secicisini acin. Default server bolumunde Clear’a tiklayin.

Config’ten `server.port` / `server.hostname` kaldirin

slopcode.json(c) dosyanizda server bolumu varsa gecici olarak kaldirin ve desktop uygulamasini yeniden baslatin.

Ortam degiskenlerini kontrol edin

Ortamda SLOPCODE_PORT ayarliysa desktop uygulamasi yerel sunucu icin o portu kullanmaya calisir.

SLOPCODE_PORT degerini kaldirin (veya bos bir port secin) ve yeniden baslatin

Linux: Wayland / X11 sorunları

Linux’ta bazi Wayland kurulumlari bos pencere veya compositor hatalarina yol acabilir.

Wayland kullaniyorsaniz ve uygulama bos/acilmiyorsa OC_ALLOW_WAYLAND=1 ile baslatin
Bu daha kotu olursa kaldirip X11 oturumunda baslatmayi deneyin

Windows: WebView2 Çalışma Zamanı

Windows’ta slopcode Desktop, Microsoft Edge WebView2 Runtime gerektirir. Uygulama bos pencereyle aciliyorsa veya hic baslamiyorsa WebView2’yi kurup/guncelleyip tekrar deneyin.

Windows: Genel performans sorunları

Windows’ta yavaslik, dosya erisim sorunlari veya terminal problemleri yasiyorsaniz WSL (Windows Subsystem for Linux) kullanmayi deneyin. WSL, slopcode ozellikleriyle daha sorunsuz calisan bir Linux ortami saglar.

Bildirimler görünmüyor

slopcode Desktop sistem bildirimlerini yalnizca su durumlarda gosterir:

Isletim sistemi ayarlarinizda slopcode icin bildirimler etkinse
Uygulama penceresi odakta degilse

Desktop depolamasını sıfırlayın (son çare)

Uygulama acilmiyorsa ve ayarlari arayuz icinden temizleyemiyorsaniz, desktop uygulamasinin kayitli durumunu sifirlayin.

slopcode Desktop’u kapatin
Su dosyalari bulun ve silin (slopcode Desktop uygulama veri dizininde yer alirlar):

slopcode.settings.dat (desktop varsayilan sunucu URL’si)
slopcode.global.dat ve slopcode.workspace.*.dat (son sunucular/projeler gibi UI durumu)

Dizini hizlica bulmak icin:

macOS: Finder -> Cmd+Shift+G -> ~/Library/Application Support (ardindan yukaridaki dosya adlarini aratin)
Linux: ~/.local/share altinda bu dosya adlarini aratin
Windows: WIN+R -> %APPDATA% (ardindan bu dosya adlarini aratin)

Yardım alın

slopcode ile ilgili bir sorun yasiyorsaniz:

GitHub’da issue acin

Hata bildirmek veya ozellik talep etmek icin en iyi yol GitHub depomuzdur:

github.com/grappeggia/slopcode/issues

Yeni issue acmadan once sorununuzun daha once raporlanip raporlanmadigini kontrol edin.
Discord’a katilin

Gercek zamanli yardim ve topluluk sohbeti icin Discord sunucumuza katilin:

slopcode.dev/discord

Yaygın sorunlar

Asagida yaygin sorunlar ve cozumleri yer aliyor.

slopcode başlamıyor

Hata mesaji icin loglari kontrol edin
Terminalde cikti gormek icin --print-logs ile calistirin
slopcode upgrade ile en guncel surumu kullandiginizdan emin olun

Kimlik doğrulama sorunları

TUI’da /connect komutuyla yeniden kimlik dogrulamasi yapin
API anahtarlarinizin gecerli oldugunu kontrol edin
Aginizin provider API baglantilarina izin verdiginden emin olun

Model kullanılamıyor

Provider ile kimlik dogrulamasi yaptiginizi kontrol edin
Config’teki model adinin dogru oldugunu dogrulayin
Bazi modeller ozel erisim veya abonelik gerektirebilir

ProviderModelNotFoundError aliyorsaniz buyuk olasilikla bir yerde model referansi yanlistir. Model referansi su formatta olmalidir: <providerId>/<modelId>

Ornekler:

openai/gpt-4.1
openrouter/google/gemini-2.5-flash
slopcode/kimi-k2

Erisiminiz olan modelleri gormek icin slopcode models calistirin.

ProviderInitError

ProviderInitError aliyorsaniz buyuk olasilikla config’iniz gecersiz veya bozulmustur.

Cozum adimlari:

Once providers rehberini izleyerek provider kurulumunun dogru oldugunu dogrulayin
Sorun surerse kayitli konfigurasyonu temizlemeyi deneyin:
Terminal window
```
rm -rf ~/.local/share/slopcode
```
Windows’ta WIN+R tuslayip su konumu silin: %USERPROFILE%\.local\share\slopcode
TUI’da /connect komutuyla provider kimlik dogrulamasini tekrar yapin

AI_APICallError ve provider paket sorunlari

API cagrisi hatalari aliyorsaniz bunun nedeni guncel olmayan provider paketleri olabilir. slopcode, provider paketlerini (OpenAI, Anthropic, Google vb.) gerektikce dinamik yukler ve yerelde onbellekler.

Provider paket sorunlarini gidermek icin:

Provider paket cache’ini temizleyin:
Terminal window
```
rm -rf ~/.cache/slopcode
```
Windows’ta WIN+R tuslayip su konumu silin: %USERPROFILE%\.cache\slopcode
En guncel provider paketlerini yeniden kurmak icin slopcode’u yeniden baslatin

Bu, slopcode’un en yeni provider paket surumlerini indirmesini zorlar ve model parametresi/API degisikliklerinden kaynakli uyumsuzluklari cogu zaman cozer.

Linux’ta kopyala/yapıştır çalışmıyor

Linux kullanicilarinin kopyala/yapistir ozelliginin calismasi icin asagidaki pano araclarindan en az birini kurmasi gerekir:

X11 sistemleri icin:

apt install -y xclip
# or
apt install -y xsel

Wayland sistemleri icin:

apt install -y wl-clipboard

Headless ortamlar icin:

apt install -y xvfb
# and run:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

slopcode, Wayland kullandiginizi algilarsa wl-clipboard tercihi yapar. Aksi halde sirayla xclip ve xsel araclarini arar.