Oversight (v0.5.9)

Oversight هي أداة استخبارات أمنية تعمل في الطرفية (terminal) وعارض أكواد ذكي مصمم لتدقيق سكربتات shell وتدفقات ترقية الحزم قبل تنفيذها على نظامك. وهي تسد الفجوة بين الثقة العمياء والتدقيق اليدوي الممل من خلال تحليل استكشافي في الوقت الفعلي ومراجعة تفاعلية.

---

أبرز الميزات

• محرك تدقيق ثابت واستكشافي: يقيّم مخازن السكربتات باستخدام أنماط regex معيارية وإنتروبيا شانون (Shannon entropy) لاكتشاف السلاسل المُشوَّشة والملفات الثنائية المضغوطة وسلاسل دورة الحياة المشبوهة.
• عارض ذكي احتياطي: عندما يمر التدفق بالتحليل دون أي علامات خطر، يعمل Oversight كعارض نصوص سريع الاستجابة مع تمرير سلس للأسطر وتنقل بين الصفحات ودعم عجلة الفأرة.
• فصل فروقات Git متعددة الحزم: يعزل ديناميكيًا تدفقات الترقية الدفعية في تبويبات مخصصة لكل حزمة إلى جانب ملفات البناء المحلية مثل PKGBUILD وسكربتات .install.
• اعتراض مباشر للصدفة (Shell): خطافات خفيفة اختيارية لـ Zsh وBash وFish تعترض الأوامر عالية الخطورة وتطلب التحليل قبل التنفيذ.

---

التثبيت السريع

عبر مستودع مستخدمي Arch (AUR)

yay -S oversight-git

من المصدر

git clone https://github.com/Rakosn1cek/oversight.git
cd oversight
chmod +x install.sh
./install.sh

---

البدء السريع

# Audit a local shell script
oversight ./install.sh

# Audit a remote script safely in memory
oversight https://raw.githubusercontent.com/example/repo/main/install.sh

# Pipe git diffs or manual pages directly
git diff | oversight

التكامل مع مدير الحزم

لاستخدام Oversight كعارض فروقات (diff pager) أثناء ترقيات الحزم، أضف الاسم المستعار (alias) إلى ملف تعريف الصدفة الخاص بك:

# For Yay (~/.zshrc or ~/.bashrc)
alias yay="yay --diffpager oversight"

بالنسبة لـ Paru، أضف هذه الأسطر إلى ~/.config/paru/paru.conf:

[options]
Pager = oversight
CombinedUpgrade

---

مرجع مفاتيح التحكم الأساسية

المفتاح / الإدخال	السياق	الإجراء
↓ / ↑	وضع العارض / التبويبات	تمرير نافذة العرض سطرًا بسطر
↓ / ↑	عرض النتائج	التنقل بين النتائج المُعلَّمة
j / k	جميع العروض	تمرير نافذة العرض سطرًا بسطر
PageDown / Space	جميع العروض	تمرير نافذة العرض لأسفل بمقدار صفحة واحدة
PageUp / b	جميع العروض	تمرير نافذة العرض لأعلى بمقدار صفحة واحدة
d / u	جميع العروض	تمرير نافذة العرض لأسفل أو لأعلى بمقدار نصف صفحة
Home / g / ←	جميع العروض	الانتقال إلى أعلى التدفق
End / G	جميع العروض	الانتقال إلى أسفل التدفق
Tab / 0-9	متعدد الحزم	التنقل الدوري أو الانتقال إلى تبويبات الحزم
s	عرض النتائج	تبديل كتم النتيجة المحددة
عجلة الفأرة	جميع العروض	تمرير نافذة العرض بسلاسة بمقدار 3 أسطر
q / Esc	جميع العروض	الخروج من Oversight

---

الوثائق الكاملة

للاطلاع على أدلة البنية التفصيلية، وتأليف التوقيعات المخصصة (rules.json)، وإعداد العارض العام للنظام، واستكشاف الأخطاء وإصلاحها، قم بزيارة موقع الوثائق الرسمي:

👉 https://rakosn1cek.github.io/oversight/

---

المجتمع والمساهمات

نرحب بالمساهمات وتقديم القواعد والملاحظات.

• ناقش واطرح الأسئلة على Discord (Rakosn1cek Hub)
• افتح مشكلة أو نقاشًا على GitHub

الترخيص

MIT © 2026 Rakosn1cek. يُشترط الإسناد لأي إعادة توزيع أو أعمال مشتقة.