شونيا نت سنتينل (مُحدَّث: 03/02/2026)

شونيا نت سنتينل هو برنامج خفيف الوزن، بتصميم سايبربانك، يقوم بجمع خلاصات RSS (مثل الأخبار العاجلة ووسائل التواصل الاجتماعي)، وإرسالها إلى LLM للتحليل، ثم تسليم التنبيهات والتقارير الموجزة مباشرةً إلى الواجهة الرسومية وسلاك على فترات زمنية منتظمة.

المشروع مبني لاستخدام LLM مستضافة محلياً على نفس الجهاز أو الشبكة (مثال: عبر Tailscale) باستخدام LMStudio أو Ollama (تحديث 02/23). سيعمل أيضاً مع مفتاح OpenAI API (تحديث 02/23).

للتنبيه، يستخدم البرنامج Webhooks سلاك، مما يتيح إرسال إشعارات دفع إلى جهاز محمول.

شونيا نت سنتينل متوافق مع أحدث إصدارات لينكس، ماك أو إس، وويندوز*

جودة التقارير والتحليل تتأثر بالـ prompt، حجم السياق، خلاصات RSS، و LLM المختار. يُنصح بإيقاف ميزات التفكير. النماذج التي يبدو أنها أدت أداءً جيداً وتتبع التعليمات عموماً تشمل:

• GPT OSS 20b (مع ضبط التفكير على LOW في LMStudio)
• GPT OSS 120b (على الأرجح مبالغ فيه)
• Hermes 4 70b (خيارى المفضل)
• Gemma 3 27b it abliterated (نسخة mlabonne)
• Qwen3 32b و/أو VL 30b (لا أتذكر بالضبط...)

*يُوصى بشدة باستخدام ماك أو إس أو لينكس. راجع المشكلات المعروفة أدناه.

لمزيد من المعلومات الهامة، راجع النصائح والحيل والمشكلات المعروفة في النهاية!

---

سير العمل عالي المستوى

1. يقوم المستخدم بإدخال مواضيع الاهتمام
2. يقدم المستخدم قائمة بخلاصات RSS
3. يقوم سنتينل بسحب خلاصات RSS بفترات زمنية يحددها المستخدم
4. يتم إرسال محتوى RSS إلى خادم LLM الذي يوفره المستخدم
5. يراجع LLM الخلاصات ويبلغ سنتينل بالمواضيع ذات الصلة حسب الاهتمام
6. إذا تم تكوين webhook سلاك، يتم توجيه التنبيهات ويمكن الوصول إلى الإشعارات على ios/android (غالباً مع روابط مباشرة لمحتوى RSS المُشار إليه)
7. تحليل شامل اختياري يحدد الاتجاهات بمرور الوقت

---

القدرات الأساسية

مراقبة خلاصات RSS

• سحب دوري لخلاصات RSS
• إزالة التكرار وتتبع الطوابع الزمنية
• التعامل مع الخلاصات البطيئة أو غير الصحيحة (...هناك المزيد من العمل الذي يجب القيام به هنا)

التحليل القائم على LLM (اختياري)

• إرسال عناصر خلاصات RSS إلى نقطة نهاية LLM محلية/API
• تصنيف، تلخيص، وفلترة مدفوعة بـ prompt
• يعمل مع أي نقطة نهاية /v1/chat/completions متوافقة مع OpenAI، مصممة لـ LMStudio

التنبيه / توليد الإشارات

• دعم webhook سلاك (لمعلومات إعداد webhook، اذهب هنا: https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/)
• مخرجات منظمة مناسبة للأتمتة
• مصمم للتكامل في سير عمل أكبر

محلي وذاتي الاستضافة

• بخلاف سحب خلاصات RSS أو إرسال الردود إلى سلاك (اختياري)، تبقى جميع المعلومات على الأجهزة التي تتحكم بها

---

المتطلبات

• بايثون 3.10+
• الاعتماديات المدرجة في requirements.txt:
  • PySide6==6.10.0
  • feedparser==6.0.12
  • requests==2.31.0
  • python-dateutil==2.9.0.post0

LLM مُستضافة عبر:

• LM Studio (مُوصى به)
• Ollama
• مفتاح OpenAI API
• (بعض الإضافات قريباً)

---

التثبيت

1. استنساخ المستودع (...أو تنزيل الضغط) والانتقال إلى المجلد

git clone https://github.com/EverythingsComputer/ShunyaNet-Sentinel.git
cd ShunyaNet-Sentinel

2. (يُوصى بشدة) إنشاء بيئة افتراضية

ماك أو إس / لينكس:

python3 -m venv venv
source venv/bin/activate

ويندوز (PowerShell):

python -m venv venv
venv\Scripts\Activate.ps1

3. تثبيت الاعتماديات

pip install -r requirements.txt

4. التشغيل

ماك أو إس / لينكس:

python3 ShunyaNet_Sentinel.py

