STYLISh

Senin dolabın. Senin stilin. Senin API anahtarın.

v1.3 · Türkçe · PWA · Çevrimdışı dolap · Kişisel Gemini bağlantısı

---

Bu sürümde ne değişti?

Her kullanıcı kendi Gemini API anahtarını doğrudan Ayarlar → Kendi API anahtarın bölümüne girer. Ortak sunucu anahtarı veya uygulama parolası artık kullanılmaz. AI istekleri tarayıcıdan doğrudan Google'a gider; STYLISh sunucusu API anahtarını almaz.

• Kişisel anahtar: Her açık sekme kendi anahtarını bellekte tutar. İstersen “Anahtarımı bu cihazda hatırla” ile anahtar bu tarayıcıda saklanır.
• Model seçimi: Ayarlar, fotoğraf etiketleme ve kombin ekranlarında değiştirilebilir.
• Varsayılan öneri: gemini-3.8-flash.
• Erişim kontrolü: “Modelleri kontrol et” anahtarınla Google'ın model listesini sorgular ve bilinen ücretsiz-kotalı seçeneklerle eşleştirir.
• Hata sonrası seçim: “Başka model seç” ile alternatif seçilir; yeniden gönderim için onay ve işlem düğmesine tekrar basmak gerekir.
• Ücretli modele otomatik geçiş yok: Başka modele gizlice yeniden istek gönderilmez.
• Kota sonrası yerel öneri: AI kombin isteği 429 alırsa uygun parçalar varsa cihazdaki ücretsiz kurallar kullanılır.

“Her kişi kendi anahtarını kullanır” kişisel tarayıcı oturumlarını ifade eder. Bu sürüm kullanıcı hesabı veya aynı cihazda birbirinden ayrılmış çoklu dolap sistemi değildir. Aynı tarayıcı profilini paylaşan kişiler yerel dolap verilerini de paylaşır.

Ücretsiz en gelişmiş model konusu

8 Eylül 2026'da Google'ın resmî fiyat sayfasında Gemini 3.8 Flash için ücretsiz girdi/çıktı katmanı listelenmiştir. Bu sürüm güncel gelişmiş seçeneklerden biri olarak onu önerir; her görev için mutlak “en iyi” model iddiası veya sınırsız kota garantisi yoktur.

Uygulamadaki seçenekler:

• Gemini 3.8 Flash — varsayılan öneri
• Gemini 3.7 Flash
• Gemini 3.5 Flash
• Gemini 2.5 Pro
• Gemini 2.5 Flash
• Gemini 2.5 Flash-Lite — hafif alternatif

Bu liste, kontrol tarihindeki ücretsiz katman bilgisine dayanır. Model, fiyat ve kota bilgileri değişebilir; yeni modeller için uygulama güncellemesi gerekir. Model keşif API'si fiyatı, ücretsiz kotayı veya faturalandırma durumunu bildirmez. Erişilebilir modellerin hepsi otomatik olarak seçeneklere eklenmez; bilinmeyen/ücretli modeller listeden dışarıda tutulur.

Ücret çıkmaması için faturalandırması kapalı bir Free Tier projesi kullan. Ücretli proje anahtarıyla aynı modele yapılan çağrı ücretli olabilir. Uygulama bu farkı otomatik doğrulayamaz.

Kaynaklar: Fiyat ve ücretsiz katman · Gemini 3.8 Flash · Modeller API'si

Başlangıç: API olmadan

1. Projeyi indirip aç.

2. Node.js 22.9+ kur.

3. Terminalde package.json dosyasının olduğu klasöre geç.

4. Çalıştır:

   npm start
   

5. Bilgisayarında http://localhost:3000 adresini aç.

Çalışma bağımlılığı yoktur; uygulama için npm install gerekmez. Fotoğraf ekleme, etiketleri elle girme, dolap, arama, favoriler, temiz/kirli, yerel ve manuel kombinler, kayıtlı kombinler, giyim takibi ve yedekleme API olmadan çalışır.

Her kullanıcı kendi anahtarını nasıl ekler?

1. Google AI Studio → API Keys sayfasında kendi hesabıyla giriş yapar.
2. Faturalandırması kapalı Free Tier projesinde API anahtarı oluşturur. Ücretsiz kullanım için ücretli katmanı etkinleştirmez veya ücretli projeye ait anahtarı kullanmaz.
3. Yayınlanmış STYLISh uygulamasını açar; Ayarlar → Kendi API anahtarın bölümüne anahtarını yapıştırır.
4. Ücretsiz proje ve Google'ın veri kullanım açıklamasını okuyup onaylar; Anahtarımı kullan düğmesine basar.
5. İsterse Anahtarımı bu cihazda hatırla kutusunu işaretler. İşaretlemezse anahtar yalnızca açık sekmenin belleğinde kalır.
6. İsteğe bağlı Modelleri kontrol et ile anahtarının liste erişimini kontrol eder. Bu bir ücret veya kalan kota testi değildir; içerik üretim isteği göndermez.
7. Modelini seçer. Fotoğraf veya etiket gönderimi için ayrıca işlem ekranındaki onayı verir.

