دليل وصفات Connect
دليل وصفات Connect
قسم بعنوان «دليل وصفات Connect»يفتح NextPDF Connect محرّك NextPDF أمام جهات الاستدعاء البعيدة وأنظمة الذكاء الاصطناعي (AI) عبر بروتوكول سياق النموذج (MCP)، وواجهة برمجة تطبيقات قائمة على نقل الحالة التمثيلي (REST)، وخدمة gRPC. يجمع دليل وصفات Connect وصفات المهام لهذه الواجهات، وتمثّل هذه الصفحة فهرسه. يسجّل الفهرس مُعرِّف كل وصفة (slug)، والفئة التي تنتمي إليها، وحدّ النقل المنطبق عليها. وبما أن هذه الصفحة فهرس، فهي لا تقدّم أي ادعاء سلوكي بشأن أي وصفة. تُؤلَّف كل صفحة وصفة في مستودع nextpdf/server ضمن docs/public/، وتمتلك ادعاءاتها الخاصة، ثم يسحبها المُجمِّع إلى هذا الموقع مع الحفاظ على إسنادها إلى مصدرها.
للاطّلاع على العقد الذي تتّبعه كل وصفة من وصفات Connect، اقرأ اصطلاحات الوصفات. للاطّلاع على المشهد الكامل لتكامل المنظومة، اقرأ دليل وصفات التكامل.
كيف تؤثر الفئة فيما يمكنك تشغيله
قسم بعنوان «كيف تؤثر الفئة فيما يمكنك تشغيله»تحسب عملية نشر Connect مجموعة أدواتها عند بدء التشغيل؛ فهي ليست ثابتة مسبقًا. يسجّل سجلّ أدوات الخادم الأدوات الأساسية دائمًا. ثم يفحص وجود مُزوِّدَي Pro وEnterprise باستخدام class_exists()، ولا يسجّل أدواتهما إلا عند تثبيت nextpdf/premium إلى جانب الخادم. الوصفة التي تعتمد على أداة Pro أو Enterprise لا تعمل إلا في عملية نشر تتوفّر فيها تلك الأداة. في التثبيت الذي يقتصر على المصدر المفتوح، تكون الأداة غائبة، ويُعيد الاستدعاء خطأ أداة غير معروفة بدلًا من أن يتدهور بصمت. تذكر كل وصفة فئتها، ويجمّع هذا الفهرس الوصفات حسب الفئة لتتمكن من رؤية ما يدعمه النشر بلمحة.
إجمالي عدد الأدوات خاصية تشغيلية لعملية النشر. لا تؤكد أي وصفة، ولا أي صف في هذا الفهرس، عددًا ثابتًا. الكتالوج المرجعي هو كتالوج أدوات الخادم نفسه، الذي ترتبط به كل وصفة.
النقل ونموذج الأخطاء
قسم بعنوان «النقل ونموذج الأخطاء»تُستدعى كل وصفة بالطريقة نفسها عبر وسائل النقل الثلاث كلها: tools/call الخاص بـ MCP، أو نقطة نهاية الأداة في REST، أو خدمة gRPC. وهي تتشارك منفّذ أدوات واحدًا. الوصفات التي تصل إلى خدمة بعيدة عبر بروتوكول نقل النص التشعبي (HTTP) تتعامل مع فشل النقل وحالة HTTP غير الناجحة بوصفهما حالتين منفصلتين. لا يطلق عميل PSR-18 استثناء عميل مُنمَّطًا إلا عندما يتعذّر عليه إرسال الطلب أصلًا، كما هو موصوف في PSR-18 §4. تختلف استجابة 4xx أو 5xx عن ذلك؛ فهي قيمة إرجاع عادية يفحصها المستدعي، وليست استثناءً، كما هو موصوف في PSR-18 §4.
خريطة معرّفات الوصفات
قسم بعنوان «خريطة معرّفات الوصفات»تقع كل وصفة في /cookbook/connect/<recipe>/. يعرض الجدول المُعرِّف، والفئة التي تندرج ضمنها الوصفة، ونطاقًا موجزًا في سطر واحد. تُؤلَّف صفحات الوصفات في nextpdf/serverdocs/public/ وتُجمَّع هنا. إلى أن تظهر الصفحة، يبقى رابطها إحالة مستقبلية.
| الوصفة | الفئة | النطاق |
|---|---|---|
hello-world (مخطّط له مبدئيًّا) | Core | أول استدعاء عبر Connect: الإنشاء وإضافة المحتوى والإخراج |
multi-page (مخطّط له مبدئيًّا) | Core | مستند متعدّد الصفحات عبر Connect |
image-embedding (مخطّط له مبدئيًّا) | Core | تضمين صورة عبر Connect |
html-table (مخطّط له مبدئيًّا) | Core | عرض جدول HTML عبر Connect |
font-typography (مخطّط له مبدئيًّا) | Core | الخطوط والطباعة عبر Connect |
exception-aware (مخطّط له مبدئيًّا) | Core | استدعاءات أدوات تراعي الاستثناءات |
environment-diagnostics (مخطّط له مبدئيًّا) | Core | أدوات تشخيص البيئة |
layout-inspection (مخطّط له مبدئيًّا) | Core | فحص التخطيط دون عرض |
worker-safe (مخطّط له مبدئيًّا) | Core | استخدام دُفعي آمن للعامل |
output-approval (مخطّط له مبدئيًّا) | Core | بوابة الإخراج بإشراف بشري داخل الحلقة |
event-hooks (مخطّط له مبدئيًّا) | Core | خطّافات أحداث دورة الحياة |
fill-pdf-form (مخطّط له مبدئيًّا) | Pro | تعبئة نموذج PDF عبر Connect |
extract-text-content (مخطّط له مبدئيًّا) | Pro | استخراج المحتوى النصي عبر Connect |
digital-signature (مخطّط له مبدئيًّا) | Pro | توقيع ملف PDF (PAdES B-B وB-T) عبر Connect |
accessibility-check (مخطّط له مبدئيًّا) | Pro | فحص إتاحة PDF/UA |
pii-redaction (مخطّط له مبدئيًّا) | Enterprise | إزالة البيانات الشخصية المكتشَفة من طبقة النص (تدميري) |
aria-tagged-pdf (مخطّط له مبدئيًّا) | Pro | تعيين أدوار معالم ARIA إلى بنية موسومة |
figure-caption (مخطّط له مبدئيًّا) | Pro | شكل متاح يتضمّن تعليقًا متداخلًا |
aria-noteref-pattern (مخطّط له مبدئيًّا) | Pro | نمط مرجع الحاشية ومتنها |
compliance-check (مخطّط له مبدئيًّا) | Enterprise | تشغيل فحص لمعيار مُسمّى |
forensic-analysis (مخطّط له مبدئيًّا) | Enterprise | تحليل جنائي رقمي لملف PDF موقَّع |
ltv-health-check (مخطّط له مبدئيًّا) | Enterprise | فحص صحّة LTV (B-LT/B-LTA، لفئة Enterprise فقط) |
batch-compliance (مخطّط له مبدئيًّا) | Enterprise | فحص دُفعي للمعايير |
ai-ready-certification (مخطّط له مبدئيًّا) | Enterprise | فحص جاهزية الذكاء الاصطناعي (ليس شهادة) |
page-artifacts (مخطّط له مبدئيًّا) | Enterprise | وسم زخارف الترقيم بوصفها عناصر تحفّظية (artifacts) |
conformance-mode (مخطّط له مبدئيًّا) | Enterprise | اختيار وضع توافق (مُعدّ ليتوافق؛ القرار للمدقّق) |
cjk-vertical-writing (مخطّط له مبدئيًّا) | Enterprise | مقاييس الكتابة العمودية لـ CJK |
opentelemetry (مخطّط له مبدئيًّا) | Core | مراقبة Connect باستخدام OpenTelemetry |
tagged-pdf-tutorial (مخطّط له مبدئيًّا) | Core | دليل تعليمي لـ PDF موسوم (مُعدّ ليتوافق؛ القرار لـ veraPDF) |
يشير المُعرِّف إلى غرض الوصفة بصيغة kebab-case مع شَرطة مائلة نهائية واحدة: بلا بادئة رقمية، وبلا رقم إصدار، وبلا امتداد ملف. لا يتغيّر مُعرِّف الوصفة بعد النشر، ويحمل المُعرِّف المنقول إعادة توجيه.
حدّ التوافق والشهادات
قسم بعنوان «حدّ التوافق والشهادات»تتناول عدة وصفات معايير (PDF/UA-2 وPDF/A-4 وPAdES). يتعامل دليل وصفات Connect مع دعم المعيار بوصفه دعمًا، لا توافقًا ولا شهادة أبدًا. يُنتج المحرّك مخرجات مُعدّة لتتوافق، ويقرّر مدقّق مستقل (مثل veraPDF) التوافق. وصفة جاهزية الذكاء الاصطناعي هي فحص جاهزية، وليست شهادة. مادة التحقق طويل الأمد في وصفة LTV قدرة لفئة Enterprise فقط. وجودها في مستند يعني أن المستند يحمل هذه القدرة، وليس ضمانًا لصلاحية التوقيع إلى أجل غير مسمّى. تعيد كل وصفة معنية ذكر هذه الحدود بالكامل. يكتفي هذا الفهرس بملاحظة وجودها والإشارة إلى موضع اشتقاقها، بدلًا من إعادة اشتقاقها هنا.
انظر أيضًا
قسم بعنوان «انظر أيضًا»- اصطلاحات الوصفات — العقد الذي تتّبعه كل وصفة من وصفات Connect.
- دليل وصفات التكامل — مرجع الحِزَم والتكامل على مستوى المنظومة، حيث يكون Connect خدمة الشبكة.