ويندوز:

python ShunyaNet_Sentinel.py

---

بداية سريعة (مع LMStudio) (مُحدَّث 02/23)

1. انقر على "Load Prompt File" وقم بتحميل default_prompt.txt
2. انقر على "Load Data Source File" وقم بتحميل خلاصات RSS Default_test
3. افتح "Additional Settings" وأدخل:
   • LM_PROVIDER = lmstudio
   • LLM_BASE_URL = <عنوان IP لخادم LMStudio الخاص بك، مثال: http://x.x.x.x:port/v1>
   • LLM_MODEL = <أوصي بترك هذا فارغاً. اتبع الخطوة 4 فقط>
   • API_KEY = <اترك فارغاً، ما لم تقم بتعيين واحد للخادم الخاص بك>
4. قم بتحميل النموذج في LM Studio. قم بتشغيل "Serve on Local Network" في إعدادات الخادم. نصائح:
   • في نافذة "Load Model"/اختيار النموذج، قم بتشغيل "Manually choose model load parameters"
   • في نافذة معلمات تحميل النموذج الخاص بك، قم بتعيين الحد الأقصى للتنبؤات المتزامنة إلى 1 (في الوقت الحالي)
   • في علامة التبويب الاستدلال (inference)، قم بإيقاف أو تقليل التفكير، إذا كان هذا الإعداد متاحاً.
   • نموذج متوسط الحجم يعمل بشكل جيد: gpt-oss-20b. مع ضبط التفكير على "low"
5. انقر على القطة! (...أو فقط اضغط Fetch / Send)

---

التعليمات الكاملة والإعدادات (مُحدَّث 03/02/2026)

1. أدخل مواضيع الاهتمام، أو قم بتحميل إحدى القوائم الافتراضية المتوفرة. يمكن إضافة ما يصل إلى 10 مواضيع لكل قائمة.

2. انقر على "Load Prompt File" لتحميل ملف prompt. يتم توفير prompt افتراضي (default_prompt.txt).

   1. يُشجعك على تعديل وتحسين هذا الـ prompt - فقد يحسن بشكل كبير جودة التقارير وقدرة LLM على تحديد الإشارة وسط الضوضاء. هناك الكثير من المجال للتخصيص هنا.
   2. يوجد ملف 'default_prompt-always-reply.txt' مدرج في المجلد التجريبي (experimental). إنه قديم، ولكن يمكنك استخدامه لتصحيح أخطاء تحليل LLM والتأكد من أنه يُبلغ بشيء ما بالتنسيق الصحيح.
   3. مُحدَّث 03/02/2026 يوجد أيضاً prompt 'default_Summary-Report-Only_prompt.txt' متوفر. هذا الإصدار لا يسعى لانتقاء إشارة من الضوضاء، بل لتلخيص حجم أكبر من الخلاصات ذات الصلة عندما يكون فضاء المعلومات غنياً بالبيانات المتعلقة بالموضوع. وبالتالي، فهو أكثر فائدة بعد حدوث "الحدث" الذي تبحث عنه. كما أنه من الأفضل استخدامه بشكل أقل تواتراً (مثلاً كل نصف ساعة لحدث سريع ومُبلّغ عنه على نطاق واسع، أو كل بضع ساعات لشيء به بيانات أقل) وبهامش كبير من الرموز (token allowance) للـ prompt والرد.

3. انقر على "Load Data Source File" لتحميل قائمة RSS. يتم توفير قائمتين افتراضيتين. قائمة قصيرة "Default_test" وقائمة أطول "Default_long" تركز على الأخبار العالمية والأخبار العاجلة.

   1. تخصيص قوائمك الخاصة بمنطقتك أو مواضيع اهتمامك سيؤثر بشكل كبير على مخرجات المعلومات. مثال على قائمة مركزة على منطقة استخدمتها في رحلة حديثة متوفرة ('India_regional_example-v1.txt'). مثال متعلق بالنزاع في إيران مدرج أيضاً.
   2. يمكن تحويل ريديت وبلو سكاي بسهولة إلى خلاصات RSS. برامج مثل RSSBridge يمكنها أيضاً توليد خلاصات RSS من مواقع الويب ووسائل التواصل الاجتماعي (مثال: تيليجرام) التي لا تحتوي على واحدة.
   3. قائمة "Default_test" هي قائمة قصيرة لمجموعة متنوعة من خلاصات RSS. الغرض هو جعل أول سحب RSS سريعاً وقصيراً، بحيث يمكنك تشخيص ما إذا كانت جميع الأجزاء تعمل كما ينبغي.

4. في "Additional Settings"، قم بتعيين الحقول التالية. سيتم حفظها والاستمرار بها إذا قمت بإنهاء البرنامج وإعادة تشغيله. الإعدادات الافتراضية ستعمل مع معظم التكوينات - ولكن يجب عليك إدخال الحقل #1 بنفسك: