Ana içeriğe atla

Yerel komutları güvenle çalıştırma

Masaüstü uygulamasında asistan, sohbetinizin çalışma klasöründe komutlar ve testler çalıştırabilir. Bunun sohbette nasıl çalıştığını Yerel dosya erişimi sayfasında okuyabilirsiniz. Bu sayfada bunun ne zaman sormadan yapılabileceğini ve komutların ne kadar yalıtılmış çalışacağını ayarlarsınız.

Komut ayarlarını açma​

Bir sohbette Komutlar panelini açın ve Bu klasör için komut ayarları seçeneğini seçin. Ayarlar klasör bazında geçerlidir.

Asistan bir komutu ne zaman çalıştırabilir?​

Şu üç moddan birini seçin:

  • Her zaman sor: her komutu siz onaylarsınız.
  • Güvenilen komutlar otomatik: kaydettiğiniz komutlar sormadan başlar. Diğer komutlar yine izin ister.
  • Korumalı alanda otomatik: her şey sormadan başlar, ancak yalıtılmış bir ortamda.

Her modda şu kurallar da geçerlidir:

  • Zararsız komutlar kart olmadan başlar: mkdir, ls, cat, head, tail, wc, grep, find (-exec veya -delete olmadan), touch, pwd, tree ve sürüm denetimleri (node, npm, npx, python, pip ve aischool-python için --version, -v veya -V). Bunlar, yerleşik dosya araçlarının zaten sormadan yaptığından fazlasını yapmaz. Korumalı alanda, ağ olmadan ve yalnızca çalışma klasörü içindeki yollarla, bağlantılar izlendikten sonra da, çalışır (mutlak yol, ~ veya .. olmadan). Bir bağlantı klasörün dışını gösteriyorsa yine bir kart görünür. Bunun için korumalı alan (macOS ve Linux) ve yerel komutlar gerekir; yöneticinin Otomatik çalıştırmaya izin ver ayarı gerekmez. Komutlar panelinde bu durumda Otomatik (zararsız komut) görünür. mkdir -p src/{components,utils} gibi süslü parantez içindeki bir liste de kartsız başlar: uygulama bunu ayrı yollara çevirir ve her birini denetler.
  • Her kart tam komutu ve çevrimiçi eylemlerde tam adresi gösterir. Altında daha küçük olarak asistanın açıklaması yer alır.
  • Korumalı alan kullanılabiliyorsa ve yöneticiniz otomatik çalıştırmaya izin veriyorsa, korumalı alanda çalışan bir komutun kartında ayrıca Bundan sonra bu klasörde otomatik olarak korumalı alanda düğmesi bulunur. Bu düğme klasörü Korumalı alanda otomatik moduna geçirir; sonraki komutlar kart olmadan başlar. Ağ gerektiren komutlar, paket kurulumlarına izin verilmediği sürece yine bir kez sorar.
  • Bir klasörde korumalı alanda çalışan ve ağ istemeyen ilk kart bir kez Bu projeye güven düğmesini gösterir. Bu düğme komutu çalıştırır, klasörü Korumalı alanda otomatik moduna alır ve Paket kurulumlarına sormadan izin ver seçeneğini açar. Ardından npm test, npm run build ve node --test gibi testler ve derlemeler kartsız, ağ olmadan korumalı alanda başlar. Başka bir şey için ağ gerektiren veya korumalı alanın dışında çalışan komutlar sormaya devam eder. Çalıştır veya Reddet seçiminden sonra soru bu klasörde bir daha gelmez; modu komut ayarlarından değiştirirsiniz. Otomatik çalıştırma kapalıysa her kart bunun yöneticinizden mi yoksa bu bilgisayarın cihaz politikasından mı kaynaklandığını belirtir.

Güvenilen komutları kaydetme​

Bir komutta Bu klasörde her zaman izin ver ve ardından Tam olarak bu komut veya Bununla başlayan her şey seçeneğini seçin. Kaydedilen komutlar bundan sonra sormadan başlar. Özel karakterler içeren komutlar (örneğin ; | > $) her zaman izin ister.

Kaydedilen kurallar, komut ayarlarında Bu klasörde her zaman izinli altında listelenir. Onları orada yeniden kaldırabilirsiniz.

Korumalı alan ve ağ​

  • Korumalı alanı kullan: komutlar yalnızca bu klasöre yazabilir. Bu seçenek macOS ve Linux'ta varsayılan olarak açıktır.
  • Ağa izin ver: komutların internete erişip erişemeyeceğini belirler. Bu seçenek varsayılan olarak kapalıdır. Korumalı alan olmadan komutların her zaman ağ erişimi vardır.

Her komut kartı, korumalı alanın ve ağın açık olup olmadığını gösterir.

