Install
require('docx'); npm install docx only if require failsلمن يناسب
لمن يحتاج وكيلًا ينشئ مستندات Word (.docx / .dotx) أو يقرأها أو يعدّلها أو يعالجها: تقارير ومذكرات ورسائل وقوالب، أو استخراج وإعادة ترتيب واستبدال صور وبحث واستبدال ومراجعات وتعليقات في ملف Word قائم. يقول الدليل: استخدم هذه المهارة عندما يذكر المستخدم مستند Word أو .docx أو .dotx، أو يطلب مستندًا رسميًا بفهرس وعناوين وأرقام صفحات أو ترويسة.
لا تناسب PDF أو جداول البيانات أو Google Docs أو البرمجة العامة غير المرتبطة بتوليد المستندات. ثبّت الدليل الحد بـ Do NOT use؛ لا توسّعه إلى صيغ أخرى.
أقرّ أولًا التبعيات: docx (npm، مثبت مسبقًا) وpandoc وLibreOffice (soffice) وpdftoppm (Poppler). بلا pandoc على مسار القراءة لا تكتمل أول قراءة. لا يفرض الدليل سوق وكيل معيّن؛ لا تستنتج متجرًا أو تثبيتًا بنقرة.
أول تجربة في 3 دقائق
الشرط: الوكيل الحالي حمّل المهارة المسماة docx، ويمكن استدعاء pandoc على الجهاز أو من مجلد المهارة. رسميًا docx مثبت مسبقًا؛ لا تشغّل npm install أولًا. فقط إذا فشل require('docx'): npm install docx.
المسار الرئيسي الموصى به قراءة فقط لا تعديل فوري. في محادثة حُمّلت فيها المهارة نفّذ أمر القراءة الرسمي على .docx تملكه:
pandoc -t markdown file.docx
استبدل file.docx بالاسم الحقيقي. يقرأ الملف ويخرج Markdown. هذه قراءة لا ضمان بلا فقد. أكّد المسار حتى لا تحوّل مستندًا يجب أن يبقى خاصًا. لا يوجد تراجع في الدليل. النجاح: انتهاء الأمر بنص Markdown. لا يصف الدليل اختيار المهارة في واجهة الوكيل؛ فقط استخدامها عند الحاجة إلى Word.
إن عدّلت لاحقًا مستندًا قائمًا فتوقف أولًا: المسار الرسمي unzip → تحرير word/document.xml → zip، ويُذكر أن docx-js لا يفتح الملفات القائمة. هذه كتابة تغيّر الأرشيف؛ تأكد من وجود نسخة. لا تبدأ المحاولة الأولى بمسار الكتابة.
حالات الاستخدام
الحالة 1: قراءة. pandoc -t markdown file.docx يحوّل Word قائمًا إلى Markdown؛ تحقق من العناوين والمتن. الدليل يغطي أمر القراءة هذا فقط لا محوّلات أخرى.
الحالة 2: تحرير مستند قائم. الخطوات الرسمية الثلاث على الأرشيف وتغيير word/document.xml ثم إعادة zip. docx-js لا يفتح الملفات القائمة؛ لا «تفتح الملف القديم بـ docx-js». مسار أثر جانبي صريح؛ انسخ أولًا. لا يوجد سكربت كامل؛ المعاملات الناقصة تبقى مجهولة.
حدود الاستخدام
القراءة تعتمد على pandoc. الكتابة تعتمد على فك الضغط / XML / إعادة التعبئة وقد تستخدم لاحقًا LibreOffice وpdftoppm للتحقق خارج هذه المحاولة الأولى. لا تستخدمها لـ PDF أو الجداول أو Google Docs. docx المثبت مسبقًا لا يلغي npm install docx إذا فشل require('docx'). واجهات الوكيل والتراجع ونموذج الصلاحيات غير مذكورة؛ أبقِ الفجوات مجهولة ولا تكتب «بلا مخاطر».