Verdent Docs
Yürütme modları ve izinler

Yürütme modları ve izinler

Farklı yürütme modlarını ve bunları ne zaman kullanacağınızı anlama


Verdent for VS Code, yapay zekanın dosyalarınızla nasıl etkileşime girdiğini ve komutları nasıl çalıştırdığını kontrol eden birden fazla yürütme modu sunar. Her mod; kontrol, hız ve güvenlik arasında farklı dengeler sağlar.

Neler öğreneceksiniz

  • Her yürütme modunun nasıl çalıştığı ve ne zaman kullanılacağı
  • İzin modelleri ve güvenlik hususları
  • Mod karşılaştırması ve geçiş stratejileri
  • Karmaşık akıl yürütme görevleri için Think Hard Mode

Kullanılabilen temel modlar

Manual Accept Mode

Korumalı her işlem için izin isteyen varsayılan mod. Maksimum kontrol ve denetim.

Auto-Run Mode

Otomatik dosya işlemleri, komutlar için izin gerekir. Hız ile güvenliği dengeler.

Skip Permission Mode

İzole ortamlar için tam özerklik. Hiçbir şey için izin istemi yok.

Plan Mode

Salt okunur planlama modu. Yürütme başlamadan önce planın tamamını inceleyin.


Yürütme modları

Manual Accept Mode, dosya değişiklikleri ve komut yürütmesi üzerinde kontrol sağlayan varsayılan yürütme modudur.

Otomatik işlemler:

  • Dosya okuma ve kod analizi
  • Dizin gezme

İzin gerektirir:

  • Dosya düzenleme (oluşturma, değiştirme, silme)
  • Komut yürütme (terminal komutları, testler, derlemeler)

Verdent korumalı bir işlem yapması gerektiğinde, gerçekleştirmek istediği eylemi ve hangi dosya/komutun söz konusu olduğunu gösterir. Her işlemi Accept veya Reject edebilirsiniz.

Önemli: Her izin yalnızca o belirli işlem içindir. Manual Accept Mode, oturum boyunca korumalı her işlem için onay gerektirir.

Ne zaman kullanılır

  • Verdent'in yeteneklerini ve iş akışı kalıplarını öğrenirken
  • Dikkatli denetim gerektiren tanıdık olmayan kod tabanlarında çalışırken
  • Üretim koduna veya güvenlik açısından hassas alanlara yapılan kritik değişikliklerde
  • Açık onay izleri gerektiren uyumluluk gereksinimlerinde

Etkinleştirme

Manual Accept Mode varsayılan olarak etkindir. Geri dönmek için:

İzin menüsünü açın

Giriş Kutusu'ndaki "Switch Permission" düğmesine tıklayın

Manual Accept Mode'u seçin

Açılır menüden "Manual Accept Mode" seçeneğini seçin

Etkinleşmeyi doğrulayın

Modun etkin olduğunu doğrulamak için düğmede "Manual" görüntülenir

Güvenlik hususları

Avantajlar:

  • Araç türü başına ilk kullanımda onay (dosya düzenlemeleri, komutlar, araçlar)
  • Erişim vermeden önce tam görünürlük
  • Maksimum kontrol ve şeffaflık

Sınırlamalar:

  • Bir araç türünün ilk onayından sonra, sonraki kullanımlar istem olmadan devam eder
  • Onay her işlem için değil, araç türü başınadır
  • Kritik kod üzerinde çalışırken araç onaylarını sıfırlamak için yeni oturumlar başlatın

Auto-Run Mode, dosya işlemlerini otomatik olarak onaylarken komutlar için izin gerektirir. Bu, riskli işlemler için güvenliği korurken rutin dosya çalışmalarındaki izin istemlerini azaltır.

Otomatik:

  • Çalışma alanı içinde dosya okuma, düzenleme, oluşturma, silme
  • Çalışma alanı içinde dosyaları taşıma, yeniden adlandırma, düzenleme
  • Dosya arama ve gezinme işlemleri

