Lolly للبنائين

الوثائق التقنية — لكل من يؤلف الأدوات، أو يدمج Lolly في خط إنتاج آلي، أو يستضيفه ذاتيا، أو يوسع المنصة.

ما الذي ستجنيه أنت. ابن أداة مرة واحدة فيتوقف الطلب عن العودة إليك. عبارة «هلا صنعت لي...» المتكررة التي تلتهم فترات ما بعد الظهيرة لديك تصبح قالبا يملؤه الآخرون بأنفسهم — بشكل صحيح، ومن دونك في الحلقة. عملك HTML/CSS/JS عادي: مدار بالإصدارات، وقابل للمقارنة والمراجعة، ويعمل على محرك مفتوح بلا احتكار مورد، فيبقى ملكك. أتمت جولة الإنتاج فيذهب وقتك إلى المشكلة المثيرة، لا إلى التصدير رقم عشرة آلاف.

Lolly محرك محايد تجاه المنصات يشغل مسار التصيير نفسه عبر عدة أغلفة (ويب PWA، وTauri لسطح المكتب/الهاتف، وCLI، وTUI). والأدوات بيانات، لا كود مضمن — بيان تعريف مع قالب مع خطافات اختيارية — فتشحن الأدوات الجديدة من دون تحديث للتطبيق. ابدأ بـنظرة عامة للبنية، ثم اتبع المسار الذي يناسب ما تبنيه.

جديد على المنصة؟ البدء السريع يجهز علامة تجارية وأول تصيير لك قبل أن تتعمق.

افهم البنية

• نظرة عامة — لماذا وجد Lolly، وفصل المحرك/الأغلفة/الأدوات، وجسر القدرات، والالتزامات المعمارية المستقرة.
• رموز التصميم — نموذج رموز DTCG الذي تعبر به العلامات التجارية، وكيف تستهلكه الأدوات.

ألف الأدوات

كل عنصر تحكم أدناه أنشئ من مدخل معلن في tool.json. أنت تكتب سطر بيان التعريف، والمضيف يرسم عنصر الواجهة، والنموذج نفسه يقود CLI والرابط.

وهذا يتوسع إلى ما يتجاوز خمسة عناصر تحكم. أعط المدخل section فيطويه المضيف، وبذلك تبقى أداة بخمسين مدخلا مثل D3 Chart Studio تفتح كقائمة قصيرة، والبقية مرتبة خلف مجموعات مسماة.

• تأليف الأدوات — الدليل الكامل: بيان التعريف، والقالب، والأنماط، والخطافات، والتركيب، والنشر.
• تأليف الأصول — أصول الكتالوج، والمستويات، واللغات المحلية، ولوحات الألوان، والأيقونات المتوافقة مع السمات، والخطوط.
• واجهة المضيف — جسر القدرات HostV1 الذي تكتب كل أداة استنادا إليه (الواجهة الوحيدة التي تراها الأدوات).
• وضع URL — كل مدخل كمعامل URL؛ المعاملات المحجوزة، والترميز المضغوط، والروابط المحزومة.

شغل وكامل

• CLI — تصيير من دون واجهة؛ مسار التصيير نفسه كالواجهة الرسومية، تقوده معاملات --foo=bar في argv.
• TUI — غلاف الطرفية التفاعلي.
• خادم MCP — نقطة النهاية الأصلية التي تتيح لوكيل ذكاء اصطناعي اكتشاف الأدوات وتشغيلها.
• وكلاء الذكاء الاصطناعي — قيادة Lolly من نموذج: الرابط هو الواجهة البرمجية.
• امتداد Chrome — التقط عنوان URL حيا كأصل قابل لإعادة الاستخدام.

اشحنه وشغله

• دليل البناء — ابن كل الأهداف: CLI وTUI وسطح المكتب والهاتف.
• النشر — تطبيق الويب، والتطبيقات، وخدمات الواجهة الخلفية؛ وأين يعمل كل جزء.
• الإعداد — ملفات التعريف، وحزم العلامات التجارية، وبوابات القدرات، وأعلام الميزات، والتحقق من الكتالوج.

الثقة والبيانات

الحقوق ونسبة التأليف مدخلات كغيرها. تعلن Embed & Track Image حقول المنشئ وحقوق النشر والترخيص وجهة الاتصال، والتصدير يكتبها في البيانات الوصفية للملف نفسه وفي بيان C2PA الخاص به.

• هوية Content Credentials — توقيع صادر عن مرجع إصدار (CA) لاعتمادات C2PA على الجهاز؛ عقود المحرك ودليل التشغيل للمشغلين.
• نقل البيانات — حزمة lolly-backup: الغلاف، والسلامة، والضمانات عبر الأغلفة.
• حول المشروع — المشروع، وحدود ترخيصه، والمستودع.