Install
require('pptxgenjs')لمن يناسب
كلما دخل ملف .pptx أو .potx في الأمر — كمدخل أو مخرج أو كليهما — استخدم دليل pptx هذا. يشمل ذلك عمل الشرائح أو عروض الطريق أو العروض التقديمية، وقراءة النص أو تحليله أو استخراجه. يضع الملخص أيضًا التحرير والدمج والتقسيم والقوالب والملاحظات والتعليقات في النطاق نفسه. شرط التشغيل: الحاجة إلى فتح هذا النوع من الملفات أو إنشائه أو تغييره.
يختار المسار حسب المهمة، وليس عبر واجهة رسومية واحدة. لا تقدم المادة قائمة بمنتجات وكلاء؛ لا تعتبره حكرًا على برنامج بعينه. صفحة الدليل الرسمية هي
https://raw.githubusercontent.com/anthropics/skills/main/skills/pptx/SKILL.md
أكمل أول محاولة في 3 دقائق
المسار الأول الموصى به هو ما تذكره المادة صراحة: pptxgenjs مثبت مسبقًا، فلا تشغّل npm install أولاً. اكتب سكربتًا ونفّذ:
require('pptxgenjs')
الشرط المسبق: البيئة الحالية تستطيع تشغيل هذا require. إشارة النجاح: ينجح الاستيراد ولا يبلغ عن وحدة ناقصة. هذا تحقق للقراءة فقط؛ لا تكتب عرضًا إلى القرص بعد. فقط إذا فشل require يجوز استخدام أمر الاحتياط في الصفحة نفسها npm install pptxgenjs. لا تعامل تثبيت الاحتياط كالخطوة الأولى الافتراضية.
إذا نجح الاستيراد وأكدت أنك تريد ملفًا جديدًا، فاكتب سكربتًا يولّد .pptx. قبل الكتابة إلى القرص أكّد اسم ملف الإخراج وما إذا كان سيستبدل ملفًا قائمًا. يذكر الملخص أن القراءة يمكن أن تستخدم markitdown أو thumbnail.py، لكن المقتطف لا يكتب استدعاء markitdown كاملاً؛ لـ thumbnail.py خطر استبدال (انظر الحالات أدناه)، فلا تشغّل المصغرات أولاً.
حالات الاستخدام
الحالة الأولى: إنشاء عرض جديد. المسار هو pptxgenjs: اكتب سكربتًا ونفّذ require('pptxgenjs') مباشرة دون npm install أولاً. تصف المادة .pptx بأنه ZIP من ملفات XML وتطلب اختيار الطريقة حسب المهمة: الإنشاء عبر pptxgenjs، والتحرير بفك الضغط / تغيير XML الشرائح / إعادة التعبئة، والقراءة عبر markitdown أو thumbnail.py من الملخص. تغطي هذه الحالة الإنشاء فقط. معيار الإكمال: ينجح require في السكربت، وبعد تأكيد مسار الإخراج يُنتَج ملف .pptx. لا يعطي المقتطف واجهة شرائح محددة، فلا تخترع أسماء دوال تخطيط صفحات لم تظهر.
الحالة الثانية: قبل إنشاء شبكة مصغرات لملف قائم، تجنّب الاستبدال. تقول المادة إنه يجب تمرير prefix؛ الافتراضي هو thumbnails ويستبدل شبكات عروض أخرى في الدليل نفسه. يطلب الملخص تسمية الوسيط الثاني وفق الملف. الأمر له آثار جانبية: اختر prefix لا يتصادم، وتأكد أن الدليل لا يحوي شبكة بالاسم نفسه، ثم نفّذ. معيار الإكمال: أعددت prefix مستقلًا لهذه المخرجات، لا إعادة استخدام thumbnails الافتراضي.
حدود الاستخدام
.pptx هو ZIP من XML؛ اختر الطريقة حسب المهمة: أنشئ بالـ pptxgenjs المثبت مسبقًا؛ حرّر XML؛ للقراءة لا تثبّت حزمة أولاً افتراضيًا. فقط إذا فشل require: npm install pptxgenjs. يستبدل prefix المصغرات الافتراضي الشبكات الأخرى في الدليل نفسه.
لا تكتب مسار مستودع لم يظهر كأمر تثبيت. إذا لم يكن لقدرات الملخص مثل markitdown أو الدمج أو التقسيم أمر كامل، فاكتب فقط أن «المادة سمّتها والخطوات غير موسّعة». ما يتجاوز محفزات التشغيل وترتيب require وآثار prefix المكتوبة هنا خارج تغطية هذا الدليل.