🛡️ GuardScan

مجاني ومفتوح المصدر 100% • أداة سطر أوامر لفحص الأمان ومراجعة الشيفرة بالذكاء الاصطناعي مع أولوية الخصوصية

  ____ _   _   _    ____  ____    ____   ____    _    _   _            ____ _     ___ 
 / ___| | | | / \  |  _ \|  _ \  / ___| / ___|  / \  | \ | |          / ___| |   |_ _|
| |  _| | | |/ _ \ | |_) | | | | \___ \| |     / _ \ |  \| |  _____  | |   | |    | |
| |_| | |_| / ___ \|  _ <| |_| |  ___) | |___ / ___ \| |\  | |_____| | |___| |___ | | 
 \____|\___/_/   \_\_| \_\____/  |____/ \____/_/   \_\_| \_|          \____|_____|___|

 Privacy-First AI Code Review & Security Scanning

---

🎉 مجاني تمامًا - لا اشتراكات، لا حدود

GuardScan مجاني ومفتوح المصدر بنسبة 100%! لا نظام رصيد، لا جدران دفع، لا اشتراكات.

ما تحصل عليه (كل شيء مجاني)

• ✅ تحليل ثابت غير محدود - 9 أدوات فحص أمني + أدوات جودة الكود
• ✅ مراجعة كود معززة بالذكاء الاصطناعي - استخدم مفتاح API الخاص بك (OpenAI، Claude، Gemini، Ollama)
• ✅ يعمل دون اتصال بالكامل - لا حاجة للإنترنت للتحليل الثابت
• ✅ الخصوصية أولًا - لا يرفع شيفرتك المصدرية أبدًا
• ✅ لا حدود للاستخدام - افحص عددًا غير محدود من أسطر الكود، وعددًا غير محدود من المستودعات

---

🚀 البدء السريع

# Install globally via npm
npm install -g guardscan

# Initialize GuardScan
guardscan init

# Run comprehensive security scan (100% FREE, offline)
guardscan security

# Configure AI provider for enhanced review (optional, BYOK)
guardscan config

# Run AI-enhanced code review
guardscan run

# Check status
guardscan status

🐳 Docker / Alpine Linux

لبيئات Docker، وخاصة Alpine Linux:

# Install dependencies first
apk add --no-cache python3 make g++ pkgconfig cairo-dev pango-dev \
  libjpeg-turbo-dev giflib-dev pixman-dev freetype-dev build-base git

# Install GuardScan
npm install -g guardscan

# Set home directory (important for Docker)
export GUARDSCAN_HOME=/app/.guardscan

# Initialize
guardscan init

التوثيق:

• 📖 دليل Docker الشامل - دليل كامل لنظامي Linux وmacOS وWindows
• 🐧 مرجع سريع لـ Docker وAlpine - مرجع سريع خاص بـ Alpine Linux

---

📋 الميزات الأساسية

🔒 فحص الأمان (مجاني، دون اتصال)

يتضمن GuardScan أدوات فحص أمان شاملة:

1. كشف الأسرار - العثور على مفاتيح API وكلمات المرور والرموز المضمّنة في الكود (أكثر من 20 نمطًا)
2. ثغرات التبعيات - فحص تبعيات npm وpip وMaven وCargo
3. أهم 10 مخاطر من OWASP - حقن SQL، وXSS، والإعدادات غير الآمنة، وCSRF، وXXE
4. أمان Docker - فحص Dockerfile والحاويات
5. البنية التحتية ككود - أمان Terraform وCloudFormation وKubernetes
6. أمان API - تحليل نقاط نهاية REST وGraphQL

📊 جودة الكود والتحليل (مجاني، دون اتصال)

7. مقاييس الكود - التعقيد الحلقي، ومقاييس Halstead، ومؤشر قابلية الصيانة
8. روائح الكود - أكثر من 30 نمطًا مضادًا (الفئات الإلهية، والدوال الطويلة، والأرقام السحرية)
9. الامتثال للتراخيص - التحقق من تراخيص التبعيات (MIT، GPL، Apache، وغيرها)
10. فحوصات الامتثال - فحص الامتثال لـ GDPR وHIPAA وPCI-DSS
11. تكامل أدوات الفحص - ESLint وPylint وRuboCop وغيرها
12. عدّاد أسطر الكود - عدّ الأسطر حسب اللغة (أكثر من 20 لغة)

🧪 الاختبار والأداء (مجاني، دون اتصال)

13. مشغّل الاختبارات - تنفيذ اختبارات Jest وpytest وJUnit وتحليلها
14. اختبار الطفرات - التحقق من فعالية مجموعة الاختبارات (يتطلب Stryker - اختياري)
15. اختبار الأداء - اختبار الحمل وقياس الأداء (يتطلب k6 - اختياري)
16. إنشاء SBOM - قائمة مكونات البرمجيات (CycloneDX، SPDX)

