Reasonix: Terminaliniz İçin DeepSeek-Native AI Kodlama Ajansı

Reasonix: Terminaliniz İçin DeepSeek-Native AI Kodlama Ajansı

Reasonix v0.50.0, terminal tabanlı, açık kaynaklı bir DeepSeek-native kodlama ajanıdır. Doğrudan api.deepseek.com ile iletişim kuran bu ajan, DeepSeek’in byte-stabil prefix önbelleği etrafında tasarlanmış append-only bir döngüye sahiptir. Bu mühendislik yaklaşımı sayesinde uzun oturumlarda %90’ın üzerinde önbellek isabeti sağlanır ve girdi token maliyeti yaklaşık 1/5 oranında düşer. Terminal odaklı yapısıyla kesintisiz çalışmak üzere tasarlanmıştır.

• %94 Önbellek İsabet Oranı
• 2.5× Daha Düşük Maliyet
• 2837 Test
• MIT Lisansı

Kurulum: İki Adımda Hızla Başlayın

Reasonix kurulumu iki basit adımdan oluşur ve global bir yükleme gerektirmez. macOS, Linux veya Windows (PowerShell · Git Bash · Windows Terminal) üzerinde Node ≥ 22 yüklü olması yeterlidir. İlk çalıştırma sırasında DeepSeek API anahtarınızı girmeniz istenir.

1. DeepSeek API Anahtarı Edinin

DeepSeek platformuna gidin ve bir anahtar oluşturun. Öde-kullandıkça modelinde, önbelleğe alınan token’lar normal tarifenin 1/5’i fiyatına faturalandırılır. Örneğin, $0.07 /Mtok giriş ve $0.014 /Mtok önbelleğe alınmış token maliyeti vardır.

2. Çalışma Alanınızı Hazırlayın ve Başlatın

Proje dizininize gidin (örneğin: cd /path/to/my-project). Ardından npx reasonix code komutuyla TUI’yi başlatın. İlk başlatmada, anahtarınızı bağlamak için bir sihirbaz sizi yönlendirecektir. Tüm araçlar başlatma diziniyle sınırlıdır.

Reasonix’in Üç Temel Taşı

Reasonix, döngüsünün değişmezleri DeepSeek’in önbellek mekaniğine göre tasarlandığı için yalnızca DeepSeek’i hedefler. Aynı model, aynı API kullanılırken değişen şey, döngünün mühendislik yaklaşımıdır.

1. Önbellek Odaklı Döngü: Byte-Stabil Yapı

DeepSeek’in prefix önbelleği, istemleri byte 0’dan itibaren parmak izler. Reasonix döngüsü append-only’dir – yeniden sıralama veya işaretleyici tabanlı sıkıştırma yoktur – bu sayede önbelleğe alınan prefix her araç çağrısında hayatta kalır.

• %94 önbellek isabeti uzun oturumlarda sağlanır.
• Append-only: Mesajlar ve araç sonuçları eklenir; geçmiş asla mutasyona uğramaz.
• İşaretleyici yok: cache_control işaretleyicileri gibi tetikleyicilere bağımlılık yoktur.
• Stabil sıra: Araç çağrısı sırası ve zaman damgaları tamamen deterministiktir.
• Prefix hayatta kalır: Çok sayıda araç gönderimi olsa bile, prefix hala isabet eder.

2. Düşünce Hasadı (Thought Harvest): Akıl Yürütme Zinciri Hasadı

Bu sütun, karmaşık problemleri çözerken modelin düşünce süreçlerini etkin bir şekilde yakalamaya odaklanır.

3. Araç Çağrısı Onarımı (Tool-Call Repair): Şema Farkındalıklı Kendi Kendini İyileştirme

Reasonix, araç çağrılarında oluşabilecek hataları şema farkındalığı ile otomatik olarak onarır, bu da daha kararlı ve güvenilir bir çalışma sağlar.

Reasonix’in Mühendislik Odaklı Özellikleri

