توليد عروض PowerPoint بوكيل ذكاء اصطناعي مع ppt-master: المستودع hugohe3/ppt-master مسار عمل (مهارة، «skill») يُنفَّذ داخل أداة وكيل مثل Claude Code أو Cursor أو Codex CLI لتحويل مستند أو موضوع إلى عرض PowerPoint أصلي قابل للتعديل. كان يعرض نحو 65600 نجمة و5200 فرع في منتصف أكتوبر 2026، بترخيص MIT.
الفائدة لفريق تقني ليست تنسيق الصفحات: بل السلسلة الكامنة وراءه. مستندات داخلية تمر عبر وكيل، ثم ربما عبر خدمات توليد صور أو بحث، وتصل الفاتورة بالرموز (tokens). يعرض هذا المقال ما يقوله README، ويفصّل التثبيت، ويشرح كيف تبقي زمام البيانات والتكاليف.
المعلومات مأخوذة من README والأسئلة الشائعة وهيكل ملفات المستودع. لم تثبّت span.observer أداة ppt-master ولم تختبرها: اللقطات أدناه صور منشورة في المستودع من المشروع، ومقتطف حقيقي من README صُيّر للقراءة.
توليد عروض PowerPoint بوكيل ذكاء اصطناعي مع ppt-master: ما الذي يقوله المستودع
- المؤلف والترخيص: مشروع مستخدم GitHub المسمى
hugohe3، الذي يذكر في README أنه يبنيه ويتولاه بمفرده في الغالب. ترخيص MIT، وحقوق نشر 2025-2026؛ ويوضح ذيل README «الإسناد مطلوب» وأن GitHub ومرآة AtomGit فقط هما الرسميان. - الوعد: إنتاج ملف PowerPoint حقيقي (
.pptx) بأشكال أصلية ومخططات وجداول قابلة للتعديل، لا صور مسطّحة. ويقر المشروع نفسه بأنه لا ينبغي توقع نتيجة مثالية من أول مرة: يتحدث README عن أداة، «لا عن بئر أمنيات». - المتطلبات: Python 3.10 أو أحدث؛ وPandoc للصيغ القديمة فقط (.doc و.odt و.rtf و.tex…).
- النموذج: يصوغ README المعادلة «harness + model = agent»: لا يقدم المشروع سوى مسار العمل، وسقف الجودة يحدده النموذج. ويوصي بنموذج ذي نافذة سياق كبيرة (نحو مليون رمز).

العرض أعلاه صورة مثال من المستودع (المجلد docs/assets/screenshots/archive): عرض من عشر صفحات عن نوع من الطيور، بصور فوتوغرافية ورسوم تخطيطية ومخططات. ويوضح README أن الأمثلة تُنتَج في مرة واحدة دون تعديل يدوي.

الصورة الثانية صفحة عنوان لمثال بأسلوب «بكسل آرت»، ينشره المشروع أيضًا. ويقترح README أمثلة أخرى على الإنترنت (عرض توضيحي ومستودع أمثلة منفصل) للحكم على الجودة قبل التثبيت.
تثبيت ppt-master بحسب README
الخطوة 1: Python
ثبّت Python 3.10 أو أحدث. على Windows، فعّل «Add to PATH» أثناء التثبيت، وراجع الدليل المخصص docs/windows-installation.md في المستودع. وعلى macOS يعطي README الأمر brew install python؛ وعلى Ubuntu أو Debian الأمر sudo apt install python3 python3-pip.
الخطوة 2: أداة وكيل
يقبل README أي أداة قادرة على قراءة الملفات وكتابتها وتنفيذ الأوامر وإجراء محادثة: محررات بوكيل مدمج أو امتدادات أو وكلاء بسطر أوامر. ويقول المؤلف إنه يفضّل Claude Code، البيئة الأعمق اختبارًا بحسب قوله.
الخطوة 3: احصل على المشروع
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt
لتحديث نسخة مستنسخة، يعطي README الأمر python3 skills/ppt-master/scripts/update_repo.py. ويقترح أيضًا تنزيل ZIP، ومسار «marketplace»: npx skills add hugohe3/ppt-master أو، في Claude Code، /plugin marketplace add hugohe3/ppt-master ثم /plugin install ppt-master@ppt-master. وفي هذه الحال يوضح README أنه يلزم مع ذلك تشغيل pip install -r requirements.txt من المجلد المثبَّت.
الخطوة 4: أنشئ عرضًا
افتح مجلد المشروع في الوكيل، وضع المستند المصدر في projects/، ثم اطلب بلغة طبيعية، مثلًا «Please create a PPT from projects/q3-report/sources/report.pdf». افتراضيًا يؤكد الوكيل أولًا مواصفات التصميم (القالب والصيغة وعدد الصفحات). ويصف README أيضًا وضعًا سريعًا، عند الطلب الصريح.

