محمود عبدالنبي
التواصل الاجتماعي · مجموعة بيانات منتقاة · 1

دليل المستودع: قواعد وقاموس تصنيف المشاعر في الرصد الاجتماعي العربي

صفحة تعريفية مستقلة بمستودع قواعد وقاموس تصنيف المشاعر في الرصد الاجتماعي العربي. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Build an open-source dialectal Arabic social listening sentiment package: 1) Illustrative dialectal sentiment lexicon categorized into True Positive, True Negative, Sarcastic/Ironic Negative, and Delivery/Service Complaints across Egyptian and Gulf vernacular, 2) Python heuristic classifier (arabic_sentiment.py), 3) Unit tests for selected classifier behaviors.

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • data/arabic_sentiment_lexicon.json
  • docs/annotation-methodology.md
  • docs/sentiment-methodology.md
  • examples/classified_sample_tweets.csv
  • LICENSE
  • README.md
  • rules/arabic_sentiment_lexicon.json
  • rules/sarcasm_dialect_markers.json
  • SOURCES.md
  • src/arabic_sentiment.py
  • src/sentiment_tester.py
  • tests/test_sarcasm_cases.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/arabic_sentiment.py --help

النطاق والقيود

  • Sarcasm & Dialectal Inversion: Accounts for common Arabic sarcastic expressions where surface positive words convey negative sentiment.
  • Regional Morphology Handling: Distinguishes between Egyptian (مش حلو), Gulf (مو زين), and Levant (مو منيح) negation structures.
  • Auditable Heuristic Ruleset: Rule definitions run locally using regex and token lookups without requiring black-box paid APIs.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة