PR Lens ile pull request değişikliklerini görselleştirme

PR Lens, pull request değişikliklerini görselleştiren açık kaynaklı bir AI aracıdır. Kod farkını animasyonlu mimari ve veri akışı diyagramlarına dönüştürüp doğrudan GitHub PR içine yerleştirir; böylece reviewer satırları okumadan önce değişikliğin genel şeklini anlayabilir.

PR Lens ne işe yarar? Basit anlatım

Büyük bir pull request; dosyaları, servisleri, çağrıları ve kaldırılan yolları aynı anda akılda tutmayı gerektirir. PR Lens bu parçaları görsel bir haritada birleştirir. Mimari görünüm eklenen, değiştirilen ve silinen bileşenleri işaretler; değişmeyen komşuları bağlam için gösterir. Veri akışı görünümü ise gerçek bir işlem sırası varsa adımları sırayla canlandırır. Araç değişikliği anlamayı kolaylaştırır, ancak otomatik bug ya da güvenlik açığı bulmaz.

Diyagramlar code review sürecine nasıl yardım eder?

Bileşenler sistem katmanlarını veya sınırlarını temsil eden şeritlerde gruplanır. Reviewer yalnızca değişen dosyaları değil, olası etki alanını da görür. Animasyonlu akış endpoint, kuyruk, worker veya entegrasyon değişikliklerini sırayla takip etmeyi kolaylaştırır. Tam boy canvas üzerinde yakınlaştırma, kaydırma, açık-koyu tema ve rehberli walkthrough bulunur. SVG çıktısında JavaScript yoktur ve doğrulanmış tipli belge aynı sonucu deterministik biçimde üretir.

Dört farklı kullanım yolu

GitHub App en az kurulum isteyen seçenektir: depoları seçersiniz, her PR için tek yorumu korur ve push sonrasında günceller. GitHub Action kendi CI ortamınızda, kendi model anahtarınızla çalışır; Gemini, OpenAI ve uyumlu endpoint’leri destekler. CLI yerel analiz, doğrulama, render, yorum ve dışa aktarma adımları sunar. Agent skill mevcut coding agent modelini kullanarak grafik belgesini üretir. Aynı depoda App veya Action seçeneklerinden birini kullanmak, çift yorum oluşmasını önler.

Uygulanabilir bir review akışı

App’i kurun ya da Action’ı ekleyin ve incelemeye hazır bir pull request açın. Önce mimari diyagramdan değişen sınırları, yeni bileşenleri ve kaldırılan parçaları kontrol edin. Ardından veri akışında çalışma sırasını izleyin; büyük değişiklikte canvas’ı açın. Haritayı hangi dosya ve yolların ayrıntılı okunacağını seçmek için kullanın, fakat diff, CI ve sınır durum testlerini atlamayın. Yanlış adları veya grupları üretilen SVG’de değil, kalıcı .github/pr-lens.yml düzeltmeleriyle değiştirin.

Maliyet, gizlilik ve önemli sınırlar

PR Lens açık kaynak projeler için ücretsizdir ve depo MIT lisanslıdır. Action veya CLI kullanımında yalnızca seçtiğiniz model sağlayıcısının ücretini ödersiniz; resmi site özel depolar için hosted App’in doğrulanabilir tek bir fiyatını yayımlamıyor. Hosted App PR head’ini tek kullanımlık sandbox’a klonlar, Gemini ile analiz eder, grafik belgeleri ve render dosyalarını nesne depolamada saklar ve çalışmanın sonunda sandbox’ı siler. Saklanan nesnelere uygulama tarafından otomatik son kullanma süresi atanmaz; render bağlantısına sahip olan kişi görseli alabilir. Hassas kod için resmi veri işleme ve saklama açıklamasını inceleyin ve yerel CLI veya skill’i değerlendirin.

Sık sorulan sorular

PR Lens bug veya güvenlik açığı bulur mu?

Hayır. Değişikliğin yapısını gösterir; hata bulma araçları, güvenlik kontrolleri ve insan review süreci ayrı kalır.

API anahtarı gerekir mi?

Hosted App için sizin anahtarınız gerekmez. Action ve CLI kendi sağlayıcı anahtarınızı, skill ise mevcut agent modelini kullanır.

Özel depolarda çalışır mı?

App seçtiğiniz özel depolarda çalışabilir; ekip depolama ve bağlantı erişimi modelini değerlendirmelidir. Yerel seçenekler daha fazla kontrol sağlar.

Yeni push gelince ne olur?

App yeni yorum eklemek yerine mevcut sabit yorumu son PR durumuyla günceller.

Resmi kaynaklar

• PR Lens nedir ve çalışma yolları
• GitHub App kurulumu ve izinleri
• MIT kaynak kodu, yapılandırma ve issues