[](docs/whitepaper.pdf)

ZAI Shell sadece başka bir CLI arayüzü değildir. Karmaşık ortamlarda gezinmek, onarmak ve güvenliği sağlamak için tasarlanmış **otonom bir SysOps ajanıdır**. Doğal dil niyetini doğrulanmış sistem eylemlerine dönüştürür, **Sentinel** ile sizi felaketlerden korur ve **P2P Şifreli Ağ** aracılığıyla güvenli, küresel iş birliğini sağlar.

pip install google-generativeai colorama psutil posthog

**Geleneksel Yapay Zeka:**

`Sen: "Dosya oluştur..."` → `AI: [Hata Verdi]` → `Sen: Manuel hata ayıklama 😤`

**ZAI Shell:**

`Sen: "Dosya oluştur..."` → `AI: [Hata Verdi]` → `🔧 Otomatik Onarım...` → `✅ Başarılı! (Sıfır manuel işlem)`

Sentinel bir güvenlik duvarı değildir. Bağlamı anlayan, hatalardan ders çıkaran ve ne zaman panik yaptığınızı bilen bir kendini koruma sistemidir.

**Temel Felsefe:**

- Sentinel GÖZLEMLER, KOMUT VERMEZ

- Sentinel AÇIKLAR, YARGILAMAZ

- Sentinel HAYATTA KALMAK için konuşur, KONTROL ETMEK için değil

- Sessizlik de bir sinyaldir

**Risk Ayrıştırma Motoru:**

Her eylem tek bir sayıya değil, dört risk boyutuna ayrıştırılır:

- **Yapısal Risk**: Ne hedefleniyor? (sistem yolları, geri dönüşsüzlük)

- **Davranışsal Risk**: Hangi örüntü ortaya çıkıyor? (başarısızlık zincirleri, tırmanma)

- **Bağlamsal Risk**: Sistemin mevcut durumu ne? (bozulmuş, kararsız)

- **Niyet Riski**: Amaç ne? (silme, sistem değişikliği, onarım)

Sentinel asla "Risk Skoru: 75" demez. Şunu der: *"Risk YÜKSEK çünkü art arda 3 kez başarısız oldunuz ve sistem zaten bozulma belirtileri gösteriyor."*

**Panik Modu Algılama:**

Sentinel, dil kalıpları ("lütfen çalış", "tekrar deniyorum", "hiçbir şey çalışmıyor") ve art arda başarısızlıklar aracılığıyla çaresizliği algılar. Panik algılandığında, stres altında hatalar daha olası olduğundan risk eşikleri ayarlanır. Panik kötü niyet değildir—ama tehlikeyi artırır.

**Ders Hafızası:**

Sentinel, gerçek hasara neden olan geçmiş başarısızlıkların hafif bir belleğini (`.sentinel_lessons.json`) tutar. Her şeyi hatırlamaz—sadece önemli olanları. Daha önce başarısız olan bir yola veya kalıba yaklaştığınızda, Sentinel sizi tarihsel bağlamla uyarır:

*"Bu yol daha önce sorunlara neden oldu (3x görüldü): Zorla erişim girişiminden sonra izin reddedildi."*

**Bağlama Duyarlı Uyarılar:**

Uyarılar, izole olaylara değil birikmiş duruma göre oluşturulur. Sentinel, 5 başarısız onarım girişiminden sonra bir `rm -rf` komutunun kararlı bir oturumdaki aynı komuttan çok daha tehlikeli olduğunu anlar.

**Tasarımda Engelleyici Değil:**

Sentinel insan otoritesine saygı duyar. Uyarır, açıklar ve önerir—ancak son karar her zaman sizindir. Açık onay yalnızca risk gerçekten yükseldiğinde gereklidir.

**Sentinel 1.5 İş Başında (Gerçek Çıktı):**

Terminaller üzerinde bir Google Doc kadar kolay, ancak güvenli uçtan uca şifreleme ile iş birliği yapın.

