الملف لا يُفتح: افحص ثم أصلح ثم توقف عن التخمين
حين يرفض ملف PDF الفتح، شغّل Get Info كفحص مسبق ثم Repair لإعادة البناء البنيوي. هذا استرداد xref لا نسخة من منتج Recovery Toolbox المكتبي.

ملف PDF يرفض الفتح مشكلة بنية عادةً، من جدول مرجعي تبادلي معطوب أو تنزيل مقتطع أو كائنات مشوّهة، لا صورة صفحة مفقودة يمكن إعادة رسمها يدوياً. والتخمين بـ OCR أو الضغط أو التحويل يهدر الوقت حتى يُحلَّل الملف.
ابدأ بـ Get Info
يعيد Get Info (POST /api/v1/security/get-info-on-pdf) تقريراً بصيغة JSON يحمل FileSize وPageCount وEncrypted وحقول قاموس Info عند وجودها مثل title وauthor وsubject وcreator وproducer وحقل Version الذي يبيّن إصدار PDF، وقائمة Pages بسيطة، وما إذا وُجد جذر المستند. استخدمه كفحص مسبق:
- Encrypted: true يعني أنك تحتاج فكّ قفل مصرّحاً به قبل معظم التعديلات؛ فالإصلاح وحده لا يكسر كلمات المرور.
- PageCount وFileSize معقولان لكن عارضك المكتبي ما زال يفشل: جرّب الإصلاح البنيوي تالياً.
- الاستدعاء نفسه يفشل في تحميل البايتات: قد يكون الملف تالفاً أكثر من أن يمرّ بفحص Info نظيف؛ ومع ذلك جرّب الإصلاح على نسخة.
وGet Info لا يعيد كتابة ملف PDF، بل يخبرك بما يراه المحلّل كي تتوقف عن معالجة كل فشل كأنه «يحتاج OCR» أو «يحتاج ضغطاً».
ثم Repair: إعادة بناء بنيوية عبر qpdf
يعيد Repair PDF (POST /api/v1/misc/repair) كتابة الملف عبر qpdf كي يفتحه العارضون مجدداً متى بقي عدد كافٍ من الكائنات. وعند نجاحه يُحفظ محتوى الصفحات المقصود؛ فالمهمة خريطة الملف، من xref وتدفقات الكائنات، لا استرداد جنائي لمسودات محذوفة.
وRepair ليس:
- تنظيف مسح أو OCR (الملف يُفتح لكن النص صورة فقط): استخدم OCR، وهو يعيد هنا نص Markdown لا طبقة PDF قابلة للبحث
- إزالة كلمة مرور: استخدم فكّ القفل
- إصلاح خطوط أو «إعادة جعل الملف قابلاً للتحرير»
- نسخة من منتج Windows المسمّى «Recovery Toolbox for PDF»
وللتمييز بين العلامة التجارية والقناة، أي الإصلاح البنيوي على الإنترنت في مقابل البحث عن «صندوق أدوات استرداد» مكتبي، اقرأ إصلاح PDF على الإنترنت في مقابل البحث عن Recovery Toolbox.
شجرة قرار لإيقاف التخمين
- لا يستطيع العارض فتح الملف: Get Info ثم الإصلاح.
- الملف يُفتح لكن التحديد أو البحث يفشل في مسح ضوئي: OCR لنص Markdown، واضغط نسخة اختيارياً إن كان الحجم هو المشكلة الباقية (حزمة المسح: OCR ثم الضغط).
- الملف يُفتح وتُصدَّر الجداول بالحالة 204: لم تُكتشف أعمدة؛ راجع تصدير جدول فارغ (204).
- نفس الإصلاح من سكربت أو وكيل:
POST /api/v1/misc/repairعبر المطوّرين. أرسلIdempotency-Keyإن كان عميلك يعيد محاولات الرفع (Idempotency-Key).
ما لن يصلحه «الإصلاح» الناجح
نجاح الإصلاح يعني أن العارض يستطيع فتح الملف مجدداً، ولا يعني:
- إعادة بناء كل صورة صفحة من العدم (الكائنات المفقودة تبقى مفقودة)
- صيرورة النص قابلاً للتحديد في مسح ضوئي (تلك مهمة OCR إلى Markdown هنا)
- اختفاء التشفير (فكّ القفل بكلمة مرور معروفة)
- تصدير الجداول (فما زالت تحتاج نصاً عمودياً، و204 تعني عدم اكتشاف أي منها)
وإن أظهر Get Info عدد صفحات معقولاً بعد الإصلاح بينما صفحة فارغة، فقد تعافت البنية وقد يبقى محتوى تلك الصفحة فارغاً أو مقتطعاً في البايتات الأصلية.
احفظ الأصل التالف
احفظ الأصل التالف بجوار أي نسخة مُصلَحة. وإن عجز الإصلاح عن استرداد بنية كافية، فالنتيجة الصادقة «البايتات ذهبت»، لا أداة عشوائية أخرى في الكتالوج. فضغط ملف ما زال رافضاً للتحليل أو تحويله لا يخترع كائنات مفقودة.
وقارن قصد القناة، أي الإصلاح البنيوي على الإنترنت في مقابل البحث عن علامة «صندوق أدوات استرداد» مكتبية، في إصلاح PDF على الإنترنت في مقابل البحث عن Recovery Toolbox إن كنت وجدت الأداة بهذه الطريقة. ولا حساب مطلوب في مسار المتصفح لأدوات الكتالوج.