Ağa izin ver kapalıyken asistan bir şey indirmek isterse, örneğin npm install ile, komut kartı tam olarak bu komutu ağ erişimiyle çalıştırmak isteyip istemediğinizi sorar. Yani ağı tüm klasör için açmanız gerekmez.

Windows

Windows'ta henüz korumalı alan kullanılamıyor.

Paket yükleme​

Uygulama, npm içeren kendi Node.js'ini beraberinde getirir. Bu sayede node, npm ve npx gibi komutlar, bilgisayarınızda Node.js yüklü olmasa da çalışır. Node.js'i kendiniz yüklediyseniz uygulama o sürümü kullanır. İstisna: Electron'u kendisi başlatan bir proje (electron .), kendi yüklediğiniz bir Node.js gerektirir.

Paket kurulumlarına sormadan izin ver​

Bu klasör için komut ayarları içinde Paket kurulumlarına sormadan izin ver anahtarını açın. Bu durumda adı belirtilen paketlerin kurulumları kart göstermeden başlar: npm install <ad> ve package.json üzerinden npm install, install veya add ile pnpm, yarn ya da bun ve pip install <ad> (uv üzerinden de). Bunlar her zaman korumalı alanda, ağ erişimiyle çalışır. Diğer komutlar, klasör için seçtiğiniz modu izler.

Şu kurulumlar yine kart gösterir:

  • npm create vite@latest ve npx create-… gibi proje başlatıcılar, çünkü kendi kodlarını çalıştırırlar;
  • pip install ., pip install -r requirements.txt, başka bir kayıt defterinden kurulumlar (--registry, -i, --index-url) ve bir git adresinden, URL'den veya yoldan gelen paketler.

Bu anahtar yalnızca korumalı alanla (macOS ve Linux) ve yöneticiniz otomatik çalıştırmaya izin veriyorsa çalışır. Aksi halde onu açamazsınız.

Kurulum betikleri yok

Bu şekilde yüklenen paketler kendi kurulum betiklerini hiçbir zaman çalıştırmaz (npm --ignore-scripts ile çalışır). Python paketleri yalnızca hazır wheel paketleri olarak yüklenir.

Yerel sunucular ve yerleşik tarayıcı​

Asistan, çalışmaya devam eden bir geliştirme sunucusu da başlatabilir; örneğin Vite ile küçük bir React projesi için npm run dev. Diğer komutlarla aynı kurallar geçerlidir: tam komutu onaylarsınız ya da komut kaydedilmiş bir kuralla veya korumalı alanda otomatik olarak başlar. Kartta en uzun süre yerine "Siz durdurana kadar yerel sunucu olarak çalışmaya devam eder." yazar.

Sunucu, asistan yanıt verdikten sonra da çalışmaya devam eder. Komutlar panelinde kart, Tarayıcıda aç ve Durdur düğmeleriyle birlikte Sunucu çalışıyor durumunu gösterir. Aynı anda en fazla 4 sunucu çalışabilir. Sunucular, siz durdurduğunuzda veya uygulamadan çıktığınızda durur.

Ağ erişimi olmayan korumalı alanda bir sunucu yalnızca bu bilgisayarda (localhost) dinleyebilir. Asistanın paketleri nasıl yüklediğini Paket yükleme bölümünde okuyabilirsiniz.

Basit bir web sayfası gösterme​

Normal bir web sayfası için (derleme adımı olmayan, CSS ve JavaScript içeren bir index.html) komut gerekmez. Asistan bu durumda uygulamanın yerleşik web sunucusunu kullanır:

  • Klasör yalnızca bu bilgisayarda, rastgele bir bağlantı noktasıyla http://127.0.0.1 adresinde görünür.
  • .git ve .env gibi gizli dosyalar hiçbir zaman gösterilmez.
  • Bir dosya değiştiğinde sayfa otomatik olarak yeniden yüklenir.

Bunun için onay kartı görünmez. Sunucu, Komutlar panelinde Tarayıcıda aç ve Durdur düğmeleriyle yer alır ve en fazla 4 sunucu sınırına dahil edilir.

Sonucu yerleşik tarayıcıda görürsünüz: üst çubuğun sağındaki Tarayıcı düğmesi (dünya simgesi). Panel sohbetin yanında açılır; geri, ileri, yeniden yükle (yüklenirken durdur), bir adres çubuğu ve Varsayılan tarayıcınızda açın içerir.

  • Asistan, yerel bir sunucunun sonucunu göstermek için tarayıcıyı kendisi açar. Bu yalnızca http://localhost:5173 gibi yerel adreslerle çalışır.
  • Bir yanıttaki localhost bağlantısına tıklarsanız bağlantı yerleşik tarayıcıda açılır. Diğer bağlantılar varsayılan tarayıcınızda açılır.
  • Herhangi bir web adresini kendiniz de yazabilirsiniz.
  • Tarayıcının kendine ait ayrı bir oturumu vardır: orada AI-Public hesabınızla oturum açmış olmazsınız, web siteleri kamera veya mikrofon gibi izinler alamaz ve dosya indirilemez.
  • Uygulamanın bir menüsü veya iletişim kutusu açıkken sayfa geçici olarak gizlenir.

