محمود عبدالنبي
تحسين التحويل · أداة سطر أوامر · 2

دليل المستودع: محاكي خرائط الانتباه البصري لصفحات الهبوط

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

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

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

Build an open-source visual attention saliency generator in Python (visual_saliency.py): 1) Uses multi-scale luminance, color-opponent, and edge orientation gradients (Itti-Koch-Niebur model approximation) to calculate visual attention maps from landing page screenshots, 2) Overlays a smooth jet/turbo colormap heatmap onto the original image, 3) Computes a heuristic CTA prominence score (0-100) for comparative exploration, not a validated measure of conversion or gaze.

لمن صُمم؟

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

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

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

  • docs/cognitive-load-benchmarks.md
  • docs/visual-hierarchy-guidelines.md
  • examples/input_hero.png
  • examples/output_heatmap.png
  • LICENSE
  • README.md
  • src/saliency_simulator.py
  • src/visual_saliency.py
  • tests/test_saliency.py

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

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

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

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

  • Heuristic Scope: Saliency heatmaps represent algorithmic approximations of pre-attentive human vision (luminance, color contrast, edge orientation), not actual eye-tracking.
  • RTL Scanning Bias: Saliency models for Arabic interfaces must account for right-to-left scanning patterns that reverse traditional Western F-shaped gaze paths.
  • Above-the-Fold Viewport Constraints: Evaluates primary CTA visual pop against busy background imagery on mobile viewports (390px width).

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

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