Pi Prompt Translate: Pi Coding Agent için Geliştirdiğim Açık Kaynak Prompt Çeviri Eklentisi

Pi Prompt Translate: Kendi Geliştirdiğim Açık Kaynak Pi Coding Agent Eklentisi

Bir fikri kafanda ana dilinde kuruyorsun, ama yapay zeka kodlama asistanına yazarken İngilizce çevirmek zorunda kalıyorsun. Bu süreç, özellikle hızlı iterasyon gerektiren projelerde ciddi bir bilişsel yük (cognitive overhead) oluşturuyor. Ben de tam bu noktada Pi Coding Agent ekosistemi için pi-prompt-translate eklentisini geliştirdim. Açık kaynak, hafif ve iş akışınıza tamamen entegre bir çözüm.

Bu yazıda eklentinin motivasyonunu, teknik mimarisini, kurulumunu ve gelecekteki yol haritasını paylaşıyorum. Eğer çok dilli geliştiriciler olarak İngilizce merkezli yapay zeka araçlarıyla çalışıyorsanız, bu eklenti tam size göre.

Problem: Ana Dilde Düşünmek, İngilizce Yazmak Zorunda Kalmak

Günümüzde büyük dil modelleri (LLM) ve kodlama asistanları en iyi sonuçları İngilizce promptlarla veriyor. Türkçe, İspanyolca veya başka bir dilde yazılan promptlar genellikle tutarsız yanıtlar, dil karışıklığı veya bağlam kaybına yol açıyor. En temiz çözüm her şeyi İngilizce yazmak, ancak sürekli kendi düşüncelerini çevirmek zamanla yorucu hale geliyor.

Bu sorun yalnızca bireysel verimliliği etkilemiyor. Ekip ortamlarında, farklı dil yetkinliğine sahip geliştiriciler için de adil olmayan bir dezavantaj yaratıyor. Herkesin fikrini özgürce ve doğal diliyle ifade edebildiği bir ortam, daha sağlıklı ürünler ve daha hızlı iterasyonlar demek.

Çözüm: pi-prompt-translate

pi-prompt-translate, Pi Coding Agent kullanıcı girişlerini hedef dildeki eşdeğerine çevirerek araya giren şeffaf bir katman. Eklenti, aktif LLM modelini yeniden kullanıyor, bu sayede ek API anahtarı veya maliyet gerektirmiyor. TypeScript ile yazıldı, MIT lisansıyla GitHub'da açık kaynak olarak yayınlandı.

Temel özellikleri şöyle sıralayabiliriz:

• Şeffaf Entegrasyon: Kullanıcı girişlerini arada yakalayıp çeviriyor, iş akışınızda hiçbir değişiklik gerektirmiyor.
• Akıllı Koruma: Kod blokları, dosya yolları, değişken isimleri ve teknik terimler olduğu gibi bırakılıyor, sadece doğal dil kısımları çevriliyor.
• Aktif LLM Yeniden Kullanımı: Zaten yapılandırılmış modelinizi çeviri için kullanıyor, ek maliyet yok.
• Kalıcı Durum: Açma/kapama ve dil ayarları oturumlar arasında kaydediliyor.
• Minimal Katkı: Tek döngülük (single-turn) LLM çağrısı, token israfı yok.

Kurulum: 30 Saniyede Hazır

Eklenti npm, git veya yerel yoldan kurulabiliyor. En pratik yöntem npm üzerinden:

pi install npm:pi-prompt-translate

Kalıcı olmadan denemek isterseniz:

pi -e npm:pi-prompt-translate

Proje bazlı kurulum için:

pi install -l npm:pi-prompt-translate

Kurulum sonrası üç basit slash komutuyla eklentiyi yönetebilirsiniz:

• /translate-toggle Çeviriyi açar veya kapatır.
• /translate-lang <dil> Hedef dili ayarlar, varsayılan İngilizce.
• /translate-status Mevcut durumu ve hedef dili gösterir.

Teknik Mimari ve Tasarım Kararları

