لترحيل الوثائق إلى Markdown، قدم للوكيل الذكي مجلد الأرشيف ودعه ينفذ convert_to_markdown مرة واحدة لكل ملف، في دفعات تم مراجعتها. مع GroupDocs.Markdown.Mcp يحدث هذا محليًا في Claude Code أو Cursor أو GitHub Copilot أو أي عميل MCP آخر، لذا لا يتم رفع أرشيف الإجراءات الداخلية إلى خدمة تحويل:

حوّل كل ما في مجلد الأرشيف إلى Markdown مع بيانات مقدمة (front matter) والصور كملفات. أبلغ عن تنسيق المصدر، عدد الصفحات، وحجم الإخراج لكل ملف.

الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: How to migrate legacy documentation to Markdown with AI.

لماذا تُعد ترحيل وثائق قديمة مهمة للوكيل؟

التحويل ميكانيكي والعمل المحيط به متكرر: سرد الملفات، تحويل كل منها، قياس النتيجة، العثور على الفشل، التكرار. شخص يقوم بذلك لمئات الملفات يتخذ نفس القرار مئات المرات. الوكيل يقوم بذلك باستمرار ويبلغ عن كل نتيجة، بينما المحرك—not النموذج—ينتج الـ Markdown. الـ Markdown المحفوظ ليس إعادة صياغة لإجراءاتك.

هذا دليل تشغيل. كل خطوة لها موجه واحد، والجدول بعده يفصل ما يقرره الوكيل عما يفعله المحرك.

دليل تشغيل: كيف أُرحل أرشيف Word إلى Markdown؟

  1. تحقق من الترخيص قبل أي شيء آخر.

    قبل التحويل: ما هو حالة ترخيص خادم الـ markdown؟

    get_license_status تُعيد mode، licensed، consumption وإصدارات الخادم والمحرك. وضع التقييم يعالج 3 صفحات لكل مستند، لذا تشغيل غير مرخص ينتج مقاطع نصية معقولة.

  2. جرد الأرشيف.

    قوّم كل ملف في مجلد الأرشيف مع تنسيقه، عدد صفحاته، وما إذا كان مشفرًا.

    لا يمتلك خادم الـ Markdown أداة لسرد المجلدات، لذا يقوم الوكيل بسرد المجلد باستخدام وصول ملف العميل الخاص أو يعمل من أسماء الملفات التي تزوده بها.

    ثم get_document_info تُعيد fileFormat، pageCount، title، author وisEncrypted لكل ملف دون تحويله. تحتاج الملفات المشفرة إلى معامل password.

  3. شغّل تجربة أولية لحوالي عشرين ملفًا.

    حوّل أول عشرين مستندًا إلى Markdown مع بيانات مقدمة والصور كملفات. أبلغ عن التنسيق، الصفحات، وحجم الإخراج لكل ملف.

  4. اكتشف ما لم يتحول.

    قوّم ملفات PDF التي أنتج تحويلها أقل من 2 KB من Markdown لأكثر من 5 صفحات.

    هذه غالبًا ما تكون مسحات ضوئية. لا توجد خطوة OCR في هذا الخادم، لذا تحتاج إلى أداة أخرى أو تبقى كملفات PDF مفهرسة بالبيانات الوصفية.

  5. صحّح النمط، ثم شغّل البقية في دفعات. عشرون ملفًا لكل جولة، مع تقرير في كل مرة، يحافظ على مراجعة العملية ويجعل الاستخدام القائم على العداد متوقعًا.

  6. راجع الإخراج كما تراجع طلب سحب. الأقسام التالية تسرد ما يجب النظر إليه.

القرار الوكيل المحرك
أي ملفات يجب تحويلها، بأي ترتيب وحجم دفعة نعم لا
أي خيارات يجب تمريرها (images، frontMatter، flavor) نعم، من موجهك لا
تحويل العناوين والقوائم والجداول إلى Markdown لا نعم
حفظ ملفات .md والملفات الصورة لا نعم
اكتشاف ملف 300 صفحة أصبح حجمه 4 KB نعم، من التقرير لا
إعادة تسمية، تخطيط المجلد، مفاتيح بيانات مقدمة إضافية نعم لا

