opf

تنسيق Open Presentation Format (OPF) هو تنسيق مستندات JSON محمول وقابل للقراءة من قبل البشر مخصص لمجموعات الشرائح. يعد هذا المستودع الموطن الرسمي لمواصفات التنسيق، ومخططات JSON Schemas، وقوالب الكتالوج، والأمثلة، وأنواع المطورين المُنشأة، وأدوات التحقق المحلية، ووثائق التخطيط لمجموعة أدوات العرض والتحرير والتحويل المستقبلية. يتم نشره على npm باسم @openpresentation/opf، وهو حالياً في مرحلة ما قبل الاستقرار (0.x، مع توقع تغييرات جذرية بين الإصدارات الفرعية قبل الإصدار 1.0)، بموجب رخصة MIT. الدوافع: إن تنسيق .pptx عبارة عن حزمة مضغوطة من ملفات XML التي يصعب على البشر مقارنة الفروقات فيها، ويصعب على النماذج قراءتها وكتابتها بشكل موثوق، كما يصعب على git تتبعها بشكل فعال، لذا تظهر كل تغييرات ككتلة ثنائية (binary blob). أما OPF فهو عبارة عن JSON بسيط — يمكن قراءته في محرر، وكتابته بواسطة نموذج دون تخمين المخطط من خلال الأمثلة، وتتبعه في نظام التحكم في الإصدارات جنباً إلى جنب مع الأعمال الأخرى. الهدف المعلن هو السماح لنماذج LLMs بالمشاركة في تأليف العروض التقديمية (الهيكل السردي، التأطير، تحليل البيانات، اقتراحات المخططات، المراجعة) بدلاً من الصراع مع علامات التنسيق. الاصطلاحات والتسمية: مستندات OPF هي ملفات JSON تسمى *.opf.json (على سبيل المثال board-review.opf.json) للعروض التقديمية الكاملة. ينصح المشروع بعدم استخدام امتداد *.opf المجرد لأنه مستخدم بالفعل من قبل تنسيقات مستندات ومشاريع أخرى. يمكن لأدوات الطرف الثالث استخدام اسم Open Presentation Format والمخططات والكتالوجات والحزم والأدوات المحلية للقراءة والكتابة والتحقق والعرض والتحويل ووصف الدعم دون اعتماد علامة تجارية خاصة بمنتج معين. ما تفعله حزمة JavaScript/TypeScript: تقوم بتصدير المخططات المعيارية وسجلات الكتالوج المجمعة من spec/، وبيان ملف مواصفات خام مكتوب بأنواع لمحتوى المواصفات القابل للعنونة عبر الحزمة، وأنواع TypeScript مُنشأة مع اعتبار Presentation كنوع المستوى الأعلى، وتحقق محلي لملفات OPF JSON وسجلات الكتالوج. يعيد التحقق نتيجة الصلاحية بالإضافة إلى تحذيرات استشارية، مثل معرفات الكتالوج غير المعروفة. تتوفر استيرادات مسارات فرعية مركزة للمخططات والكتالوجات وملفات المواصفات والمحقق والأنواع، ويمكن استيراد مخططات JSON الخام مباشرة بواسطة المحركات أو أدوات الحل (resolvers). توفر الحزمة أيضاً هندسة تكوين نقية بحيث تتشارك المكتبات اللاحقة في سلوك التخطيط. وهي صراحةً لا تقوم بعرض أو تحليل .pptx، أو إنشاء محتوى باستخدام الذكاء الاصطناعي، أو جلب كتالوجات عن بُعد، أو استدعاء واجهات برمجة تطبيقات مستضافة، أو تقديم خدمات مدارة. الأدوات المحلية: يمكن لواجهة سطر أوامر (CLI) قابلة للتثبيت ومرخصة بموجب MIT إنشاء ملفات OPF والتحقق منها وتحريرها وفحصها محلياً، على سبيل المثال إنشاء عرض تقديمي بعنوان، أو التحقق من ملف، أو تطبيق تصحيح (patch) في مكانه. يقوم أمر CLI 0.5.0 بتثبيت ست مهارات OPF في مشروع لوكلاء الذكاء الاصطناعي، باستخدام نسخ محلية، مع الحفاظ على التعليمات الموجودة ورفض الكتابة فوق المهارات المخصصة، مع أهداف موثقة واختبارات ما قبل الإصدار. تغطي الوثائق مهارات الوكلاء، والتأليف بواسطة LLM، والتكوين الديناميكي، والتحقق من النظام البيئي المحلي. أبرز معالم تخطيط المستودع: مخطط JSON Schema المعياري لمستندات Presentation ذات المستوى الأعلى؛ مقدمة مفاهيمية لنموذج المستند، وأشكال المحتوى، وحل الكتالوج وفلسفة التحقق؛ خوارزمية أسبقية التصميم (تصميم الشريحة، تصميم العرض التقديمي، السمة المحلولة، افتراضات المحرك)؛ مراجع موجهة للمؤلف للحقول ذات المستوى الأعلى، وتعريفات المخطط، ومخططات الكتالوج المرافقة، وحمولات محتوى الشرائح/المناطق بما في ذلك المخططات والجداول؛ أدلة للتجهيزات التقنية وأمثلة معرض موجهة نحو السيناريوهات؛ ملاحظات المحرر المباشر على لوحة رسم المتصفح، وتحميل الخطوط، وحدود الدقة الحالية؛ ودليل تشغيل الإصدارات للمسؤولين. يوجد عقد OpenAPI مرجعي اختياري للخدمات اللاحقة التي تختار عرض OPF عبر HTTP، ولكن OpenPresentation لا تستضيف تلك الواجهة. حدود النظام البيئي: تقع قدرات العرض والتحرير والتحويل في مستودعات شقيقة منفصلة مرخصة بموجب MIT — opf-render (من OPF إلى SVG/PNG/PDF)، و opf-editor (بدائيات محرر بدون واجهة بالإضافة إلى مكونات واجهة مستخدم اختيارية) و opf-pptx (استيراد/تصدير PPTX محلي نقي). توفر هذه الأدوات بدائيات مفتوحة المصدر فقط؛ وتتحمل التطبيقات اللاحقة مسؤولية الاستضافة، والمصادقة، والتخزين، والتعاون، والطوابير، والمعاينات، والتحليلات، والدعم، وتجربة مستخدم سير العمل. ومن المتوقع أن تتبع حزم Python و Go المستقبلية نفس الحدود المحلية أولاً، حيث توفر المخططات والنماذج والكتالوجات والتحقق والأصول القابلة للعنونة عبر الحزمة دون الحاجة إلى مكالمات شبكة أو تتبع خفي. يتم الإشارة إلى قوالب الكتالوج التي يمكن للبشر تصفحها، مثل التخطيطات والسمات ومخططات الألوان والخطوط وأنواع المخططات والسرديات والجمهور والأغراض والنغمات واللغات والمنصات الاجتماعية، من خلال pptx.gallery.