İzin gerektirir:

  • Geçerli çalışma alanı dışındaki yolları içeren herhangi bir komut
  • Tehlikeli bash komutları: rm -rf, git commit, git push vb.
  • Komut yürütme (terminal, betikler, derlemeler)
  • Paket kurulumu ve sistem değişiklikleri

Ne zaman kullanılır

Auto-Run şu durumlarda kullanınŞu durumlarda kullanmayın
Sürüm kontrolü olan güvenilir kod tabanlarıTanıdık olmayan kod tabanı
Hızlı prototipleme ve denemeKritik üretim kodu
Çok dosyalı yeniden düzenleme (15+ dosya = 15 istem tasarrufu)Sürüm kontrolü güvenlik ağı yok
Kesintileri en aza indiren odaklı geliştirmeUyumluluk gereksinimleri

Etkinleştirme

İzin menüsünü açın

Geçerli modu gösteren "Switch Permission" düğmesine tıklayın

Auto-Run Mode'u seçin

Açılır menüden "Auto-Run Mode" seçeneğini seçin

Etkinleşmeyi doğrulayın

Modun etkin olduğunu doğrulamak için düğmede "Auto" görüntülenir

Oturumlar ve VS Code yeniden başlatmaları boyunca kalıcıdır. Tüm çalışma alanlarına genel olarak uygulanır.

Örnek iş akışı

POST /api/tasks uç noktası oluşturma:

  1. Auto-Run Mode'u etkinleştirin
  2. Gönderin: "Kategorinin var olduğunu doğrulayan ve veritabanına kaydeden bir POST /api/tasks uç noktası oluştur"
  3. Verdent 5+ dosya okur, 3 dosyayı otomatik olarak değiştirir (istem yok)
  4. Değişiklikleri Source Control panelinde inceleyin
  5. Test isteyin: "Tasks API için testleri çalıştır"
  6. npm test komutu için izin istemi - Accept
  7. Doğrulama ekleyin: "Boş başlıklar için doğrulama ekle"
  8. Verdent otomatik olarak düzenler (istem yok)
  9. Tekrar test isteyin - İzin istemi - Accept
  10. Diff'leri inceleyin, değişiklikleri commit edin

Sonuç: 3 komut istemi, 0 dosya istemi. Manual Accept 4 ek dosya istemi gerektirirdi.

Güvenlik hususları

Avantajlar:

  • Değişiklikler VS Code'da anında görünür
  • Çalışma alanı kapsamlı (sistem dosyalarını etkileyemez)
  • Git geri alma güvenliği sağlar

Riskler:

  • Dosya işlemi denetimi yok
  • Beklenmedik kapsam ("User'ı Account olarak yeniden adlandır" onlarca dosyayı değiştirebilir)
  • Temizlik sırasında dosya silme olası
  • İstendiğinde hassas dosyaları değiştirebilir

Önlem:

  • Net, belirli istemler kullanın
  • Tamamlamalardan sonra Source Control panelini inceleyin
  • Temiz kontrol noktaları için sık sık commit yapın
  • Karmaşık işlemler için önce Plan Mode'u kullanın
  • Hassas dosyaları korumak için .gitignore yapılandırın

Skip Permission Mode tüm izin istemlerini atlayarak tam özerklik sağlar. Yalnızca izole, atılabilir ortamlarda kullanın.

Tüm işlemler otomatik:

  • Dosya işlemleri
  • Komut yürütme
  • Paket kurulumu
  • Sistem düzeyinde işlemler

Bu mod tüm güvenlik korumalarını kaldırır. Yalnızca hataların hiçbir sonucu olmadığı tamamen izole, atılabilir ortamlarda kullanın. Üretimde veya önemsediğiniz herhangi bir kod tabanında asla kullanmayın.

Ne zaman kullanılır