Örnek:

Bu klasörde Vite ile sayaç içeren küçük bir React uygulaması oluştur. Bağımlılıkları yükle, geliştirme sunucusunu başlat ve sonucu tarayıcıda göster.

Asistanın sayfaya bakması​

Asistandan yerleşik tarayıcıdaki sayfaya bakmasını istediğinde adresi, başlığı, görünen metni, bir ekran görüntüsünü ve sayfanın son hata mesajlarını okur. Bunlar yapay zekâ modeline gider.

  • Bu bilgisayardaki bir sayfaya (localhost veya 127.0.0.1) asistan sormadan bakar.
  • Başka her web sitesinde, örneğin oturum açtığın bir sayfada, asistan önce bir kart gösterir: "Asistan onedrive.live.com sayfasına bakmak istiyor." Görüntülemeye izin ver veya Reddet düğmesine tıkla. Her seferinde yeniden sorar.
  • İzin verdikten sonra sayfa başka bir siteye geçerse asistan hiçbir şey okumaz.
  • Asistan yalnızca bu bilgisayardaki bir sayfada, yaptığını test etmek için kendisi tıklar ve yazar. Diğer web sitelerinde tıklamaz, yazmaz, gezinmez. Çerez veya parola almaz.
  • Çevrimdışı modda asistan yalnızca bu bilgisayardaki sayfalara bakar.

Sürümler ve GitHub​

Asistanın yerleşik bir git'i vardır. Bu yüzden git'i yüklemeniz gerekmez, Windows'ta bile. Asistan sürümleri kaydedebilir, nelerin değiştiğini gösterebilir, dal (branch) oluşturabilir ve bir projeyi çevrimiçi yayımlayabilir.

  • Bu klasördeki eylemler, örneğin bir sürümü kaydetmek, sormadan başlar. Gizli bilgiye benzeyen dosyalar (.env dosyaları, koddaki anahtarlar veya token'lar ve AIza ile başlayan Google API anahtarları gibi) hiçbir zaman bir sürüme girmez. Asistan bir şeyi atladığında bunu bildirir.
  • Çevrimiçi eylemler (bir projeyi indirmek, en yeni sürümü almak, çevrimiçi yayımlamak ve bir GitHub deposu oluşturmak) önce tam adresi ve Uygulamaya yerleşik ile Ağ açık etiketlerini içeren bir kart gösterir. Adres github.com değilse veya yeni bir depo herkese açık olacaksa kart uyarır. Çevrimiçi yayımlarken kart hangi dosyaların gönderileceğini gösterir. Çalıştır veya Reddet seçeneğini seçin.
  • github.com dışındaki bir depoyu bağlamak da önce izin ister.

GitHub'ı nasıl bağlayacağınızı ve bir projeyi nasıl çevrimiçi yayımlayacağınızı Vibe coding sayfasında okuyabilirsiniz.

Çevrimdışı mod

Çevrimdışı modda komutlar her zaman korumalı alanda, ağ olmadan çalışır. Ağ gerektiren paket kurulumları ve yerleşik git’in çevrimiçi işlemleri (indirme, çekme, gönderme ve GitHub) bu durumda çalışmaz. Sürüm kaydetme ve basit bir web sayfası gösterme çalışmaya devam eder.

Yöneticiler için ayarlar​

Yöneticiler, ortamdaki herkes için yerel komutları veya otomatik çalıştırmayı kapatabilir. Bunu yönetim ortamında Özellikler bölümünde (ortam düzeyinde), Masaüstü uygulaması kartında yaparlar:

  • Yerel komutlara izin ver: bu kapalıysa asistan komut çalıştıramaz. Yerleşik git'in çevrimiçi eylemleri de bu durumda çalışmaz. Sürüm kaydetme ve dallar ise çalışmaya devam eder: bunlar, dosya araçları gibi yalnızca klasördeki dosyaları değiştirir.
  • Otomatik çalıştırmaya izin ver: bu kapalıysa her komut izin ister ve Paket kurulumlarına sormadan izin ver seçeneğini açamazsınız.
  • Office dosyaları için uygulamanın Python’una izin ver: şablonlar, grafikler ve analizler için. Bu Python internet olmadan çalışır, yalnızca çalışma klasörüne yazar ve başka programları başlatamaz. Hiçbir ayar yapılmamışsa Yerel komutlara izin ver ayarını izler. Korumalı alan olmadan (Windows) yalnızca yerel komutlar açıksa kullanılabilir ve her seferinde izin ister.

Bu sayfada