Hızlı başlangıç kılavuzu

Bu hızlı başlangıç kılavuzu, 15 dakikadan kısa sürede Verdent'in Plan-Verify-Code iş akışını kullanmanızı sağlayacak. Uzantıyı yükleyecek, ilk görevinizi tamamlayacak ve Verdent for VS Code ile çalışırken temel iş akışını anlayacaksınız.

Neler öğreneceksiniz

Verdent for VS Code'u marketplace'ten yükleme
Kimlik doğrulama yapma ve kurulumunuzu doğrulama
İlk yapay zeka destekli görevinizi tamamlama
Yürütme modlarını anlama (Manual Accept, Auto-Run, Plan Mode)
Günlük kodlama için temel özellikleri kullanma

Ön koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

Sisteminizde Visual Studio Code yüklü olmalı
Etkin bir internet bağlantısı
Aktif bir Verdent abonelik hesabı (veya 7 günlük ücretsiz denemeyle başlayın)

Adım 1: Verdent'i yükleyin

Verdent uzantısı sayfasını ziyaret edin ve Install düğmesine tıklayın.

Visual Studio Code'u açın
Ctrl+Shift+X tuşlarına basın (veya macOS'ta Cmd+Shift+X)
"Verdent" araması yapın
Install düğmesine tıklayın

code --install-extension verdentai.verdent

Adım 2: Verdent'i kullanmaya başlayın

Visual Studio Code'u açın

Visual Studio Code'u proje klasörünüzde açın.

Verdent'e erişin

Kenar çubuğundaki Verdent simgesine tıklayın veya Ctrl+L (Windows/Linux) / Cmd+L (macOS) tuşlarına basın.

Oturum açın

İstendiğinde Verdent hesabınızla kimlik doğrulaması yapmak için oturum açın.

Adım 3: İlk göreviniz

Verdent'in çalışma alanınızı nasıl anladığını gösteren basit, zarar vermeyen bir görevle başlayalım.

VS Code'da bir proje açın, ardından Verdent giriş kutusunda şu istemlerden birini deneyin:

What kind of project is this?

Verdent çalışma alanınızın yapısını analiz edecek, önemli dosyaları okuyacak ve ne tür bir uygulama üzerinde çalıştığınızı açıklayacak. Bu, herhangi bir değişiklik yapmadan bağlam farkındalığını gösterir.

Şunları görmelisiniz:

Verdent'in çalışma alanınızdaki dosyaları analiz etmesi
Proje türünüzün, teknolojilerinizin ve yapınızın bir özeti
Dosya değişikliği olmaması (salt okunur analiz)

Şu takip istemlerini deneyin:

Explain what this project does

What dependencies does this project have?

Show me the main entry point of this application

Her istem, Verdent'in çalışma alanınıza erişebildiğini ve kod tabanınızı anladığını doğrulamanıza yardımcı olur.

Bu keşif istemleri, tanımadığınız kod tabanlarını anlamak için idealdir. Verdent, bağlamı manuel olarak eklemenizi gerektirmeden dosyaları gerektiği gibi okur.

Adım 4: İlk kod değişikliğinizi yapma

Şimdi Verdent'in bir şeyler oluşturmasını sağlayalım. Şu basit görevi deneyin:

Create a hello_world.txt file with a greeting message

Ne olur:

Verdent değişikliği önerir Oluşturulacak dosyayı ve içeriğini gösteren bir önizleme görürsünüz
İzin isteği Auto Run Mode'da (varsayılan), Verdent dosyayı oluştururken otomatik onay verir
Onaylarsınız "Accept" düğmesine tıklayın veya değişikliği onaylayın
Dosya oluşturulur Verdent dosyayı oluşturur ve tamamlandığını onaylar

İzinleri anlama:

Manual Accept Mode, onayınız olmadan istenmeyen değişikliklerin yapılmamasını sağlar. Şunlar için izin istemleri görürsünüz:

Dosya düzenleme ve oluşturma
Komut yürütme
Araç kullanımı (her araç türünün ilk kullanımı)

Bu, size tam kontrol sağlar ve Verdent'in farklı görevler için hangi işlemleri gerçekleştirdiğini öğrenmenize yardımcı olur.

Manual Accept Mode, yeni kullanıcılar için önerilen başlangıç noktasıdır. Rahat hissettiğinizde farklı iş akışları için Auto-Run Mode'a veya Plan Mode'a geçebilirsiniz.

Adım 5: Karmaşık görevler için Plan Mode'u kullanma

Plan Mode, Verdent'in yürütmeden önce yaklaşımları gözden geçirebileceğiniz salt okunur planlama modudur. Hadi deneyelim:

Plan Mode'a geçin:

Giriş kutusundaki Switch Mode düğmesine tıklayın ve Plan Mode seçeneğini belirleyin

Bir planlama görevini deneyin:

Suggest ways to build a website for my project

Ne olur:

Verdent projenizi analiz eder Dosyaları okur ve proje yapınızı ve gereksinimlerinizi anlar
Ayrıntılı bir plan oluşturur Hangi teknolojilerin kullanılacağını, hangi sayfaların oluşturulacağını ve web sitesinin nasıl yapılandırılacağını gösterir
Değişiklik yapmaz Plan Mode salt okunurdur. Siz açıkça onaylayana kadar Verdent dosyaları değiştiremez
Etkileşimli netleştirme Verdent, planı sonlandırmadan önce tasarım tercihleri, hedef kitle veya özellikler hakkında sorular sorabilir

Plan Mode'u neden kullanmalısınız:

Güvenli keşif - Tanımadığınız kod tabanlarını yanlışlıkla değişiklik yapmadan anlayın
Kod incelemesi - Değişiklik yapmadan önce kaliteyi ve mimariyi analiz edin
Stratejik planlama - Karmaşık görevleri incelenebilir adımlara bölün
Belirsizliği azaltma - Verdent, belirsizliği ortadan kaldırmak için netleştirici sorular sorar

Yürütmeye başlamadan önce yaklaşımı gözden geçirmek istediğiniz herhangi bir görev için Plan Mode'u kullanın. Verdent'in kod tabanınız hakkında nasıl düşündüğünü öğrenirken özellikle değerlidir.

Planı yürütmek için:

Planı gözden geçirdikten sonra Verdent iki seçenek sunar:

Değişiklik istemek veya netleştirici sorular sormak için Edit seçeneğini belirleyin
Agent Mode'a geçmek ve yürütmeye başlamak için Start Building seçeneğini belirleyin

Adım 6: Yürütme modlarını anlama

Verdent, farklı iş akışlarına uyacak şekilde birden fazla yürütme modu sunar:

İzin modları:

Mod	Açıklama	Ne zaman kullanılır
Manual Accept	Her aracın ilk kullanımında izin ister	Maksimum kontrolle öğrenme ve genel geliştirme
Auto-Run (varsayılan)	Güvenli işlemleri otomatik kabul eder (dosya okuma, web aramaları); dosya düzenlemeleri ve komutlar yine de onay gerektirir	Güvenilir projeler ve hızlı prototipleme
Plan Mode	Dosya değişikliği olmadan analiz ve planlama için salt okunur mod	Karmaşık görevler ve kod incelemesi
Skip Permissions	Tüm istemleri atlayan tam özerk çalışma	Otomatik test veya korumalı alanlar gibi izole, güvenli ortamlar

Ek mod:

Think Hard Mode - Karmaşık akıl yürütme ve mimari kararlar için maksimum düşünme bütçesi

Skip Permissions Mode tüm güvenlik kontrollerini kaldırır. Yalnızca hataların sonuç doğurmadığı izole, tek kullanımlık ortamlarda kullanın.

Temel eylemler

Verdent for VS Code'da her gün kullanacağınız temel eylemler şunlardır:

Eylem	Nasıl erişilir	Açıklama
Verdent'i aç	`Cmd+L` / `Ctrl+L` veya kenar çubuğu simgesine tıklayın	Verdent panelini açar
Yeni oturum	Üst çubukta "New Session" tıklayın	Temiz bağlamla yeni bir konuşma başlatın
Bağlam ekle	"Add Context" düğmesine tıklayın	@-mention ile dosyalara referans verin
Görsel ekle	"Add Images or Files" düğmesine tıklayın	Ekran görüntüleri, taslaklar veya diyagramlar yükleyin
Mod değiştir	"Switch Mode" düğmesine tıklayın	Agent/Plan/Chat modları arasında geçiş yapın
Model değiştir	Model seçiciye tıklayın	Performance/Balance/Efficiency hazır ayarlarını seçin
Think Hard	"Think Hard Mode" düğmesine tıklayın	Karmaşık görevler için genişletilmiş akıl yürütmeyi etkinleştirin
İzinleri değiştir	"Switch Permission" düğmesine tıklayın	İzin modunu değiştirin
Geçmişi görüntüle	Üst çubukta "Project History" tıklayın	Geçmiş oturumlara göz atın
Kullanıcı merkezi	Üst çubukta "User Center" tıklayın	Kredi bakiyenizi ve hesap bilgilerinizi kontrol edin
Ayarlar	Üst çubukta "Settings" tıklayın	MCP sunucularını, alt aracıları, kuralları yapılandırın

Yeni başlayanlar için profesyonel ipuçları

Keşif istemleriyle başlayın

Değişiklik yapmadan önce Verdent'in kod tabanınızı anlamasına izin verin:

Analyze the database schema

Explain the authentication flow

Bu, Verdent'in projeniz hakkındaki bağlamını oluşturur ve daha iyi öneriler yapmasına yardımcı olur.

İsteklerinizde açık olun

Şunun yerine: "hatayı düzelt"

Şunu deneyin: "LoginForm.tsx dosyasındaki, kullanıcıların yanlış kimlik bilgileri girdikten sonra boş ekran görmesine neden olan oturum açma hatasını düzelt"

Açık istemler daha doğru çözümlere ve daha az yinelemeye yol açar.

Tanımadığınız kod için Plan Mode'u kullanın

Tam olarak anlamadığınız kodla çalışırken önce Plan Mode'u kullanın:

Refactor the authentication module to use async/await instead of callbacks

Planı gözden geçirin, netleştirici sorular sormak ve iyileştirmek için Edit seçeneğini belirleyin, ardından emin olduğunuzda Start Building seçeneğini belirleyin.

Karmaşık görevleri adımlara bölün

Çok adımlı özellikler için kademeli çalışın:

1. Create a new database table for user profiles

Ardından tamamlandıktan sonra:

2. Create an API endpoint to get and update profiles

Bu, netliği korur ve her adımı doğrulamanıza olanak tanır.

Bağlam için @-mention'lardan yararlanın

Gerektiğinde dosyalara açıkça referans verin:

@components/UserProfile.tsx refactor this component to use hooks

Bu, Verdent'in göreviniz için doğru bağlama odaklanmasını sağlar.

Özel görevler için alt aracıları kullanın

Verdent üç yerleşik alt aracı içerir:

@Explorer - Hızlı kod tabanı keşfi ve dosya bulma
@Verifier - Hızlı kod doğrulama ve kontroller
@Code-reviewer - Kapsamlı güvenlik ve kalite incelemesi

Örnek:

@Explorer find all API endpoints in this project

Sık karşılaşılan sorunlar

Çözüm: VS Code'u yeniden başlatın. Hâlâ eksikse, Uzantılar panelinde (Cmd+Shift+X / Ctrl+Shift+X) kurulumu doğrulayın ve "Verdent" öğesinin listede göründüğünü onaylayın.

Çözüm:

İnternet bağlantısının etkin olduğunu doğrulayın
Güvenlik duvarı/proxy ayarlarının Verdent hizmetlerine HTTPS'ye izin verdiğini kontrol edin
User Center'da kalan krediniz olduğunu onaylayın
Bağlantıyı test etmek için daha basit bir istem deneyin

Çözüm: "Switch Permission" düğmesini kullanarak Auto-Run Mode'a geçin. Bu, güvenli okuma işlemlerini otomatik olarak onaylarken dosya düzenlemeleri ve komutlar için yine de onay ister.

Yardım alma

Discord topluluğu: https://discord.com/invite/NGjXEZcbJq - Gerçek zamanlı destek sunan aktif topluluk
Dokümantasyon: Bu dokümantasyondaki diğer kılavuzlara göz atın
Geri bildirim: Sorunları bildirmek veya iyileştirmeler önermek için Verdent'in üst çubuğundaki Feedback düğmesini kullanın

SSS

Şu anda hangi yürütme modunda olduğumu nasıl bilirim?

Verdent panelinin altındaki giriş kutusuna bakın. "Switch Permission" düğmesi mevcut modunuzu görüntüler (örneğin, "Manual", "Auto", "Plan"). Modları değiştirmek için tıklayabilirsiniz.

Kredilerim biterse ne olur?

Standart kredi tabanlı istekler bakiyeniz sıfıra ulaştığında durur. Devam etmek için bir sonraki faturalandırma döngüsü yenilemenizi bekleyin veya tek seferlik ek kredi yüklemesi satın alın.

Verdent'i aynı anda birden fazla projede kullanabilir miyim?

Evet, her VS Code penceresi bağımsız çalışır. Verdent'i birden fazla projede açık tutabilirsiniz ve her biri kendi ayrı konuşma bağlamını korur.

Temiz bağlamla yeni bir konuşmayı nasıl başlatırım?

Üst çubuktaki "New Session" düğmesine tıklayın. Bu, mevcut konuşma geçmişini temizler ve bir sonraki göreviniz için Verdent'e yeni bir bağlam penceresi verir.