Skip Permission şu durumlarda kullanınASLA şunlar için kullanmayın
İzole konteynerlerde otomatik CI/CD işlem hatlarıÜretim ortamları
Atılabilir geliştirme konteynerleri (deneme sonrası silinir)Önemli kod içeren geliştirme ortamları
Üretim bağlantısı olmayan sanal alan ortamlarıÖnemsediğiniz herhangi bir kod tabanı
İnsan onayının amacı boşa çıkardığı betikli iş akışlarıPaylaşılan depolar
Hassas veri içeren ortamlar

Etkinleştirme

İzin menüsünü açın

"Switch Permission" düğmesine tıklayın

Skip Permission Mode'u seçin

Açılır menüden "Skip Permission Mode" seçeneğini seçin

Etkinleşmeyi doğrulayın

Modun etkin olduğunu doğrulamak için düğmede "Skip" görüntülenir

Etkinleştirmeden önce güvenlik kontrolü:

  • Bu atılabilir bir konteyner veya VM mi?
  • Bu ortam herhangi bir sonuç olmadan silinebilir mi?
  • Burada herhangi bir üretim veya önemli kod var mı?

İlk ikisine "hayır" veya üçüncüsüne "evet" ise, etkinleştirMEYİN.

Güvenlik uyarıları

TÜM güvenlik korumaları kaldırılır:

  • Komutlar sistem izinleriyle anında yürütülür
  • Dosyalar uyarı olmadan değiştirilebilir veya silinebilir
  • Veritabanı işlemleri, Git işlemleri (force push dahil) onay olmadan devam eder
  • Kötü amaçlı paketler kurabilir veya kimlik bilgilerini açığa çıkarabilir

Yalnızca şu durumlarda güvenlidir:

  • Ortam tamamen atılabilir
  • Önemli kod veya veri yok
  • Üretim sistemlerine bağlantı yok
  • Her şeyin yok edilebileceğini kabul ediyorsunuz

Plan Mode

Plan Mode, Verdent'in kodu analiz ettiği, ayrıntılı planlar oluşturduğu ve açıklayıcı sorular sorduğu, ancak siz onaylayana kadar dosyaları değiştiremediği veya komutları yürütemediği salt okunur bir etkileşim modudur.

Nasıl çalışır

  1. Analiz - Dosyaları otomatik olarak okur
  2. Planlama - Yapılacaklar listesiyle yapılandırılmış plan oluşturur
  3. Açıklama - Belirsizliği gidermek için sorular sorar
  4. Onay - İncelersiniz ve devam etmeye karar verirsiniz
  5. Yürütme - Yürütmek için izin modunuza geçer

Plan, değiştirilecek dosyaları, uygulama adımlarını, bağımlılıkları ve doğrulama stratejisini gösterir.

Ne zaman kullanılır

  • Karmaşık çok dosyalı değişiklikler (taahhütte bulunmadan önce kapsamı anlayın)
  • Tanıdık olmayan kod tabanları (risk olmadan güvenli keşif)
  • Mimari kararlar (uygulamadan önce yaklaşımı inceleyin)
  • Manual Accept yorgunluğundan kaçınma (50 ayrı istem yerine bir kez inceleme)
  • Yüksek riskli üretim değişiklikleri (yürütmeden önce tam görünürlük)

Etkinleştirme

Mod menüsünü açın

Giriş Kutusu'ndaki "Switch Mode" düğmesine tıklayın

Plan Mode'u seçin

Açılır menüden "Plan Mode" seçeneğini seçin

Etkinleşmeyi doğrulayın

Modun etkin olduğunu doğrulamak için mod göstergesi "Plan" olarak değişir

Etkin olduğunda Verdent analiz yapar ve planlar oluşturur, ancak siz onaylayana kadar dosyaları değiştirmez veya komutları yürütmez. Onaydan sonra varsayılan izin modunuza (Manual Accept veya Auto-Run) geçer.

Güvenlik hususları

