📰 Hikayesi ve Doğuşu
Yapay zeka tabanlı metin üretimi son yıllarda devasa bir ivme kazandı; ancak bu durum, uzun soluklu hikaye anlatıcılığında ve interaktif kurgularda kronik bir problemi de beraberinde getirdi: Yapay zekanın hafıza kaybı, yani 'Hallüsinasyon' ve süreklilik krizleri. Bağımsız geliştirici weike-zhang, tam da bu noktadan hareketle, kullanıcıların kendi evrenlerini kurabileceği, karakter durumlarının kalıcı olarak saklandığı ve her hamlenin mantıksal süzgeçten geçtiği ai-novel-studio projesini hayata geçirdi.
Geleneksel LLM tabanlı hikaye arayüzleri, kullanıcılar ilerledikçe önceki bağlamı unutur, karakterlerin isimlerini karıştırır veya ana kurgunun dışına çıkarak tutarsız sahneler üretir. weike-zhang, projenin çıkış noktasında bu kaosu düzenli bir yapıya oturtmayı hedefledi. Sadece metin üreten bir arayüz değil, aynı zamanda hikayenin kurallarını ve karakter kimliklerini koruyan katı bir 'anlatı motoru' tasarladı. Bu yaklaşım, özellikle interaktif kurgu oyunları geliştirenler ve uzun soluklu dijital roman yazarları için uzun süredir aranan teknik çözümü sunuyor.
⚡ Nasıl Çalışıyor & Mimari Detaylar
Projenin teknik omurgası iki ana dünyanın kusursuz birleşiminden oluşuyor: Frontend tarafında modern web deneyimi sunan Next.js, backend tarafında ise performansıyla öne çıkan Go dili. ai-novel-studio'yu sıradan bir yapay zeka chatbot arayüzünden ayıran en temel özellik, modelin çıktığı ham metin ile veritabanına kaydedilen gerçeklik arasındaki 'doğrulama sınırı' (validation boundary) mimarisidir.
Sistem kısaca şöyle işliyor: Oyuncu veya yazar bir eylemde bulunur; bu eylem API üzerinden kuyruğa alınır (Outbox ve RabbitMQ entegrasyonuyla). Go tabanlı arka plan işçisi (worker), dondurulmuş dünya snapshot'ları ve taahhüt edilmiş bağlam eşliğinde yapay zeka modelinden bir öneri (proposal) talep eder. Model bir hamle önerdiğinde, sistem doğrudan bunu veritabanına yazmaz. Önce validasyon katmanından geçer. Örneğin, model arka planda ana karakterin adını değiştirmeye kalkarsa, doğrulama mekanizması bunu reddeder ve taahhüt edilen sürümün bozulmamasını sağlar. Tüm bu süreç MySQL transaksiyonları ve OpenAPI istemcileriyle güvenli bir döngüde yönetilir.
💡 Neden Radarımıza Girdi?
Weezir Radar ekibi olarak bu projeyi seçmemizin temel sebebi, yapay zekanın "yaratıcı ama güvenilmez" doğasını kurumsal düzeyde bir veri bütünlüğü ile ele almasıdır. Çoğu geliştirici LLM projelerinde API çağrılarına körü körüne güvenirken, ai-novel-studio "Model önerebilir, ancak kuralları çiğneyemez" felsefesini benimser. Go 1.26 ile gelen yenilikleri kullanan, sıfır veritabanı gereksinimiyle çalışan demo modu sayesinde geliştiricilerin hiçbir API anahtarına ihtiyaç duymadan mimariyi yerinde test edebilmesi, projeyi açık kaynak dünyasında ayrı bir yere konumlandırıyor.
Ayrıca projenin açık kaynak kodlu yapısı, stateful (durum bilgisi tutan) AI uygulamaları geliştirmek isteyenler için adeta yaşayan bir ders niteliğinde. Model entegrasyonlarındaki esneklik, OpenAI uyumlu uç noktaların desteklenmesi ve hata yönetimi mekanizmaları, bu aracın sadece bir roman stüdyosu değil, genel amaçlı bir stateful AI mimari şablonu olduğunu kanıtlıyor.
🚀 Nasıl Denenir & Kaynaklar
Projeyi yerel ortamınızda test etmek ve çalışma mantığını incelemek oldukça kolaydır. Go 1.26 veya daha yeni bir sürüm yüklüyse, herhangi bir veritabanı veya API anahtarına ihtiyaç duymadan doğrudan yerleşik simülasyonu çalıştırabilirsiniz:
cd services/server
go run ./cmd/demoBu komut, dahili bir bellek deposu ve deterministik sahte sağlayıcı ile örnek bir liman senaryosunu işleme alır, karakter adı değiştirme girişimindeki reddedilme sürecini simüle eder. Web arayüzünü ve tam yığın özelliklerini çalıştırmak için ise Node.js 22+ gereklidir:
npm ci
npm run build:api-client
npm run test:webProjenin kaynak kodlarına, mimari detaylarına ve katkı kılavuzuna ulaşmak için resmi GitHub reposunu ziyaret edebilirsiniz: github.com/weike-zhang/ai-novel-studio