Bir düzineden fazla araç, basit bir CLI gibi görünen bir yapıya dönüşür; ancak altındaki her katman önbellek isabetini, maliyeti ve stabiliteyi gerektiği yerde tutmak için çalışır.

• Terminal-Native TUI: Başka bir IDE eklentisi değil. git diff farklılıkları, ls dosya ağaçlarını yönetir; terminaliniz sizin çalışma alanınızdır (TypeScript + Ink TUI).
• V4 İki Kademeli: Varsayılan olarak ucuz iterasyonlar için V4-Flash kullanılır; /pro tek bir dönüşü V4-Pro’ya yükseltir; /preset max tüm oturumu Pro üzerinde çalıştırır.
• MCP Birinci Sınıf Destek: Tek bir satır — --mcp 'name=cmd args' — ile harici bir sunucu bağlanır; araçları aynı kayıt defterine bir prefix altında birleşir (stdio · SSE · Streamable HTTP).
• Sandbox + Plan Kapısı: Her yerleşik araç başlatma diziniyle sınırlıdır; /plan oturumu salt okunur bir denetim kapısı arkasına alır — plan onaylanana kadar yazma işlemi yapılamaz.
• Bileşebilir Beceriler (Composable Skills): .reasonix/skills/.md içine bir Markdown dosyası bırakın; frontmatter, izole yürütme için runAs: subagent ve allowed-tools gibi seçenekleri destekler.
• Tekrar Oynatma ve Olaylar: Her olay diske yazılır — herhangi bir geçmiş oturumu tekrar oynatabilir, token / önbellek / maliyet istatistikleri çalıştırabilir, döngünüzün davranışını denetleyebilirsiniz (reasonix replay / events / stats).

Yapılandırma: Düz Metin Yeterlidir

Reasonix, genişletilebilirliği iyi tanımlanmış birkaç dizin ve dosyaya indirger. Kayıt defterleri veya sihir yoktur — her şey okunabilir, karşılaştırılabilir, git tarafından izlenebilir düz metindir.

• /mcp: Model Bağlam Protokolü (External tool servers)
• /skills: Beceriler (Reusable Markdown playbooks)
• /memory: Bellek (Project + global memory)
• /config: Konfigürasyon (Global + project config)
• /slash: Slash Komutları (TUI shortcut commands)

Model Bağlam Protokolü (MCP)

MCP, Reasonix’e harici yetenekleri bağlamak için birinci sınıf bir kanaldır — stdio, SSE ve Streamable HTTP taşıyıcılarını destekler. Her sunucunun araçları, modele şeffaf bir ön ek altında birleşik kayıt defterine dahil olur.

• Tek satırda bağlama: --mcp 'name=cmd args'
• MCP araçları, yerleşik araçlarla aynı sandbox’ı paylaşır.
• /mcp bağlı sunucuları, sağlık durumunu ve araçlarını listeler.
• Hata durumunda üstel geri çekilme ile otomatik yeniden bağlanma.

Örnek konfigürasyon ~/.reasonix/config.json veya CLI flag ile sağlanabilir.

Reasonix Yol Haritası: Şeffaf Ürün Süreci

Her kilometre taşı GitHub Tartışmaları dilek listesinde yaşar. Sorun oyları önceliği şekillendirir; PR’lar hızı belirler.

Tamamlananlar:

• Önbellek Odaklı Döngü · byte-stabil prefix
• R1 Düşünce Hasadı · kaçan araç çağrılarını temizleme
• Araç Çağrısı Onarımı · şema-farkındalıklı kendi kendini iyileştirme
• MCP birinci sınıf (stdio / SSE / HTTP)
• Beceriler · Markdown frontmatter betikleri
• Yerel Tauri masaüstü

Devam Edenler (v0.44.x):

• /skill new iskele oluşturucu
• Kurulum sihirbazı tema seçici + canlı önizleme
• ‘Şunu mu demek istediniz /…?’ bulanık düzeltme
• Yükleme kaynağına duyarlı reasonix update
• zh-CN kart bileşenlerini kapsayan genişletilmiş kapsama alanı

Planlananlar:

• reasonix init · proje iskele oluşturucu CLI
• Cihazlar arası bağlam senkronizasyonu
• Eklenti sistemi (.claude-plugin/ uyumlu)
• Repo haritası · anlamsal depo indeksi
• TUI açık tema

Dilek Listesi:

• Çoklu ajan işbirliği · kalıcı çalışanlar
• Sağlayıcılar arası orkestrasyon (codex + deepseek)
• Besteci ses girişi
• Barındırılan hizmet modu
• Daha fazla dil i18n kapsama alanı

Sıkça Sorulan Sorular (SSS)

Hala takıldınız mı? GitHub Tartışmalarında bir konu açın.

• Neden sadece DeepSeek? Claude / GPT’ye geçebilir miyim? Tasarım tercihi, sınırlama değil. DeepSeek’in prefix önbelleği istemleri byte 0’dan itibaren parmak izler; Reasonix döngüsü bu değişmez etrafında tasarlandı — uzun oturumlar ~%94 önbellek isabeti sağlar. Anthropic uyumlu bir uç noktaya işaret etmek ucuz tokenlar sağlar ama cache_control işaretleyicilerini bozar. Genel arka uçlar (Aider / Cline / Continue) geçmişi sıkıştırır, bu da byte stabilitesini yok eder. Tek bir arka uca bağlılık bir özelliktir.
• Ücretsiz mi? Reasonix’in kendisi MIT lisanslı ve ücretsizdir. DeepSeek API anahtarı ücretlidir: V4-Flash önbelleğe alınmamış için $0.07/Mtok ve önbelleğe alınmış için $0.014/Mtok’tur. Uzun oturumlarda fatura genellikle karşılaştırılabilir genel araçların ~1/3’ü civarında olur.
• IDE eklentisi olacak mı? Hayır. Reasonix terminal odaklıdır. git diff farkları yapar; ls dosya ağaçlarını yapar. Masaüstü, CLI’ye görsel bir eşlikçidir, bir Cursor alternatifi değildir.
• Kendi barındırılan / özel bir DeepSeek uç noktasına yönlendirebilir miyim? Evet. 0.30’dan beri kendi barındırılan DeepSeek uç noktaları için standart olmayan anahtar prefixlerini kabul ediyoruz. Sadece baseUrl‘i dahili adresinize işaret edin — döngü, önbellek stratejisi ve araç protokolü değişmez.
• CLI ile masaüstü arasındaki ilişki nedir? Aynı döngü, aynı protokol, aynı ~/.reasonix yapılandırması. Masaüstü (Tauri) kendi Node çalışma zamanını içerir — ayrı bir npm kurulumu gerekmez. Çoklu sekme oturumları, bu oturumun okuduğu veya yazdığı dosyaları listeleyen yan panel, alt kısımda canlı maliyet / önbellek / token sayaçları bulunur.
• Kendi becerimi nasıl yazarım? Uzak bir kayıt defteri yok — sadece bir dosya yazın. TUI içinde /skill new my-skill komutunu çalıştırarak projeye özel bir beceri iskeleti oluşturun; projeler arasında yeniden kullanım için --global ekleyerek ~/.reasonix/skills altına koyun. Beceriler, frontmatter (açıklama, runAs, allowed-tools) içeren Markdown’dur; runAs: subagent, gövdeyi izole edilmiş bir alt döngüde çalıştırır.
• Araç çağrıları güvenli mi? Her yerleşik araç (read_file / write_file / edit_file / run_command …) başlatma diziniyle veya --dir ile belirlediğiniz yerle sınırlıdır. SEARCH/REPLACE düzenlemeleri beklemeye alınır; siz /apply diyene kadar hiçbir şey diske yazılmaz. /plan modu salt okunur bir denetim kapısıdır — plan onaylanana kadar yazmaya izin verilmez.
• Oturum ortasında çalışma dizinlerini değiştirebilir miyim? Hayır — bellek yolları eski kök ile karışır. Çıkış yapın ve reasonix code --dir ile yeniden başlatın.