Destek Merkezi

Sık Sorulan Sorular

Guardian hakkında bilmeniz gereken her şey. Aradığınızı bulamadınız mı? İletişime geçin.

Genel

Guardian nedir?
Guardian, küçük mühendislik ekiplerinin AI ile üretilen veya AI destekli kodu release öncesi kontrol etmesi için tasarlanmış local-first bir desktop + CLI yönetişim katmanıdır. Riskli değişiklikleri ayırır, takım politikalarını uygular ve insan onay kararlarını denetim iziyle kaydeder.
Guardian kimler için?
Guardian, AI destekli değişikliklerde politika temelli release güveni isteyen küçük mühendislik ekipleri için tasarlanmıştır. Genel bir chatbot, coding assistant veya scanner değildir.
Ekibimiz zaten güçlü LLM ajanlarla review yapıyorsa neden Guardian kullanalım?
Güçlü modeller kod inceleyebilir; ancak Guardian ajan akışının eksik bıraktığı noktayı tamamlar: policy-as-code uygulaması, CLI/CI'da deterministik release gate, insan onayı + override gerekçesi ve kalıcı karar denetim izi.
Guardian açık kaynak mı?
Bu repository MIT lisanslıdır. Fork veya paketlenmiş bir dağıtım kullanıyorsanız, ilgili build ile gelen LICENSE dosyası nihai kaynaktır.
Guardian hangi platformları destekliyor?
Guardian bugün macOS (Apple Silicon ve Intel) ve Windows installer olarak yayınlanır. Linux yükleyicileri yayınlandıkça indirme sayfasında görünür.
Guardian hangi AI sağlayıcılarını destekliyor?
Guardian OpenAI, Anthropic, Google Gemini, GitHub Models ve Ollama (lokal) destekler. Workspace bağlamınızı veya tarama geçmişinizi kaybetmeden istediğiniz zaman sağlayıcı değiştirebilirsiniz.
Guardian kodumu buluta gönderiyor mu?
Sadece bir cloud AI sağlayıcısı etkinleştirdiğinizde. Guardian, kodu AI'ya göndermeden önce 19+ gizli bilgi ve PII kalıbını (API anahtarları, JWT'ler, veritabanı URL'leri, e-postalar, telefon numaraları) otomatik maskeler. Ollama ile tamamen çevrimdışı da çalışabilirsiniz.

Başlarken

Guardian'ı nasıl kurarım?
İndirme sayfasına gidip işletim sisteminize önerilen paketi indirin. Kurulumu çalıştırın ve uygulama içindeki setup adımlarını takip edin.
Sistem gereksinimleri neler?
Yayınlanan desktop installer'lar için macOS 12+ veya güncel Windows 10/11 gerekir. En az 4GB RAM ve ~500MB boş disk alanı önerilir. İnternet sadece cloud AI sağlayıcıları veya update kontrolü etkinse gereklidir.
Guardian'ın hangi dosyaları tarayacağını nasıl kontrol ederim?
Ayarlar > Scan Scope alanını kullanın. Source (varsayılan) kodu hedefler ve docs/tests/scripts/lockfiles gibi gürültüyü atlar. Extended infra ve güvenlik yüzeylerini ekler (Docker/CI/lock/config). Full çoğu text dosyayı tarar (tek seferlik derin audit için).
Guru ile web search nasıl kullanılır?
Ayarlar'da Tavily anahtarınızı ekleyin ve Web Search'ü açın. Tek mesaj için web search zorlamak isterseniz sorunun başına /web ekleyin veya @web yazın. Mesajınızda bir URL varsa Guardian önce o sayfadan odaklı extract yapmayı tercih eder; yoksa search kullanır.

Geliştirici Araçları

Guardian'ı CI/CD'de nasıl kullanırım?
guardian-cli kurun ve pipeline'ınıza ekleyin: 'guardian-cli scan . --format json --output report.json'. GitHub Actions, GitLab CI ve her build sistemi desteklenir. AI olmadan sadece policy kontrolü için --offline kullanın.
MCP Server nedir?
MCP (Model Context Protocol) sunucusu, Cursor ve Claude Desktop gibi editörlerdeki AI asistanların Guardian'ın yönetişim araçlarına doğrudan erişmesini sağlar. Editörünüzden çıkmadan dosya tarama, policy kontrolü ve kod sınıflandırma yapabilir.
VS Code eklentisi var mı?
Evet, guardian-vscode VS Code'da satır içi bulgular, hızlı düzeltmeler ve kanıt görüntüleme ile gerçek zamanlı kod yönetişimi sağlar.
Guardian hangi gizli bilgileri maskeler?
Guardian 19+ kalıbı tespit eder ve maskeler: OpenAI, Anthropic, GitHub, AWS, GCP, Stripe, Slack ve npm tokenları, JWT'ler, veritabanı URL'leri, private key'ler, e-postalar ve telefon numaraları. Maskeleme her zaman açıktır ve kapatılamaz.
Tarama kurallarını özelleştirebilir miyim?
Evet. Guardian güvenlik, mimari ve kalite kalıplarını kapsayan 11+ yerleşik kural içerir. Kuralları guardian.policy.yaml'da yapılandırabilir ve YAML tabanlı kural motoru ile özel kurallar oluşturabilirsiniz.

Destek

Guardian için nasıl yardım alabilirim?
Önce bu sitedeki dokümantasyona bakın. Teknik sorunlar/feature istekleri için issue tracker veya iletişim sayfasını kullanabilirsiniz.
Bug bildirimini / öneriyi nereye yapabilirim?
İletişim sayfasını (önerilir) kullanın ve mümkünse çoğaltma adımlarıyla log ekleyin. İsterseniz repository issue tracker'ı da kullanılabilir.
Guardian ne sıklıkla güncellenir?
Güncellemeler uygulama içi updater ile (etkinse) gelir; yeni release’ler ayrıca distribution reposu üzerinden yayınlanır.

Daha fazla yardım mı lazım?

Sorununuzu ve mümkünse logları paylaşın, birlikte çözelim.