For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/desktop/internals.md (or send Accept: text/markdown).
Masaüstü kabuğunun içinde
Önyükleme sayfası, gezinme kapısı, eklenti yığını ve yapılandırma referansı.
Önyükleme sayfası
Pencere önce apps/desktop/ui içindeki paketlenmiş sayfayı yükler: enjekte edilmiş __SUPASTACK_APP_URL__'yi okur, arka ucu on saniyelik bir zaman aşımıyla yoklar ve erişilebilir olduğunda ona yönlendirir. Ulaşılamayan bir arka uç, ağ düzeldiğinde de ateşlenen bir Retry ile bir Can't reach host durumu işler; böylece soğuk başlangıç asla boş bir pencere göstermez. Bir ?target= sorgu parametresi sayfayı düz bir tarayıcıda denemeyi sağlar.
Yerel özellikler IPC değil eklentidir
Kabuk özel komut kaydetmez — her yerel yetenek Tauri eklentileriyle gelir: deep-link özellikli single-instance (Windows ve Linux'ta ikinci başlatma argümanlarını yönlendirir), deep-link, window-state (yalnızca geometri — zoom ve kanal kendi yardımcı dosyalarını tutar), opener, dialog, process (güncelleme sonrası yeniden başlatma), updater, autostart ve global-shortcut, artı tray-icon özelliği. Kabuğu genişletmek, webview arayüzünü çatallamak değil bir eklenti ve bir izin eklemek demektir.
Gezinme kapısı
Gezinme; paketlenmiş kabuk sayfaları, dev-server kaynağı ve tam yapılandırılmış uygulama kaynağı için kabukta kalır. Kimlik bilgisi içermeyen HTTP(S), mailto: ve tel: bağlantıları opener eklentisiyle sistem tarayıcısından çıkar; diğer her şema iptal edilir. Pencere var olmadan gelen bir derin bağlantı yönetilen durumda arabelleğe alınır ve pencere oluştuğunda uygulanır.
Yapılandırma ve yetenek referansı
tauri.conf.json; productName, version (sürümden önce artırın — iş akışı onu geçersiz kılabilir), identifier (check:release-config com.supastack.desktop'tan değiştirilmesini ister), supastack derin bağlantı şeması, updater sentinel bloğu, bundle hedefleri ve yer tutucu simgeleri ayarlar. capabilities/default.json, core:default artı opener:allow-open-url verir — yalnızca yeni bir eklenti daha fazlasına ihtiyaç duyduğunda genişletin.
Kabuk nasıl test edilir
corepack pnpm --filter @supastack/desktop test, önyükleme sayfasını sözdizimi denetiminden geçirir ve URL çözümlemesi, derin bağlantılar, zoom ve kanal mantığını kapsayan Rust birim paketini çalıştırır; typecheck cargo check'i çalıştırır. JavaScript sürüm betikleri deponun vitest paketleriyle kapsanır ve CI hattı her değişiklik için üç işletim sisteminde de gerçek yükleyiciler derler.
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-configDoğrulama ve sorun giderme
src-tauri'ye dokunduktan sonra paket paketini çalıştırın, ardından yerel davranışı her hedef işletim sisteminde elle doğrulayın — birim denetimleri pencereyi değil kuralları kanıtlar. Yeni kabuk davranışını eklentiler ve menü öğeleri içinde tutun ki webview düz bir web uygulaması olarak kalsın.