Anahtar uygulama açılırken otomatik olarak Google'a gönderilmez; hatırlanan anahtar da yalnızca belleğe yüklenir. “Anahtarımı kullan” bağlantıyı hazırlar; model listesi veya AI işlemi kullanıcı tarafından başlatılır.

Anahtar güvenliği

Varsayılan davranışta anahtar sadece açık sekmenin belleğinde tutulur. Hiçbir kalıcı depolamaya, dolap yedeğine veya sunucu ortam değişkenine yazılmaz. Sayfayı yenileyince, sekmeyi kapatınca veya sayfadan ayrılınca yeniden girmen gerekir.

“Anahtarımı bu cihazda hatırla” işaretlenirse anahtar bu tarayıcının localStorage alanına düz metin kaydedilir ve sonraki açılışlarda otomatik yüklenir. Kolaylık ile risk arasında bilinçli bir seçimdir: cihaza, tarayıcı profiline veya yetkili bir eklentiye erişen herkes anahtarı okuyabilir. Ortak veya güvenmediğin cihazda işaretleme. Hatırlanan anahtar da dolap yedeğine girmez ve STYLISh sunucusuna gönderilmez. Model tercihi, gizli bilgi içermediğinden her durumda cihazda hatırlanır.

• Anahtarı kaldır bellek oturumunu temizler, hatırlanan anahtarı cihaz depolamasından siler ve devam eden API isteklerini iptal eder.
• Anahtar Google'a HTTPS üzerinden x-goog-api-key başlığında gider; URL sorgusuna eklenmez.
• Anahtar sadece kendi güvendiğin uygulama adresine girilmelidir. Tarayıcıda çalışan site kodu veya yetkili eklentiler bu anahtara erişebilir. Bellekte tutmak XSS veya zararlı eklenti riskini ortadan kaldırmaz; hatırlatmak bu riski artırır.
• Google anahtar kısıtlamalarında API'yi Generative Language API ile, uygun olduğunda web kaynağını kendi uygulama adresinle sınırla. Kısıtları koyduktan sonra bağlantıyı gerçek adreste test et.
• Anahtarları GitHub'a, ekran görüntülerine, sohbetlere veya herkese açık yedeklere koyma.
• Yanlış bir adrese anahtar girdiysen Google panelinden iptal edip yenisini oluştur.

Bu kişisel anahtar tasarımı kapalı pilot için uygundur. Daha geniş üretim kullanımı için kullanıcı hesapları, güvenlik incelemesi, uygun anahtar yönetimi ve KVKK süreçleri ayrıca ele alınmalıdır.

Hata alınca model değiştirme

Fotoğraf veya AI kombin ekranında modeli seçebilir ya da hata sonrası Başka model seç düğmesini kullanabilirsin. Model değişince gönderim onayı sıfırlanır. Yeniden onay verip Yapay zekâyla etiketle / Kombin oluştur düğmesine bas.

Durum	Yapılabilecekler
400	Anahtar biçimini, görseli ve model uyumluluğunu kontrol et.
401 / 403	Anahtar, proje izni, bölge veya site/API kısıtlarını kontrol et.
404	Model hesabında olmayabilir veya kaldırılmış olabilir; başka model seç.
429	Bekle, başka uygun modeli dene veya yerel moda dön. Ortak proje kotasını model değiştirmek çözmeyebilir.
5xx / zaman aşımı	Daha sonra yeniden dene veya başka model seç.
Geçersiz / tamamlanmamış AI yanıtı	Modeli değiştir ya da etiketleri elle doldur.

Model değiştirmek anahtar/hesap hatasını veya ortak proje kotasını aşma yöntemi değildir. Uygulama otomatik olarak başka anahtar kullanmaz ve ek ücretli araç çağırmaz.

HTTPS ve GitHub Pages

v1.3'te AI için ortak Node.js sunucusu gerekmez. Uygulama dosyaları depo kökündedir; herhangi bir HTTPS statik barındırıcıda yayınlanabilir. Bu depo GitHub Pages ile main / root ayarından yayınlanır: https://kamilsaim.github.io/stylish/ Ayrı bir dağıtım iş akışı gerekmez.

Kişisel API bağlantısı, hesabın/anahtar kısıtların ve tarayıcının Google'a doğrudan bağlantıya izin vermesine bağlıdır. İzin/CORS/ağ sorunu çıkarsa uygulama açıklayıcı hata gösterir; yerel mod çalışır.

