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.md (or send Accept: text/markdown).
Masaüstü genel bakış
Aynı web uygulamasını saran bir Tauri webview kabuğu — ikinci bir ürün değil, varlık.
Başlangıç seviyesinde izlenecek yol
Önkoşullar: Aşağıdaki iki başlangıç kılavuzunu okuyun ve Rust ve işletim sistemi önkoşulları da dahil olmak üzere Masaüstü yerel kurulumunu tamamlayın. Kod bloğu monorepoda hem web uygulamasını hem de Tauri'yi başlatır; Yalnızca masaüstü ödemesinde, filtrelenmiş komutunu yalnızca erişilebilir bir web arka ucunu ayrı olarak başlattıktan sonra kullanın. Tauri bu arka ucu yükler.
Kısa terimler: Çalışma alanı, bir ekibin ayrı kullanıcıları, verileri ve ayarlarıdır. Sunucu güvenilir arka uçtur; sağlayıcı anahtarlarını tarayıcı ve telefon kodundan uzak tutun. Geçiş, tabloları oluşturan veya güncelleyen sürümlü bir veritabanı değişikliğidir. Yapay zeka modeli yanıt veren motordur; model kataloğu, sunucunun mevcut model kimlikleri ve fiyatlarının listesidir. Sağlayıcı yapay zeka, e-posta veya faturalandırma hizmeti gibi bir dış hizmettir. Yetki, bir çalışma alanının bir özelliği kullanmasına olanak tanıyan bir yetkidir. Web kancası, bir hizmetin başka bir hizmetin URL'sine gönderdiği bir mesajdır.
1. Masaüstü yerel kurulumunu takip edin, ardından uygulamayı Tauri penceresinde açın ve tarayıcıda kullandığınız web hesabında oturum açın.
2. Bir çalışma alanı sayfasını ziyaret edin, pencereyi tepsiden gizleyin/gösterin ve çağırma kısayolunu deneyin.
3. Tauri yapılandırılmış arka ucu yüklediğinden ekranın web uygulamasıyla eşleşmesi gerekir. Boşsa SUPASTACK_APP_URL'nin ulaşılabilir çalışan bir web uygulamasına işaret ettiğini doğrulayın.
Özel kod için, sağlanan prompts/README.md ile başlayın ve en yakın istemi kopyalayın: Bir uygulama ekranı için prompts/new-app-screen.md veya genel bir sayfa için prompts/new-landing-page.md. Sunucu, veritabanı veya sağlayıcı çalışması için kodlama temsilcinize bu kılavuzun görevini verin ve ondan AGENTS.md, .ai/PROJECT_CONTEXT.md ve eşleşen .ai/ aynalarını okumasını isteyin; burada adı geçen kaynak dosyaların tamamını inceleyin; düzenlemeden önce dosyaları ve kontrolleri listeleyin; çalışma alanı sahipliğini ve yalnızca sunucuya ait sırları koruyun; ve size farkı göstereceğim. İstediğiniz davranışı, giriş ve çıkış alanlarını, izin verilen rolleri, beklenen başarıyı ve hataları ve test hesabını, sağlayıcıyı veya cihazı ona bildirin. Örnek değerleri kullanın; asla gerçek bir sırrı yapıştırmayın.
# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop
# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop devTek ürün kullanıcı arayüzü, yerel kabuk
apps/desktop, web uygulamanız üzerinden bir Tauri web görünümüdür. Ürün kullanıcı arayüzünü, kimlik doğrulamasını ve sohbeti web ile paylaşır; yerel pencere/tepsi davranışı src-tauri/src/lib.rs'de bulunur. Erişilebilir bir web arka ucuna ihtiyaç duyar ve bağımsız bir ürün arayüzünü bir araya getirmez.
Yerel kabuk özelliklerini kullanın
Kabuk, bir tepsi menüsü, tepsiye yakın, tek örnekli odaklama, küresel çağrı kısayol tuşu, yerel gezinme/görüntüleme menüleri, sistem tarayıcısındaki harici bağlantılar, supastack:// derin bağlantı çağrısı, hatırlanan pencere durumu ve çevrimdışı Yeniden Deneme katmanı sunar.
SUPASTACK_APP_URL arka ucu seçer: önce geçerli çalışma zamanı değeri, ardından derleme zamanı değeri, sonra localhost. SUPASTACK_DESKTOP_HOTKEY, CmdOrCtrl+Shift+Space kısayolunu geçersiz kılar. İmzalı sürüm derlemeleri SUPASTACK_UPDATER_ENDPOINT ve SUPASTACK_UPDATER_PUBKEY değerlerini enjekte eder; uç nokta yolu {{channel}} içerdiğinde uygulama menüsü Beta Updates seçeneğini (stable veya beta, çalışma zamanında SUPASTACK_UPDATE_CHANNEL ile geçersiz kılınabilir) etkinleştirir.
Masaüstü yolunuzu seçin
Yerel iş için web ve masaüstünü birlikte çalıştırın, ardından platform önkoşullarıyla birlikte yerel hedefi oluşturun ve doğrulayın. Mağaza imzalama, yükleyiciler ve fiziksel masaüstü davranışı ayrı bir kabul gerektirir.
İkinci bir uygulama değil, webview kabuğu
apps/desktop bir Tauri 2.x kabuğudur. src-tauri içindeki Rust çekirdeği pencereyi, sistem tepsisini ve genel kısayolu yönetirken webview web uygulamasını yükler. Arayüz, kimlik doğrulama, faturalama ve AI aynı Next.js kod tabanından gelir — masaüstü yüzeyi paralel bir ürün değil, varlık ekler.
Kabuk, web uygulaması yüklenirken gösterilen apps/desktop/ui altında bir yer tutucu sayfa taşır; böylece soğuk başlatma asla boş pencere göstermez.
Kabuğu bir dağıtıma yönelt
Pencere hedefi sırayla çözülür: çalışma zamanı SUPASTACK_APP_URL, ardından derleme zamanı SUPASTACK_APP_URL, ardından http://localhost:3000. Yalnızca http ve https URL'leri kabul edilir — boş veya web dışı değerler bir sonraki adaya düşer.
Geliştirme açısından bu, kabuğun corepack pnpm dev'nin hizmet ettiği şeye bağlandığı anlamına gelir. Üretim için, değişkeni derleme zamanında dağıtılan web uygulamanızda hazırlanacak şekilde ayarlayın.
Sırlar sunucuda kalır
Kabuk sağlayıcı kimlik bilgisi taşımaz. Webview, tarayıcının kullandığı aynı kimlik doğrulamalı API yüzeyiyle konuşur — sağlayıcı anahtarları, oturum sırları ve faturalama yapılandırması sunucuda kalır.
com.supastack.desktop paket tanımlayıcısı ve varsayılan yetenek kümesi (core:default) webview'i sandbox'ta tutar; src-tauri/capabilities içindeki izinleri yalnızca yerel bir özellik gerektirdiğinde genişletin.
Kuruluma devam etmek için Kabuğu çalıştırma ve yapılandırma kılavuzunu okuyun.