Kabuğu çalıştırma ve yapılandırma

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. apps/desktop/src-tauri/src/lib.rs'yi açın; temsilcinizden yalnızca adlandırılmış pencere/tepsi/kısayol tuşu davranışını değiştirmesini ve ürün kullanıcı arayüzünü web uygulamasında tutmasını isteyin.

2. Kabuğu çalıştırın ve tepsiye yakın, Çık ve CmdOrCtrl+Shift+Space testlerini yapın; supastack:///settings/appearance?preview=1#main'yi test edin.

3. Mevcut pencereye odaklanmalı ve yolu/sorguyu/parçayı korumalıdır. Yanlış sayfayı açarsa yapılandırılmış başlangıç ​​noktasını ve tam rotayı karşılaştırı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.

• Başlamadan önce
• Terminal temelleri
• Masaüstü yerel kurulumu
• Aracı istemleri ve proje belleği

# 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 dev

Rust'ta kabuk davranışını koruyun

src-tauri/src/lib.rs, ana 1200×800 web görünümü penceresini oluşturur. Kapatıldığında tepsiye gizlenir; Çıkışlardan vazgeçin. Yerel menüler Ana Sayfa/Geri/İleri/Yeniden Yükle, yakınlaştırma/tam ekran ve pencere işlemlerini sağlar. Pencere durumu geri yüklemesi boyutu/konumu korur.

Bağlantıları yönetin ve çağırın

Kabuk, supastack:// rotalarını kabul eder ve bunları tam olarak yapılandırılmış HTTP(S) uygulama kaynağına göre çözümler. Örneğin, supastack:///settings/appearance?preview=1#main, /workspace/settings?tab=billing#plans olur; supastack:///auth/callback?code=..., /auth/callback?code=... ile eşleşir. Sorgu dizeleri ve parçaları korunur.

Başlangıç bağlantıları ilk pencere gösterilmeden önce uygulanır. macOS çalışma zamanı bağlantıları Tauri'nin on_open_url'sini kullanır; Windows ve Linux ikinci örnek argümanları, deep-link özelliği etkinken tek örnekli geri aramayı kullanır. Geçerli bağlantılar mevcut pencereye odaklanır ve bu pencerede gezinir.

Yalnızca tam olarak yapılandırılmış şemaya, ana bilgisayara ve etkili bağlantı noktasına sahip, kimlik bilgisi gerektirmeyen HTTP(S) bağlantıları kabukta kalır. Kimlik bilgisi gerektirmeyen HTTP(S), mailto: ve tel: bağlantıları harici olarak açılabilir; hatalı biçimlendirilmiş bağlantılar, kimlik bilgileri, desteklenmeyen şemalar, özel bağlantılardaki bağlantı noktaları ve geçiş girişimleri reddedilir. Yapılandırılmış arka uç URL ayrıca kimlik bilgilerini reddeder ve bir sonraki geçerli/varsayılan kaynağa geri döner.

SUPASTACK_APP_URL=https://your-app.example
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space

supastack:///settings/appearance?preview=1#main
# Opens https://your-app.example/workspace/settings?tab=billing#plans

Platforma özgü davranışı doğrulayın

Enjekte edilen çevrimdışı kaplama Yeniden Deneme olanağı sunar, çevrimiçi ortamda gizlenir ve web uygulamasını yeniden yükler. Her hedef işletim sisteminde odağı, kısayolları, menü yakınlaştırmasını, tepsiyi ve derin bağlantı çağrısını test edin; birim URL kontrolleri tek başına bu yerel etkileşimleri kanıtlamaz.

• Masaüstü kabulü

Kurulum ve yapılandırma

Çalışma alanı bağımlılıklarını, Rust araç zincirini ve Tauri'nin işletim sistemi başına ön koşullarını yükleyin (WebView2 Windows ile birlikte gelir; macOS ve Linux'un belgelenmiş paketlerine ihtiyacı vardır). corepack pnpm --filter @supastack/desktop dev, tauri dev'i çalıştırır: Rust çekirdeğini oluşturur, yer tutucu kullanıcı arayüzünü gösterir ve çözümlenen URL uygulamasını yükler.

SUPASTACK_APP_URL önce çalışma zamanında, ardından derlemeye eklenen değerden okunur. Yalnızca kimlik bilgisi içermeyen HTTP(S) adresleri kabul edilir; geçerli değilse sıradaki aday kullanılır. SUPASTACK_DESKTOP_HOTKEY varsayılan CmdOrCtrl+Shift+Space kısayolunu değiştirir. Geçersiz değer başlatmayı durdurmak yerine varsayılana döner.

corepack pnpm --filter @supastack/desktop dev
corepack pnpm --filter @supastack/desktop typecheck

SUPASTACK_APP_URL=https://app.example.com \
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space \
corepack pnpm --filter @supastack/desktop dev

Uygulama iş akışı

Ana pencere, protokol ve bağlantı noktası dâhil tam yapılandırılmış kaynakta kalır. Kimlik bilgisi içermeyen HTTP(S), mailto ve tel bağlantıları sistem tarayıcısında açılabilir; izin verilmeyen diğer protokoller iptal edilir.

Kaydedilen supastack:// bağlantıları yollarını, sorgularını ve parçalarını yapılandırılmış uygulama kaynağına taşır. Başlangıç, platformun URL açma olayları ve ikinci örnek callback'leri aynı doğrulamayı kullanır; derin bağlantı kabuğu başka bir ana bilgisayara yönlendiremez.

Sistem tepsisi simgesi ve genel kısayol tek ana pencereyi gösterip odağa alır. Kısayol kaydedilemiyorsa büyük olasılıkla başka bir uygulama aynı kombinasyonu kullanıyordur; farklı bir SUPASTACK_DESKTOP_HOTKEY seçin.

Doğrulama ve sorun giderme

src-tauri üzerinde değişiklik yaptıktan sonra paket komut dosyalarıyla cargo check ve cargo test çalıştırın. Ardından tam kaynakta gezinmeyi, izin verilen dış bağlantıların açılmasını, yapılandırılmış uygulama kaynağındaki bir supastack:// yolunu, sistem tepsisini ve kısayolu, yeniden başlatma sonrasında oturumun korunmasını doğrulayın.