إصلاح PDF على الإنترنت في مقابل البحث عن «Recovery Toolbox»: ما يفعله PDF123

حين يرفض ملف PDF أن يُفتح، تخلط نتائج البحث عادةً بين فكرتين مختلفتين: إصلاح بنية ملف تالف، وبرامج «استرداد» مكتبية تحمل علامة تجارية. ويقدّم PDF123 (pdf123.xyz)، المنشور باسم PDF Toolbox، الفكرة الأولى كأداة مجانية على الإنترنت وواجهة API لإصلاح PDF، وليس كمنتج Windows المبيع باسم Recovery Toolbox for PDF.

ما معنى «الإصلاح» لملف PDF معطوب

ملف PDF يرمي «الملف تالف» أو يرفض الفتح تكون خريطته الداخلية معطوبة عادةً، أي مشكلات في الجدول المرجعي التبادلي أو في تدفق الكائنات، لا صور صفحات مفقودة يمكن إعادة رسمها يدوياً. ويعيد Repair PDF (POST /api/v1/misc/repair) بناء تلك البنية بإعادة كتابة الملف عبر qpdf من البايتات الصالحة المتبقية. وعندما ينجح الاسترداد، يستطيع العارض فتح الملف مجدداً من دون تغيير محتوى الصفحات المقصود.

وهذا يختلف عن:

• OCR وتنظيف المسح: حين يُفتح الملف لكن النص صورة فقط (OCR هنا يعيد Markdown لا طبقة نصية مخفية)
• فك كلمة المرور: حين يكون الملف مشفّراً وتعرف كلمة المرور أصلاً (Unlock)
• حزم الاسترداد المكتبية: تطبيقات تُثبَّت وتستهدف استرداداً جنائياً عميقاً على جهاز محلي
• الضغط والتحويل: أدوات حجم وصيغة تحتاج أولاً ملف PDF قابلاً للتحليل

صندوق أدوات على الإنترنت في مقابل استعلامات «Recovery Toolbox»

ولا نزعم تكافؤ الميزات ولا السعر ولا تفاصيل الإصدار لمنتج Recovery Toolbox for PDF، فهو منتج منفصل. ويقتصر هذا الجدول على توضيح القناة والقصد: إصلاح عبر API على الإنترنت في مقابل علامة استرداد مكتبية ربما كتبها أحدهم في Google.

فحص مسبق قبل الإصلاح

يعيد Get Info فحصاً مسبقاً بصيغة JSON يحمل FileSize وPageCount وEncrypted وحقول Info والإصدار. استخدمه لترى إن كان المحلّل قادراً على تحميل الملف، وإن كان التشفير يمنع تعديلات أخرى. ولا يزيل الإصلاح كلمات المرور. وتجد شجرة قرار خطوة بخطوة لحالة «الملف لا يُفتح» في الملف لا يُفتح: افحص ثم أصلح ثم توقف عن التخمين.

متى تستخدم الإصلاح ومتى تستخدم OCR

1. لا يستطيع العارض فتح الملف إطلاقاً ← جرّب Repair PDF أولاً.
2. يُفتح الملف لكنك لا تستطيع تحديد النص أو البحث فيه في مسح ضوئي ← استخدم OCR وتنظيف المسح للحصول على نص Markdown، واضغط الملف منفصلاً إن كان الحجم مهمّاً (سير عمل حزمة المسح).
3. تحتاج الإصلاح نفسه داخل سكربت أو وكيل ← استدعِ واجهة API لإصلاح PDF؛ وراجع المطوّرين للمفاتيح وOpenAPI. ويفضَّل إرسال Idempotency-Key عند إعادة المحاولة (Idempotency-Key).

كيف يبدو النجاح

بعد الإصلاح، يفترض أن يفتح العارض الملف من دون خطأ «ملف PDF تالف» متى بقي عدد كافٍ من الكائنات. وينبغي أن يطابق عدد الصفحات من Get Info ما تتوقعه من الأصل حين تعافت البنية سليمة. وإن ظل الملف رافضاً للفتح، فلن تخترع استدعاءات لاحقة للضغط أو OCR أو التحويل بايتات مفقودة؛ توقّف واحفظ الأصل لأدوات جنائية خارج هذا الكتالوج إن كانت السياسة تقتضي ذلك.

جرّبه

ارفع ملفاً تالفاً على Repair PDF، أو استدعِ POST /api/v1/misc/repair بمفتاح API. واحفظ الأصل التالف بجوار أي نسخة مُصلَحة. وللوصول الموجَّه للوكلاء، من MCP وخطوط المعالجة إلى OpenAPI، ابدأ من المطوّرين.