Eklenti extensions/index.ts dosyasındaki input olay dinleyicisiyle çalışıyor. Kullanıcı mesajı geldiğinde, eklenti etkinse metni aktif LLM'e özel bir sistem promptuyla gönderiyor. Model yalnızca çevrilmiş metni döndürüyor, açıklama veya yorum içermiyor. Çevrilen mesaj ajan tarafından sanki kullanıcı doğrudan İngilizce yazmış gibi işleniyor. Ekteki görseller olduğu gibi iletiliyor.

Mimariyi tasarlarken üç kritik karar aldım:

1. Döngü Önleme: Eklenti tarafından enjekte edilen mesajlar atlanıyor, bu sayede sonsuz çeviri döngüsüne girilmiyor.
2. Graceful Degradation: Çeviri başarısız olursa veya model mevcut değilse, orijinal mesaj olduğu gibi iletiliyor.
3. Minimal Prompt: Çeviri sistem promptu, teknik içeriği koruyup yalnızca doğal dili çevirecek şekilde hassas ayarlandı.

Bu kararlar, eklentinin güvenilir ve öngörülebilir davranmasını sağlıyor. Kod tabanı oldukça kompakt, bu da bakımı ve katkıda bulunmayı kolaylaştırıyor.

Kullanım Senaryosu: Gerçek Bir Örnek

İspanyolca bilen bir geliştirici şunu yazıyor:

Crea una funcion que sume dos numeros

Eklenti bunu otomatik olarak şuna çeviriyor:

Create a function that adds two numbers

Ajan İngilizce promptu normal şekilde işliyor ve yanıt veriyor. Kullanıcı hiçbir zaman İngilizce çevirmekle uğraşmıyor, akışı bozmuyor. Bu basit örnek, eklentinin günlük kullanımdaki değerini özetliyor.

Pi Coding Agent Ekosistemi ve Açık Kaynak

Pi Coding Agent, Mario Zechner tarafından geliştirilen hafif ve genişletilebilir bir yapay zeka kodlama asistanı. Eklenti mimarisi sayesinde topluluk, kendi ihtiyaçlarına özel araçlar geliştirebiliyor. Ben de bu ekosisteme katkıda bulunarak, çok dilli geliştiricilerin karşılaştığı gerçek bir sorunu çözmeyi hedefledim.

Açık kaynak olması, projenin şeffaflığını ve güvenilirliğini artırıyor. Kodu inceleyebilir, kendi ihtiyaçlarınıza göre fork edebilir veya katkıda bulunabilirsiniz. MIT lisansı, ticari ve kişisel kullanımda herhangi bir kısıtlama getirmiyor. Geliştiriciler olarak, kullandığımız araçların açık ve denetlenebilir olmasının ne kadar kritik olduğunu açık kaynak modellerin yükselişini incelediğimiz yazıda da sıkça vurguluyoruz.

Yapay zeka ajanları ve otonom sistemler konusundaki gelişmeleri Karpathy'nin autoresearch projesini ele aldığımız yazıdan takip ediyorsanız, bu tür eklentilerin kodlama asistanlarının yetkinliğini nasıl artırdığını görebilirsiniz. Benzer şekilde, Small Language Modeller üzerine yazdığımız derinlemesine incelemede de belirttiğimiz gibi, verimli ve odaklı araçlar büyük modeller kadar önemli.

Gelecek ve Katkıda Bulunma

Eklenti şu an temel ihtiyacı karşılıyor, ancak geliştirilebilecek birçok alan var:

• Proje bazlı dil profilleri.
• Çeviri önbelleği ile API çağrısı azaltma.

Katkıda bulunmak isterseniz GitHub reposuna issue açabilir veya pull request gönderebilirsiniz. Her türlü geri bildirim, hata raporu veya özellik önerisi değerli.

Sonuç

pi-prompt-translate, çok dilli geliştiricilerin yapay zeka kodlama asistanlarıyla daha doğal ve verimli çalışmasını sağlayan basit ama etkili bir eklenti. Kendi geliştirme sürecimde karşılaştığım bir sorundan yola çıkarak, toplulukla paylaşabileceğim açık kaynak bir çözüm ürettim. Eğer siz de Pi Coding Agent kullanıyor ve prompt çevirme derdinden kurtulmak istiyorsanız, GitHub'dan kurulumu deneyebilirsiniz.

Kullandıktan sonra düşüncelerinizi paylaşın, birlikte daha iyi bir geliştirici deneyimi inşa edelim.