- **Uçtan Uca Şifreleme**: PBKDF2HMAC'den türetilmiş Fernet simetrik şifreleme (AES-128).

- **Sıfır Güven (Zero-Trust)**: Ana sunucu anahtarlarınızı asla görmez; sırrı sadece siz ve eşiniz (peer) bilir.

- **Doğal Dil Köprüsü**: Bir Yardımcı "Disk alanını kontrol et" der ve Ana Bilgisayarın yapay zekası bunu çevirip `Get-PSDrive` komutunu çalıştırır.

- **Küresel Erişim**: Bulut bağımlılığı olmadan dünya çapında erişim için `ngrok` gibi tünellerle sorunsuz çalışacak şekilde tasarlanmıştır.

**Güvenli İş Birliği (Log):**

`Ana Bilgisayar: [Niyeti Onaylar]` → `Çalıştırılıyor: Get-PSDrive C`

Terminal artık sadece metinden ibaret değil.

- **Araştırma Yeteneği**: Dokümantasyon bulmak ve genel hataları düzeltmek için canlı web'de gezinebilir.

- **Kendi Kendini Onarma**: Bir komut başarısız olursa, ZAI görev tamamlanana kadar stratejiyi otomatik olarak değiştirir (örn. CMD'den PowerShell'e geçer).


| Özellik | ZAI Shell v9.0 | ShellGPT | Open Interpreter | GitHub Copilot CLI | AutoGPT |

|---------|----------------|----------|------------------|-------------------|---------|

| **Sentinel (Güvenlik)** | ✅ 4-Boyutlu Risk Ayrıştırma | ❌ Yok | ⚠️ Basit Onay | ❌ Yok | ⚠️ Tehlikeli Döngüler |

| **Panik Algılama** | ✅ Davranışsal Analiz | ❌ Yok | ❌ Yok | ❌ Yok | ❌ Yok |

| **Risk Açıklaması** | ✅ Bağlama Duyarlı Anlatım | ❌ Yok | ❌ Yok | ❌ Yok | ❌ Yok |

| **Ders Hafızası** | ✅ Hatalardan Öğrenir | ❌ Yok | ❌ Yok | ❌ Yok | ⚠️ Genel |

| **Kendi Kendini Onarma** | ✅ 5-Stratejili | ❌ Manuel | ❌ Manuel | ❌ Manuel | ⚠️ Sonsuz Döngüler |

| **P2P Şifreleme** | ✅ Uçtan Uca Şifreli Ağ | ❌ Yok | ❌ Yok | ❌ Yok | ❌ Yok |

| **Çevrimdışı AI** | ✅ Dahili Yerel Model | ✅ Yerel Modeller | ✅ Yerel Modeller | ❌ Sadece Bulut | ❌ Sadece API |

| **Web Araştırma** | ✅ Canlı Sentez | ⚠️ Özel Fonk. | ✅ Tam Erişim | ❌ Yok | ✅ Dahili |

| **Kalıcı Bellek** | ✅ Vektör + JSON | ⚠️ Sadece Sohbet | ✅ Geçmiş | ⚠️ Sınırlı | ✅ Uzun Süreli |

| **Düşünme Modu** | ✅ Görünür Akıl Yürütme | ❌ Kara Kutu | ❌ Kara Kutu | ❌ Kara Kutu | ⚠️ Çok Sözlü |

| **Kabuk Esnekliği** | ✅ 13+ Kabuk Desteği | ✅ Çoklu Kabuk | ✅ Çoklu Kabuk | ⚠️ Sadece Belirli | ⚠️ Python Yerel |

| **Maliyet** | ✅ Ücretsiz Katman + Çevrimdışı | ✅ Ücretsiz (Yerel) | ✅ Ücretsiz (Yerel) | ❌ Ücretli Abonelik | ⚠️ Yüksek API Ücretleri |