ملاحظة: يتطلب اختبار الأداء واختبار الطفرات أدوات خارجية اختيارية.

🤖 ميزات معززة بالذكاء الاصطناعي (BYOK - أحضر مفتاحك الخاص)

9 ميزات متقدمة مدعومة بالذكاء الاصطناعي:

1. شارح الكود (guardscan explain) - فهم الكود المعقد
2. مراجعة الكود (guardscan review) - مراجعة شاملة للكود بالذكاء الاصطناعي
3. مولّد رسائل الالتزام (guardscan commit) - إنشاء رسائل الالتزام
4. مولّد التوثيق (guardscan docs) - إنشاء التوثيق تلقائيًا
5. مولّد الاختبارات (guardscan test-gen) - إنشاء اختبارات الوحدة
6. اقتراحات إعادة الهيكلة (guardscan refactor) - تحسين جودة الكود
7. نمذجة التهديدات (guardscan threat-model) - تحليل بنية الأمان
8. مساعد الترحيل (guardscan migrate) - ترحيل الأطر واللغات
9. الدردشة التفاعلية (guardscan chat) - أسئلة وأجوبة حول قاعدة الكود مدعومة بـ RAG

🌍 دعم لغات متعددة

محللات AST لأكثر من 7 لغات:

• TypeScript/JavaScript
• Python
• Java
• Go
• Rust
• Ruby
• PHP
• C#

🔌 تكاملات مزوّدي الذكاء الاصطناعي

قم بتهيئة أي مزوّد ذكاء اصطناعي تفضّله:

• OpenAI (GPT-4، GPT-4 Turbo، GPT-3.5)
• Anthropic Claude (Claude 3 Opus، Sonnet، Haiku)
• Google Gemini (Gemini Pro)
• Ollama (محلي، يركز على الخصوصية - llama2، codellama، mistral)
• LM Studio (نماذج محلية)
• OpenRouter (الوصول إلى نماذج متعددة)

تدفع لمزوّد الذكاء الاصطناعي مباشرة - لا يتقاضى GuardScan أي رسوم!

---

🛠️ الأوامر

جميع الأوامر مجانية 100% وبلا حدود!

أوامر التهيئة

الأمر	الوصف
guardscan init	تهيئة الإعدادات وإنشاء client_id
guardscan config	تهيئة مزوّد الذكاء الاصطناعي والإعدادات
guardscan status	عرض الإعدادات ومعلومات المستودع
guardscan reset	مسح ذاكرة التخزين المؤقت والإعدادات المحلية

أوامر الأمان والتحليل

الأمر	الوصف
guardscan security	تشغيل فحص أمان شامل (دون اتصال)
guardscan scan	فحص أمان سريع
guardscan run	مراجعة كاملة للكود معززة بالذكاء الاصطناعي (BYOK)

أوامر الاختبار والجودة

الأمر	الوصف
guardscan test	تشغيل الاختبارات وتحليل جودة الكود
guardscan perf	اختبار الأداء واختبار الحمل (يتطلب k6 - اختياري)
guardscan mutation	اختبار الطفرة لجودة الاختبارات (يتطلب Stryker - اختياري)

ملاحظة: تتطلب أوامر perf وmutation أدوات خارجية اختيارية. راجع دليل أدوات الاختبار للحصول على تفاصيل التثبيت والاستخدام.

أوامر الأدوات المساعدة

الأمر	الوصف
guardscan sbom	إنشاء قائمة مكونات البرمجيات (SBOM)
guardscan rules	محرك قواعد مخصص قائم على YAML

الأوامر المدعومة بالذكاء الاصطناعي (BYOK)

الأمر	الوصف
guardscan explain <file>	شرح كيفية عمل الكود
guardscan review <file>	مراجعة شاملة للكود بالذكاء الاصطناعي
guardscan commit	إنشاء رسائل الالتزام (commit)
guardscan docs <file>	إنشاء التوثيق تلقائيًا
guardscan test-gen <file>	إنشاء اختبارات الوحدة
guardscan refactor <file>	الحصول على اقتراحات إعادة الهيكلة
guardscan threat-model	تحليل البنية الأمنية
guardscan migrate	المساعدة في الترحيل بين الأطر/اللغات
guardscan chat	أسئلة وأجوبة تفاعلية حول قاعدة الكود (RAG)

---

🔒 ضمانات الخصوصية

نأخذ الخصوصية على محمل الجد:

❌ لا يتم تخزينها أو نقلها أبدًا