تشرح وثائق Agent-Native Slides الانتقال من طلب إلى عرض قابل للتحرير ثم تصديره في HTML مستقل. الدليل لمن يألف Node وأوامر الطرفية. ستستخدم نصك الواقعي لإنشاء ثلاث شرائح وتصحيح عنصر معين وفحص التنزيل. نعتمد على الوثائق والشيفرة التي فحصناها؛ لم نشغّل التطبيق أو نختبر التصدير.

التغيير الكبير

  • ما الذي تغيّر: يمكن تحرير العرض المولّد كشرائح وتنزيله في ملف HTML واحد للمشاهدة.
  • لماذا يهم: المقارنة بالمصدر والتصحيح الدقيق يبقيان مسؤولية الحقائق لدى القارئ. الفحص الحاسم في الملف المصدّر.
  • ما الذي تراقبه: الاستضافة المحلية للتطبيق؛ اتصال النموذج يحدد مكان معالجة الطلبات والرسوم المحتملة. لم نثبت سعرًا ثابتًا لكل عرض أو تطابقًا كاملًا بين الحزمة والالتزام البرمجي.

جهّز المصدر والتطبيق المحلي

  1. اكتب مقطعًا قصيرًا يمكن التحقق منه. احتفظ بنسبته وأرقامه الدقيقة وتواريخه. حدد جملة أو رقمًا لتصحيحه بعد التوليد واكتب البديل الدقيق. استخدم مادة مسموحًا بإرسالها إلى مزود النموذج المختار. خادم التطوير المحلي لا يجعل استدعاء النموذج السحابي محليًا.
  2. ثبّت Node.js 22.22 أو أحدث وأتح pnpm. نفّذ في الطرفية:
Terminal
   npx --yes @agent-native/core@0.209.2 create my-slides --standalone --template slides
   cd my-slides
   corepack enable
   pnpm install

الإصدار المثبّت 0.209.2 هو حزمة npm التي تحققنا منها لهذه الخطوات. شيفرة المستودع المفحوصة أدناه تخص التزامًا منفصلًا؛ لم نثبت أن الحزمة المنشورة تضم تلك الشيفرة بالضبط.

  1. صل نموذجًا قبل طلب العرض. وفق مسار OpenAI الموثق، أضف الآن OPENAI_API_KEY إلى .env على جانب خادم التطبيق المولّد. شغّل pnpm dev، وافتح الرابط المحلي الظاهر واختر Continue as local dev في Welcome. قد يتغير المنفذ إذا كان 8080 مشغولًا. اختر النموذج في Settings. أو شغّل التطبيق وأضف بيانات اعتماد شخصية أو للمؤسسة عبر Custom keys. أبعد المفتاح عن الطلبات ولقطات الشاشة ومتغيرات VITE_ التي قد تنكشف في شيفرة المتصفح. افحص شروط الوصول والأسعار قبل إرسال المصدر؛ رخصة إطار العمل المفتوحة لا تغطي استخدام النموذج.

أنشئ ثلاث شرائح وافحصها

  1. انقر New deck. الصق المصدر في طلب الوكيل واطلب ثلاث شرائح بالضبط باستخدام تلك الحقائق فقط. حدد غرض كل شريحة: الموضوع والحقائق الأساسية والخلاصة المدعومة بالمصدر. اطلب إبقاء الاقتباسات أو النسبة عند الحاجة. هذه القيود لا تضمن التزام التوليد بها.
  2. عدّ الشرائح وقارن كل سطر واقعي بالأصل. احذف غير المدعوم. افحص الأرقام والتواريخ والأسماء والتحفظات والنص المقصوص في التخطيط. افعل ذلك قبل التصحيح المخطط لتمييز ذلك التغيير عن الأخطاء الأخرى.
  3. افتح شريحة العنصر المحدد وانقر النص مرتين. استبدل ذلك العنصر فقط بالصياغة أو القيمة الدقيقة المعدة. أعد قراءة الشريحة والأخريين. يتوفر Revise with AI للنص المحدد، لكن التحرير المباشر يحصر التصحيح ويتجنب طلبًا آخر للنموذج.
  4. افتح Export في المحرر واختر Download HTML. افتح ملف .html المنزّل في متصفح. افحص الشرائح الثلاث والتنقل للأمام والخلف والنص المصحح، وقارن تخطيط كل شريحة بالمحرر. ظهور التصحيح في المحرر لا يثبت وصوله إلى التنزيل. HTML الموثق ملف مشاهدة مستقل بتنقل بلوحة المفاتيح، وليس PowerPoint قابلًا للتحرير. يستخدم Google Slides مسار استيراد PPTX منفصلًا.

إذا تعطّل زر التصدير، تحقق من وجود شرائح. عند خطأ اعتماد نظير أثناء التثبيت، يقترح دليل البدء npx clear-npx-cache قبل المحاولة مجددًا. للتراجع عن تعديل غير مرغوب، تشرح الوثائق سجل النسخ والاستعادة؛ افحص النص المستعاد قبل إعادة التصدير. هذه حلول موثقة لا أعطال لاحظناها.

المصادر وقراءات إضافية

  • دليل البدء: متطلبات Node وpnpm والتطوير المحلي وخيار Welcome واستعادة الإعداد.
  • نظرة على Slides: أمر الإنشاء وNew deck وتوليد العرض.
  • ميزات Slides: تحرير النص مباشرة واستعادة النسخ وHTML المستقل.
  • متغيرات البيئة: موضع مفتاح OpenAI وCustom keys واختيار النموذج والمتغيرات المكشوفة للمتصفح.
  • المصدر المثبّت لقائمة Export: Download HTML وتعطيله للعرض الفارغ. الالتزام المفحوص ليس دليلًا على محتوى حزمة npm الدقيق.