ترجمة آلية
تمت ترجمة هذه الصفحة تلقائيًا بواسطة الذكاء الاصطناعي وقد تحتوي على أخطاء. إذا كان هناك أي شيء غير واضح، يُرجى الرجوع إلى المصدر الإنجليزي.
خريطة قراءة الهندسة المعمارية¶
مرجع على مستوى الآلية لأدوات pplx (pplx-export / pplx-ask):
التبعيات، خطوط الأنابيب، آلات الحالة، عقود البيانات، وحدود الموثوقية.
للاستخدام الموجه نحو المهام، ابدأ بـ دليل المستخدم.
النطاق ومصدر الحقيقة
تشرح هذه الصفحات هندسة pplx_export/ للوكلاء والمهندسين الذين يحافظون على المشروع.
تستخدم مراجع الأسطر file.py:NN، نسبة إلى pplx_export/.
تم التحقق من الأوصاف مقابل المستودع في 2026-07-23 (__version__ = "0.1.0"،
pplx_export/__init__.py:31)؛ يظل الكود الحالي والاختبارات موثوقة.
1. ابدأ بخريطة النظام¶
- نظرة عامة على الهندسة المعمارية — الطبقات، مسؤوليات الوحدات، ورسم بياني للتبعيات على مستوى الاستيراد.
2. اتبع تدفق وقت التشغيل¶
- خط أنابيب التصدير — الجلب، الاحتفاظ بالاستجابة الخام، اكتشاف الوضع، وعرض Markdown.
- الوكلاء الفرعيون والمقاطعات — إسناد الحمولة ودلالات المقاطعة/الاستئناف.
- pplx-ask والحسابات — الاستعلامات المتدفقة و تبديل ملفات تعريف الارتباط متعددة الحسابات.
3. فهم البيانات والموثوقية¶
- نموذج البيانات وعقد الدليل — النماذج، حدود الكتابة، وعقد الأرشيف على القرص.
- تحديد المعدل ومعالجة الأخطاء — التقييد، التراجع، الحالات النهائية، وتوجيه الأخطاء.
- العمليات غير المتصلة بالإنترنت — إعادة العرض بدون شبكة، إعادة بناء العلاقات، وخطوط أنابيب الصيانة المحلية.
4. مراجع ذات صلة¶
- مرجع Web API — عقود REST/GraphQL المرصودة، دلالات الاستجابة، وملاحظات الاكتشاف.
- دليل المشرف — هندسة الاختبار، سير عمل المساهم، وعقود المحاكاة الثابتة.