Avantajlar:

  • Planlama sırasında sıfır yürütme riski
  • Taahhütte bulunmadan önce tam görünürlük
  • Etkileşimli açıklama belirsizliği giderir
  • Üretim analizi için güvenli

Sınırlamalar:

  • Onay doğruluğu garanti etmez (planlarda mantıksal hatalar olabilir)
  • Yürütme güvenliği, onaydan sonra seçilen izin moduna bağlıdır
  • Plan kalitesi istemin netliğine bağlıdır

En iyi uygulamalar:

  • Planları mantıksal hatalar veya yanlış anlamalar açısından inceleyin
  • Belirsizse takip soruları sorun
  • Yürütmeyi onaylamadan önce istemleri iyileştirin
  • Hangi izin modunun yürüteceğini düşünün (denetim için Manual Accept, hız için Auto-Run)

Think Hard Mode

Think Hard Mode, karmaşık akıl yürütme görevleri için maksimum hesaplama kaynağı tahsis eder. Model birden fazla yaklaşımı keşfeder ve daha kapsamlı çözümler sunar.

Özellikler:

  • Uzatılmış akıl yürütme süresi
  • Birden fazla çözüm yaklaşımının daha derin analizi
  • Karmaşık mantık, uç durumlar ve mimari kararların daha iyi ele alınması
  • İstek başına daha yüksek kredi maliyeti

Ne zaman kullanılır

Think Hard Mode şu durumlarda kullanınŞu durumlarda kullanmayın
Birden fazla dengelemeli karmaşık mimari kararlarBasit, anlaşılır görevler
Birden fazla olası nedeni olan karmaşık hata ayıklamaZaman açısından kritik istekler
Optimizasyon analizi gerektiren algoritma tasarımıSınırlı kredi bütçesi
Doğruluğun çok önemli olduğu kritik iş mantığıStandart modun yeterli olduğu durumlar
Karmaşık darboğazların performans optimizasyonu

Etkinleştirme

İstek başına etkinleştirme için UI düğmesini kullanın:

Think Hard'ı etkinleştirin

Giriş Kutusu'ndaki "Think Hard" düğmesine/anahtarına tıklayın

İsteminizi gönderin

İsteğinizi yazın ve gönderin

Yalnızca tek istek

Yalnızca o belirli isteğe uygulanır - kalıcı değildir

Tüm yapay zeka sağlayıcılarıyla çalışır. Kalıcı değildir - derin akıl yürütme gerektiren istekler için her seferinde etkinleştirilmelidir.

İsteminize düşünme anahtar kelimeleri ekleyin:

Think: Design the optimal database schema for this multi-tenant SaaS application

Veya maksimum akıl yürütme için:

Ultrathink: Analyze the trade-offs between different authentication approaches

"Think" ve "ultrathink" Claude modeline özgü yeteneklerdir. Bu anahtar kelimeler Claude modellerinde (Sonnet, Opus) daha derin akıl yürütmeyi etkinleştirir, ancak diğer yapay zeka sağlayıcılarıyla (GPT-5, MiniMax) çalışmayabilir.

Yalnızca istek başına etkinleştirme - Manual Accept veya Auto-Run gibi kalıcı değildir.


Mod karşılaştırması

ModKontrolHızEn uygunŞu durumda kaçının
Manual AcceptMaksimumEn yavaşÖğrenme, tanıdık olmayan kod, kritik değişikliklerGüvenilir projeler, hızlı yineleme
Auto-RunOrtaHızlıGüvenilir kod tabanları, prototipleme, çok dosyalı çalışmaTanıdık olmayan kod, sürüm kontrolü yok
Skip PermissionYokEn hızlıCI/CD, atılabilir konteynerler, sanal alanlarÜretim, önemli kod
Plan ModeÖnce incelemeYokKarmaşık değişiklikler, mimari kararlarBasit görevler
Think Hardİstek başınaDaha yavaşKarmaşık akıl yürütme, algoritmalar, kritik mantıkBasit görevler, zaman açısından kritik

Her modu ne zaman kullanmalı

SenaryoManual AcceptAuto-RunSkip PermissionPlan Mode
Verdent'i öğrenme
Tanıdık olmayan kod tabanı
Git'li güvenilir kod tabanı
Kritik/üretim kodu
Hızlı prototipleme
Çok dosyalı yeniden düzenleme
Karmaşık mimari planlama
CI/CD işlem hatları (izole)
Atılabilir konteynerler
Uyumluluk gereksinimleri

Güvenlik en iyi uygulamaları

Güvenlik hiyerarşisi (en güvenliden en az güvenliye)

Her modun güvenlik sıralamasını anlamak, farklı risk seviyeleri için uygun seçimi yapmanıza yardımcı olur.

  1. Plan Mode - Onaylanana kadar salt okunur. Planlama sırasında sıfır yürütme riski.
  2. Manual Accept Mode - Araç türü başına ilk kullanımda onayla işlem bazında kontrol.
  3. Auto-Run Mode - Komut onaylı dosya özerkliği. Git güvenlik ağı gerekir.
  4. Skip Permission Mode - Tam özerklik. Yalnızca izole ortamlar.

Modunuzu risk seviyesine eşleyin: kritik kod en güvenli modları kullanır (Plan, Manual Accept), güvenilir kod daha hızlı modları kullanır (Auto-Run), atılabilir ortamlar en hızlı modu kullanır (Skip Permission).

Genel en iyi uygulamalar

Hangi yürütme modunu kullandığınızdan bağımsız olarak geçerli olan temel uygulamalar.

Tüm modlar için:

  1. Sürüm kontrolü kullanın - İzin verici modları kullanmadan önce Git'i başlatın, sık sık commit yapın, commit etmeden önce diff'leri inceleyin
  2. Net istemler yazın - Kapsam konusunda belirli olun, dosya sınırlarını açıkça belirtin, bağlam için @-mention kullanın
  3. Commit etmeden önce inceleyin - Tamamlamalardan sonra Source Control panelini kontrol edin, tüm diff'leri dikkatlice inceleyin, değişiklikleri test edin
  4. Yeni oturumlar başlatın - Büyük görevler arasında bağlamı temizleyin, hassas çalışmalar için araç onaylarını sıfırlayın, bağlam kirlenmesinden kaçının
  5. Modu riske eşleyin - Kritik kod → Manual Accept veya Plan Mode, güvenilir kod → Auto-Run, denemeler → Git'li Auto-Run, atılabilir → yalnızca Skip Permission

Güvenlik hatırlatmaları:

  • Hassas dosyaları (.env, kimlik bilgileri) asla commit etmeyin
  • Auto-Run kullanmadan önce .gitignore yapılandırın
  • Komut izinlerini dikkatlice inceleyin
  • Güvenliği etkileyen değişiklikler için Plan Mode'u kullanın
  • Yeni oturumlar Manual Accept'te araç onaylarını sıfırlar
Progressive Permission Model

Verdent'in izin sisteminin nasıl çalıştığını anlamak, onu etkili bir şekilde kullanmanıza yardımcı olur.

Nasıl çalışır:

  1. İlk kullanım - Her araç türünü (dosya düzenlemeleri, komut yürütmeleri, araç kullanımı) ilk kullandığınızda sistem izin ister
  2. Sonraki kullanımlar - İlk onaydan sonra, o araç türü oturumun geri kalanında istem olmadan devam eder
  3. Yeni oturum - Yeni bir oturum başlatmak tüm onayları sıfırlar ve sıfırdan başlamanıza olanak tanır

Temel ilke: Bu model güvenliği üretkenlikle dengeler. Araç türlerini bir kez inceleyip onaylar, ardından o onay bağlamında verimli bir şekilde çalışırsınız. Hassas çalışmalar için onayları sıfırlamak üzere yeni bir oturum başlatın.

Onayları sıfırlamak için: Yeni bir oturum başlatın


Ayrıca bakın