كتاب وصفات 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/server ضمن شجرة docs/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 | استخدام دُفعي آمن للعامل |
batch-pdf-generation-with-progress-tracking | Core | توليد ملفات PDF دُفعيًّا مع تتبّع تقدّم غير متزامن |
rest-invoice-end-to-end | Core | فاتورة واحدة عبر REST: الإرسال، والاستطلاع، والتنزيل، والتحقّق محليًّا |
output-approval | Core | بوابة الإخراج بإشراف بشري داخل الحلقة |
mcp-agent-session | Core | جلسة وكيل MCP مُسجَّلة مع رحلة الموافقة ذهابًا وإيابًا |
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 خدمة الشبكة.