| **GUI Otomasyonu** | ✅ Hibrit (Terminal + Vizyon) | ❌ Sadece Terminal | ✅ OS Modu | ❌ Sadece Terminal | ⚠️ Sadece Tarayıcı |

*Görev: 'pdfs' klasörü oluştur ve 48 dosyayı taşı. Süre: 3.34sn*

- **[📄 Tam Stres Testi Sonuçlarını Oku](BENCHMARK/ZAI_DOOMSDAY_PROTOCOL.md)**

**Hibrit İş Akışı:** Terminal + GUI otomasyonu ile Opera GX kurulumu


**Çapraz Kabuk Gücü:** Tek bir istekte WSL → CMD → PowerShell → WSL kullanımı


ZAI v9.0, özerklik ve güvenlik için tasarlanmış, kesinlikle doğrulanmış bir yürütme döngüsü üzerinde çalışır:

1. **Niyet**: Kullanıcı "Python kurulumunu onar" isteğinde bulunur.

2. **Plan**: Yapay zeka, bir yürütme planı oluşturmak için belleğe ve araçlara danışır.

3. **Sentinel Kontrolü**: Plan, siz görmeden önce risk açısından puanlanır.

* *Düşük Risk*: Sessizce devam et.

* *Yüksek Risk*: **DUR**. Risk faktörlerini göster. Açık onay iste.

4. **Yürütme**: Doğrulanmış komutlar çalıştırılır.

5. **Sonuç & Onarım**:

* *Başarı*: Sonuç döndürülür.

* *Başarısızlık*: Hata yapay zekaya geri bildirilir → Yeni Plan → sentinel tekrar kontrolü → Tekrar Dene.

| **Sentinel** | `sentinel status` | Risk metriklerini, son uyarıları ve sağlık puanını görüntüle. |

| | `sentinel on/off` | Güvenlik katmanını aç/kapa (Önerilmez). |

| | `sentinel reset` | Davranışsal risk geçmişini temizle. |

| **P2P Paylaşım** | `share start` | Oturum başlat (IP/Port otomatik üretilir). |

| | `share connect <IP>` | Yardımcı olarak bir oturuma katıl. |

| | `share encrypt <şifre>` | Şifre ile E2E (Uçtan Uca) şifrelemeyi etkinleştir. |

| | `share file <yol>` | Dosyaları eşlere (peers) güvenli bir şekilde aktar. |

| | `share approve/reject` | Gelen yardımcı komutları için ana bilgisayar kontrolü. |

| | `memory <komut>` | `show`, `search`, veya `clear` ile vektör belleği yönet. |

| | `telemetry off` | Anonim kullanım istatistiklerini devre dışı bırak. |

| **Modlar** | `normal` | Dengeli performans (Varsayılan). |

| | `eco` | Token verimli mod. |

| | `lightning` | Maksimum hız, minimum çıktı. |

- Python 3.8+

- Gemini API Anahtarı (Ücretsiz)

pip install google-generativeai colorama psutil posthog

$env:GEMINI_API_KEY="anahtariniz_buraya"

python zaishell.py

*İsteğe bağlı: P2P şifreleme için `pip install cryptography`, uzun süreli bellek için `pip install chromadb`.*

ZAI Shell, kararlılığı, performansı ve özellik geliştirmeyi iyileştirmek için **anonim** kullanım verilerini (ör. başarı oranları, hata sayıları) toplar.

**Kodunuzu, dosya içeriklerinizi, komut metinlerinizi veya kişisel verilerinizi ASLA toplamayız.**

Telemetri varsayılan olarak **AÇIK**tır. Devre dışı bırakmak için:

telemetry off

ZAI Shell v9.0, sistem düzeyinde komutlar çalıştırabilen güçlü bir araçtır. **Sentinel** riski önemli ölçüde azaltsa da, onaylanan tüm eylemlerden kullanıcı sorumludur. **Yüksek Riskli uyarıları her zaman inceleyin.**