Sorun giderme

Yaygin sorunlar ve cozum adimlari.

opensploit 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/opensploit/log/
Windows: WIN+R tuslayip %USERPROFILE%\.local\share\opensploit\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: opensploit --log-level DEBUG.

Depolama

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

macOS/Linux: ~/.local/share/opensploit/
Windows: WIN+R tuslayip %USERPROFILE%\.local\share\opensploit 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ı

opensploit Desktop arka planda yerel bir opensploit sunucusu (opensploit-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: opensploit 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/opensploit/opensploit.jsonc (veya ~/.config/opensploit/opensploit.json)
macOS/Linux (eski kurulumlar): ~/.local/share/opensploit/opensploit.jsonc
Windows: WIN+R tuslayip %USERPROFILE%\.config\opensploit\opensploit.jsonc yapistirin

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

{
  "$schema": "https://opensploit.ai/config.json",
  "plugin": [],
}

Eklenti dizinlerini kontrol edin

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

Global plugins
- macOS/Linux: ~/.config/opensploit/plugins/
- Windows: WIN+R tuslayip %USERPROFILE%\.config\opensploit\plugins yapistirin
Project plugins (sadece proje bazli config kullaniyorsaniz)
- <your-project>/.opensploit/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), opensploit’un cache’i yeniden olusturmasi icin cache’i temizleyin.

opensploit Desktop’u tamamen kapatin
Cache dizinini silin:

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

opensploit Desktop’u yeniden baslatin

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

opensploit 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

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

Ortam degiskenlerini kontrol edin

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

OPENCODE_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 opensploit 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, opensploit ozellikleriyle daha sorunsuz calisan bir Linux ortami saglar.

Bildirimler görünmüyor

opensploit Desktop sistem bildirimlerini yalnizca su durumlarda gosterir:

Isletim sistemi ayarlarinizda opensploit 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.

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

opensploit.settings.dat (desktop varsayilan sunucu URL’si)
opensploit.global.dat ve opensploit.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

opensploit ile ilgili bir sorun yasiyorsaniz:

GitHub’da issue acin

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

github.com/silicon-works/opensploit/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:

opensploit.ai/discord

Yaygın sorunlar

Asagida yaygin sorunlar ve cozumleri yer aliyor.

opensploit başlamıyor

Hata mesaji icin loglari kontrol edin
Terminalde cikti gormek icin --print-logs ile calistirin
opensploit 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
opensploit/kimi-k2

Erisiminiz olan modelleri gormek icin opensploit 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/opensploit
```
Windows’ta WIN+R tuslayip su konumu silin: %USERPROFILE%\.local\share\opensploit
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. opensploit, 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/opensploit
```
Windows’ta WIN+R tuslayip su konumu silin: %USERPROFILE%\.cache\opensploit
En guncel provider paketlerini yeniden kurmak icin opensploit’u yeniden baslatin

Bu, opensploit’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

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