• Android: Chrome → Menü → Uygulamayı yükle / Ana ekrana ekle.
• iPhone: Safari → Paylaş → Ana Ekrana Ekle.
• İlk açılışı internete bağlı yap. Dolap ve yerel özellikler sonrasında çevrimdışı çalışır; AI internet ister.
• Telefonundaki localhost bilgisayarına değil telefonuna işaret eder.
• Barındırma ve alan adı maliyeti API ücretinden ayrıdır; ücretsiz olduğu garanti edilmez.

server.mjs yalnızca yerel/isteğe bağlı statik sunucudur. Ortak AI geçidi kaldırılmıştır. Eski /api/ adresleri 410 yanıtı verir. HTTPS barındırmada anahtar ortam değişkeni kurmana gerek yoktur.

Gizlilik ve dolap yedeği

Fotoğraflar/etiketler/kombinler IndexedDB'de cihaz, tarayıcı ve site adresine bağlı saklanır. Bulut eşitleme yoktur. Tarayıcı temizliği veya cihaz kaybı verileri silebilir; Ayarlar → Yedek indir ile düzenli yedek al.

Yedekler fotoğrafları içerir ve şifrelenmemiştir. API anahtarlarını içermez. İçe aktarma aynı kimlikli kayıtları günceller, diğerlerini korur. Sınırlar: 100 MB, 1000 parça, 2000 kombin. Kalıcı depolama izni garanti değildir ve yedek yerine geçmez.

Google'a gönderim yalnızca işlem onayıyla yapılır:

• Fotoğraf analizi: seçtiğin fotoğraf.
• Kombin önerisi: uygun kıyafetlerin etiketleri; fotoğraf gönderilmez.
• Yerel mod: AI için Google'a veri gönderilmez.

Ücretsiz Gemini katmanında içerikler Google ürünlerini geliştirmede kullanılabilir. Yüz, kimlik, belge veya hassas/kişisel bilgi gönderme. Bunu istemiyorsan yerel modu kullan. Gemini koşulları

v1.2'den geçiş

1. Önce dolap yedeğini indir.
2. Aynı adresteki uygulama dosyalarını güncelle. IndexedDB adı, yedek biçimi ve PWA kimliği korunmuştur.
3. Eski ortak GEMINI_API_KEY, APP_PASSWORD ve GEMINI_FREE_TIER_CONFIRMED barındırma ayarlarını kaldır; artık kullanılmazlar. Eski anahtarın başka yerde kullanılmıyorsa Google panelinden iptal etmeyi değerlendir.
4. Tüm uygulama sekmelerini/pencerelerini kapatıp tekrar aç. Service worker sürümü artırılmıştır.
5. Ayarlar'da kendi API anahtarını gir.

Farklı site veya cihaza geçerken yedeği içe aktar. Her dağıtımda değişen dosyalar için sw.js önbellek sürümünü artır.

Teknik yapı ve testler

HTML/CSS/vanilla JavaScript · IndexedDB · Service Worker · Web App Manifest · isteğe bağlı Node.js statik sunucu · Gemini REST API.

index.html                   Uygulama, kişisel anahtar akışı, model seçimi ve rehber
sw.js                        Çevrimdışı uygulama kabuğu; Google isteklerini önbelleklemez
manifest.webmanifest         STYLISh PWA bilgileri
assets/                      Marka ve örnek dolap görselleri
server.mjs                   Sadece statik dosya sunucusu
tests/smoke.mjs               Dolap, yedek ve çevrimdışı testleri
tests/personal-key.mjs        Sahte yanıtlarla kişisel anahtar/model testleri
TEST-SONUCLARI.json           Tarayıcı test raporu
KISISEL-API-TESTLERI.json     Kişisel anahtar test raporu

npm run check
# Yalnızca geliştirme testleri için:
npm install --no-save playwright
npx playwright install chromium
node tests/smoke.mjs
node tests/personal-key.mjs

Gerçek Gemini anahtarıyla canlı çağrı yapılmadı. Model erişimi, CORS/site kısıtları ve gerçek iPhone/Android kurulumu kendi hesabında/cihazında doğrulanmalıdır. Sahte sağlayıcı testleri ücretsiz erişimi veya model kalitesini kanıtlamaz.

Kapsam dışı ve lisans

Sanal deneme, arka plan kaldırma, yeni kıyafet görseli üretimi, kullanıcı hesapları ve bulut eşitleme bu sürümde yoktur.

Bu projede açık kaynak lisansı tanımlanmamıştır. Kodun ve STYLISh logosunun yeniden kullanım/dağıtım koşulları proje sahibi tarafından belirlenmelidir.

STYLISh · Combination & Style
Az parça. Çok ihtimal.