أي الصيغ تُرحل بشكل جيد؟

  • DOCX، DOC، RTF، ODT. البنية صريحة في المصدر، لذا تنتقل العناوين والجداول بوضوح.
  • EPUB وMOBI. بنية الفصول تُطابق عناوين Markdown.
  • CHM. ملفات المساعدة القديمة، غالبًا النسخة الوحيدة لإجراء ما.
  • XLSX. الأوراق تصبح جداول، وهو مناسب لقوائم المعلمات.

ما الذي يجب أن يتحقق منه فحص المراجعة؟

اطلب من الوكيل إجراء الفحص الأول، ثم اقرأ عينة بنفسك:

لكل ملف تم تحويله، قوّم الصور التي يشير إليها وأخبرني أي ملفات صور مفقودة.

أرني الخمسة مخرجات ذات أصغر حجم بالنسبة لعدد صفحاتها.

الصور المكتوبة بـ images: "file" تُوضع بجوار ملف .md وتُشار إليها بمسار نسبي، وهو ما يتوقعه مستودع الوثائق. ملف .md يشير إلى صور لم تُكتب أبدًا يُظهر صورًا مكسورة. ثم افتح المصدر الأكثر فوضى وإخراجه جنبًا إلى جنب قبل تطبيق النمط على البقية. التزم بالنتيجة التي راجعتها باستخدام سير عمل git المعتاد؛ الخادم يكتب الملفات ولا يلمس مستودعك.

جلسة مثال (مختصرة)

You:   حوّل أول عشرين مستندًا في /archive إلى Markdown مع بيانات مقدمة
       والصور كملفات. أبلغ عن التنسيق، الصفحات، وحجم الإخراج لكل ملف.
Agent: convert_to_markdown (frontMatter: true, images: "file") x 20
       ops-manual-2014.docx   DOCX   88 صفحة   تم التحويل
       install-guide.chm      CHM    41 صفحة   تم التحويل
       supplier-forms-2009.pdf PDF   12 صفحة   1 كيلوبايت من Markdown: ربما مسح ضوئي
       تسعة عشر ملفًا تبدو متسقة؛ مسح ضوئي واحد يحتاج إلى معالجة منفصلة.

حدود صادقة

بدون ترخيص، وضع التقييم يعالج فقط أول 3 صفحات من كل مستند، مع علامة مائية تقييم على كل منها. تشغيل ترحيل في هذه الحالة ينتج مئات الملفات القصيرة التي تبدو صحيحة، وتُكتشف الفجوة بعد أسابيع عندما يبحث أحدهم عن إجراء مفقود. الترقي يحتاج إلى ترخيص، لذا شغّل get_license_status قبل الدفعة الأولى. ملفات PDF الممسوحة ضوئيًا لا تتحول.

الأسئلة المتكررة

هل يمكنني تحويل مئات مستندات Word إلى Markdown مرة واحدة؟

نعم، لكن ليس في موجه واحد. حوّلها في دفعات حوالي عشرين ملفًا واطلع على التقرير بعد كل دفعة، حتى تُصحح الخيار الخاطئ قبل تطبيقه على الأرشيف كله.

كيف أُرحل الوثائق إلى git باستخدام وكيل ذكي؟

الخادم يكتب ملفات .md وملفات الصور في مجلد الإخراج. أنت تراجعها وتلتزم بها باستخدام سير عمل git المعتاد.

هل ترحيل الوثائق ككود يرفع مستنداتي؟

لا. GroupDocs.Markdown.Mcp عملية محلية، ويُقرأ الأرشيف من القرص. ما يكتبه الوكيل في المحادثة هو ما يصل إلى مزود النموذج فقط.

تعمق أكثر