Kurulumu bir ajana yaptırın

Sıkıcı kısmı devredebilirsiniz

Bu depo, bir kodlama aracısının okuyabilmesi için yazılmıştır. Bir harita dosyası (llms.txt), bir kural dosyası (AGENTS.md), dosya başına bellek notları (.ai/) ve görev becerileri (.agents/skills/) içerir. Bağımsız Desktop checkout, prompts/ klasörünü içermez, bu nedenle hazır istem bu kılavuzda yazılıdır — bir dosya açmak yerine aşağıdan kopyalayın.

Yazmayı devretmek, kontrolleri atlamak anlamına gelmez. Ajan, deponun sizdeki kopyası içinde çalışır ve ne yaptığını kanıtıyla bildirmek zorundadır. Aşağıdaki bölümler iyi bir raporun nasıl göründüğünü gösterir, böylece sonucun kontrolü sizde kalır.

Bu yol, Tauri kabuğunu ve Web arka ucuna bağlantısını — hesapları ve verileri işleyen sunucuyu — kurar. Masaüstü pencere yalnızca bu arka ucu görüntüler; checkout'unuz apps/web'i de içeriyorsa, aracı onu yerel olarak çalıştırabilir ve yalnızca Desktop checkout, size verilen erişilebilir arka uç adresine ihtiyaç duyar.

• Bunun yerine Desktop uygulamasını elle çalıştırın

Önce gerekenler

Önce hazırlık kılavuzunu tamamlayın: Node.js, Git ve bir düzenleyici kurulu olmalı, GitHub daveti kabul edilmeli ve supastack klasörü bilgisayarınıza indirilmiş olmalıdır. Ajan o klasörün içinde çalışır, bu nedenle Başlamadan önce kılavuzundaki her şey hâlâ geçerlidir.

Ayrıca kodlama ajanı olarak işlev görebilen bir araca ihtiyacınız var — yerleşik bir yapay zeka kodlama ajanına sahip bir düzenleyici (bir yapay zeka IDE'si) veya terminalinizde çalışan bir ajan (bir ajan CLI'si). Güncel herhangi bir ajan yetenekli araç iş görür; istem, neyi okuyup neyi çalıştırması gerektiğini zaten açıkça belirtir, bu nedenle talimatları kendiniz yazmanız gerekmez.

Son olarak, istemin istediği iki şeye karar verin: pencerenin yüklemesi gereken arka uç adresi — yerel arka uç için http://localhost:3000 veya verilen HTTPS adresiniz — ve Rust ile yerel derleme araçlarının bu bilgisayarda zaten kurulu olup olmadığı.

İstemi kopyalayın, iki boşluğu doldurun, yapıştırın

İstem aşağıdaki kod bloğudur — tüm bloğu seçin ve kopyalayın.

İki yer tutucu seçimlerinizi ister. <APP_URL>'yi pencerenin yüklemesi gereken arka uç adresiyle değiştirin — yerel arka uç için http://localhost:3000 veya verilen HTTPS adresiniz. <TOOLCHAIN: present | install>'yi rustc ve cargo zaten sürümleri yazdırıyorsa present ile, aracının önce Rust ve OS derleme araçlarını kurması gerekiyorsa install ile değiştirin. Numaralı adımlar yazıldığı gibi kalır.

Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

Ajan istemle ne yapar

İstem, aracıya haritayı, kuralları ve güvenlik kontrol listesini gösterir, ardından kurulumu sırayla yapmasını ve her aşamayı kanıtlamasını söyler. Basitçe söylemek gerekirse, aracı:

• Hiçbir şeye dokunmadan önce depo haritasını (llms.txt), proje kurallarını (AGENTS.md) ve kimlik bilgisi işleme kurallarını (docs/agent-security.md) okur.
• Rust araç zincirini ve bu işletim sisteminin Tauri ön koşullarını kontrol eder ve bir derlemenin ortasında başarısız olmak yerine neyi kuracağını raporlar.
• Arka ucun adresinizde yanıt verdiğini doğrular — yalnızca bu checkout'ta apps/web klasörü varsa kendisi başlatır — orada olmayan bir sunucuyu varsaymak yerine.
• Bağımlılıkları yükler, kabuğu derler ve pencereyi açar, ardından pencere, tepsi ve çağrı kısayolu davranışını gerçek çıktıyla raporlar.
• Aynı adım iki kez başarısız olduktan sonra durur ve raporlar — bir hatayı atlamaz veya sormadan bir şey silmez.

Ajanın raporunda neyi kontrol edersiniz

İyi bir rapor kanıt gösterir, iddia değil. Her PASS'in arkasında yanıt veren arka uç URL'sini, tamamlanmış bağımlılık kurulumunu, bitmiş bir Rust derlemesini ve açılmış bir pencereyi arayın — 'her şey çalışıyor' gibi bir cümleyi değil.

İstem, aracıya aynı adım iki kez başarısız olduktan sonra durmasını ve raporlamasını — hatayı atlamamasını — ve yıkıcı bir şey yapmadan önce sormasını söyler. Aracınız tekrarlanan başarısızlıklardan sonra doğaçlamaya devam ederse, onu durdurun ve ilk hatayı sorun giderme kılavuzuna götürün.

İki şey asla görünmemelidir: bir hatayı susturmak için kapatılmış bir güvenlik özelliği ve sohbete ya da rapora yazdırılmış parola veya anahtar gibi gizli bir değer. Bunlardan birini görürseniz, çalıştırmayı başarısız sayın.

Kabuğu ve gerçek oturum açmayı zihninizde ayrı tutun. Arka ucunuzun ana sayfasını gösteren pencere kabuğu kanıtlar — gerçek hesaplar hâlâ arka ucun veritabanına ihtiyaç duyar. 'Pencere açıldı' henüz 'hesaplar çalışıyor' değildir.

Elle yapmayı tercih ederseniz

Aracının çalıştırdığı her adım aşağıdaki manuel kılavuzlarda yazılıdır — aynı komutlar, aynı kontroller, sizin hızınızda.

• Desktop uygulamasını 5 dakikada çalıştırın
• Tam kabuk kurulumunu okuyun
• Bir kurulum hatasını düzeltin