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/first-feature.md (or send Accept: text/markdown).
İlk özelliğinizi oluşturun
Bir yerel kabuk değişikliğinden doğrulanmış bir pencereye uçtan uca bir yürüyüş.
Başlangıç seviyesinde izlenecek yol
Ön koşullar: aşağıdaki iki başlangıç kılavuzunu okuyun, Desktop yerel kurulumunu tamamlayın ve bu depoyu kökünde düzenleyicinizde açın. Kabuk, SUPASTACK_APP_URL'yi başlatırken bir terminal ayarı olarak okur — kaydedilmiş bir .env dosyasından değil.
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. .agents/skills/add-a-desktop-capability/SKILL.md'yi açın — veya kodlama aracınızdan takip etmesini isteyin — ve küçük bir yerel değişiklik yapın, örneğin yeni bir Görünüm menü öğesi veya farklı bir çağrı kısayolu.
2. cargo check çalıştırın, kabuğu başlatın ve açık pencerede değişikliği egzersiz edin.
3. Göndermeyi planladığınız her işletim sisteminde tekrarlayın — tepsi, kısayol ve menü davranışı platforma göre değişir.
Özel kod için, davranışı, etkilediği menü veya kısayolu ve her işletim sisteminde ne olması gerektiğini adlandırın. Bu görevi kodlama aracınıza verin ve AGENTS.md, .ai/PROJECT_CONTEXT.md ve dokunacağı dosyaların .ai/ yansımalarını okumasını isteyin; düzenlemeden önce dosyaları ve kontrolleri listelesin; ve farkı size göstersin. Örnek değerler kullanın; asla gerçek bir gizli bilgi yapıştırmayın.
Önce yerel mi yoksa ürün mü olduğuna karar verin
Bir kullanıcının ürün UI'si olarak deneyimlediği her şey — ekranlar, veriler, ayarlar — web uygulamasına aittir ve otomatik olarak pencereye gelir. Yalnızca işletim sistemi düzeyindeki davranış Rust'a aittir: pencereler, tepsi, menüler, genel kısayollar, oturum açmada başlatma ve güncelleme kontrolleri.
apps/desktop/src-tauri/src/lib.rs
apps/desktop/src-tauri/tauri.conf.json
apps/desktop/src-tauri/capabilities/default.jsonWebview kum kutusunu sıkı tutun
Webview yalnızca capabilities/default.json'ın listelediklerini çağırabilir. Yeni bir eklenti gerektiren bir değişiklik, Cargo.toml'a crate'i ekler, lib.rs'de kaydeder ve capabilities'de minimum izni verir — asla joker karakter değil.
Kalıcı kabuk durumu — pencere konumu, yakınlaştırma, güncelleme kanalı, pencere tercihleri — dahil edilen yardımcı dosyalar aracılığıyla uygulamanın veri dizininde yaşar, elle yönettiğiniz dosyalarda değil.
Her hedef işletim sisteminde doğrulayın
cargo test çalıştırın, ardından Windows, macOS ve Linux'ta gerçek bir pencere açın: pencere durumu geri yükleme, tepsiye kapatma, tek örnek odak ve değişikliğiniz etkinken çağrı kısayolu. Bir işletim sisteminin geçmesi diğer ikisini kanıtlamaz.