يصل الملف النهائي إلى exports/<nom>_<horodatage>.pptx؛ ويكتب المسار الافتراضي أيضًا معاينات للصفحات في svg_final/. ويُنتج الخيار --native-charts-and-tables، بحسب README، مخططات وجداول PowerPoint مع «Edit Data» في ملف منفصل.
الصور والمفاتيح والبيانات: أين يذهب ماذا
يؤكد README أنه، خارج استدعاءات النموذج وخدمات البحث والصور والصوت التي تفعّلها، يعمل كل شيء على جهازك. وهذا إعلان من المشروع، ويمكنك التحقق منه بمراقبة حركة الشبكة. يُوصَف مساران للصور:
- التوليد: أداة الصور الخاصة بالوكيل، أو
image_gen.pyمع المتغيرIMAGE_BACKENDومفتاح API الخاص بالمزوّد. - البحث عن الصور: يستعلم
image_search.pyمن Openverse وWikimedia Commons دون مفتاح، إضافة إلى Pexels وPixabay إن قدّمتPEXELS_API_KEYوPIXABAY_API_KEY. ويذكر README أن الأداة تضيف إسنادًا على الشريحة حين يقتضيه الترخيص.
توضع المفاتيح في ملف .env: عامله كسرّ (ليس في Git أبدًا). ويسرد README أيضًا، بين رعاته، خدمات «ترحيل API» (API relay) تعيد بيع الوصول إلى النماذج. ويحتوي المستودع على روابط إحالة لها؛ وتمرير مستنداتك عبر وسيط قرار أمني، لا مجرد حيلة سعرية.
مراقبة التكاليف وتسرب البيانات
ppt-master ليس خدمة: لا يصدر تتبعات. ولا يذكر README ولا الأسئلة الشائعة OpenTelemetry. تقول الأسئلة الشائعة إنك تدفع بحسب استخدامك للذكاء الاصطناعي، دون اشتراك مضاف، وإن المستودع لا يوثّق أي علاقة مقيسة بين إعادة استخدام قوالب العروض وعدد الرموز. إذن ما يُقاس هو الوكيل:
- الرموز والتكلفة لكل عرض، بطرق تتبع تكلفة وكيل الذكاء الاصطناعي؛ فالنموذج ذو نافذة السياق الكبيرة جدًا مكلف مع مستند طويل.
- البيانات الصادرة: أي المستندات تذهب إلى أي مزوّد نموذج أو صور أو بحث. راجع ضوابط حماية وكلاء الذكاء الاصطناعي في الإنتاج.
- التتبّع: احتفظ بالمجلد
projects/لكل عرض، بمصادره ومخرجاته، لتتمكن من إعادة تشغيل نتيجة ما وتدقيقها.
وللمقارنة مع حزمة مكتبية أصلية، راجع GridCraft، جدول بيانات مفتوح المصدر بلغة Rust، الذي يتبنى مقاربة معاكسة: تطبيق بلا وكيل.
كيف تتحقق من أن كل شيء يعمل
- يُفتح ملف
.pptxفي PowerPoint ويمكن تحديد كل شكل وتعديله؛ والنصوص ليست صورًا. - مع
--native-charts-and-tables، يفتح «Edit Data» فعلًا بيانات المخطط. - تطابق أرقام العرض المستند المصدر: راجعها رقمًا رقمًا.
الحدود والنقاط المفتوحة
- الجودة تعتمد على النموذج. يقولها README: «the model sets the ceiling». وكلما قلّت قدرة النموذج زاد ما يبقى للتنقيح.
- حدود PowerPoint. تُحذف SmartArt عمدًا؛ ويسرد الدليل
docs/powerpoint-svg-mapping.mdوظيفةً وظيفةً ما هو مغطى. - ترخيص الاعتماديات. يعتمد محوّل PDF الاختياري على PyMuPDF، بترخيص AGPL-3.0 لا MIT، وينبّه README إلى ذلك قبل أي إعادة توزيع لحزمة تتضمنه.
- الإحالة والإعلان. يحتوي README على روابط إحالة ورموز ترويجية وتوصية بنموذج لأحد الرعاة. هذه عناصر تجارية في المستودع، تُميَّز عن الجانب التقني.
- دقة المحتوى. قد يحتوي عرض مولَّد على أخطاء جوهرية؛ ويبقى التحقق بشريًا.
- البيانات. المستند السري المرسل إلى نموذج مستضاف يغادر نطاقك؛ تحقق من شروط المزوّد.
أفضل الممارسات
- جرّب أولًا على مستند عام، بميزانية مسقوفة لدى المزوّد.
- أبقِ ملف
.envخارج المستودع واستخدم مفاتيح مخصصة قابلة للإلغاء. - اختر مزوّد النموذج بحسب حساسية المستندات؛ وتجنب الوسطاء للمحتوى الداخلي.
- راجع كل رقم وكل مصدر قبل النشر؛ واحتفظ بمجلد المشروع.
- عطّل خدمات الصور الخارجية إن كان يجب ألا تخرج مستنداتك.
الأسئلة الشائعة
هل يحل ppt-master محل PowerPoint؟
لا. بحسب README، يولّد ملف .pptx تواصل تحريره في PowerPoint؛ ولا يقدم محررًا.
هل هو مجاني؟
الشيفرة بترخيص MIT ولا يضيف المشروع أي اشتراك؛ وتدفع مقابل استخدام نموذج الذكاء الاصطناعي وخدمات الصور التي تفعّلها.
هل تغادر مستنداتي جهازي؟
بحسب README، لا يخرج سوى استدعاءات النموذج وخدمات البحث أو الصور أو الصوت التي تفعّلها؛ وهذا إعلان من المشروع ينبغي التحقق منه على شبكتك. ولمقاربة أخرى لوكلاء محليين، راجع OpenClaw.
الخلاصة
يلبي ppt-master حاجة ملموسة: الحصول على ملف PowerPoint حقيقي قابل للتعديل انطلاقًا من مستندات. والمشروع شفاف في أن النموذج هو ما يحدّ النتيجة. أما من جهة التشغيل، فاحتفظ بثلاثة أمور: تكاليف رموز تُسقَّف، ومفاتيح تُحمى، ومستندات يُختار مسارها عن وعي.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في الوثائق الرسمية (github.com/hugohe3/ppt-master).