عن المشروع

ComfyUI_frontend هو التنفيذ الرسمي للواجهة الأمامية لـ ComfyUI، وهي واجهة الرسوم البيانية القائمة على العقد المستخدمة لبناء وتشغيل سير عمل توليد الصور بالذكاء الاصطناعي. إنها الطبقة الموجهة للمتصفح التي تعرض لوحة الرسم ومحرر العقد والواجهة المحيطة، وتُشحن كواجهة افتراضية لتثبيتات ComfyUI. القدرات الأساسية للواجهة: - لوحة رسم للرسوم البيانية مبنية على Litegraph، مع بحث عن العقد، ومطابقة تقريبية، ومعاينات للعقد. - علامة تبويب جانبية لمكتبة العقد تدعم السحب والإفلات والتصفية. - علامة تبويب جانبية لقائمة الانتظار والسجل لتتبع تنفيذ سير العمل. - محرر أقنعة للرسم والتحسين المباشر للأقنعة في الواجهة. - طرفية خادم مدمجة تُبدَّل باستخدام Ctrl + `. - وضع تحريك اللوحة، تحديد المجموعات، مجموعات متداخلة، تحرير عناوين المجموعات، وتجميع العقد المحددة باستخدام Ctrl+G. - توصيل تلقائي للروابط بالمكان الصحيح، إنشاء روابط بالسحب مع Shift، سحب روابط متعددة، وتحويل تلقائي لعنصر واجهة إلى مدخل عند إفلات رابط متوافق عليه. - فتحات إدخال اختيارية تُعرض كحلقات، ومعالجة تجاوز النص في قيم عناصر الواجهة. التوطين والتخصيص: - دعم أصلي للتدويل (i18n) يغطي 14 لغة، قابل للتحديد من Comfy > Locale > Language، ليحل محل إضافات الترجمة الخارجية. - واجهة تخصيص اختصارات لوحة المفاتيح مع حوارات إعادة التعيين والتحرير. واجهات برمجة التطبيقات للتوسعات والمطورين: - تسجيل التوسعات عبر app.registerExtension للإعدادات، الأوامر، اختصارات لوحة المفاتيح، عناصر القائمة العلوية، علامات التبويب الجانبية، علامات التبويب السفلية، شارات صفحة "حول"، ورسائل الإشعارات. - واجهة برمجة تطبيقات جديدة للإعدادات عبر app.extensionManager.setting، إلى جانب واجهة app.ui.settings القديمة. - بدائل لحوارات window.prompt و window.confirm و window.alert، مخصصة لبيئة سطح المكتب ComfyUI المبنية على Electron. - واجهة برمجة تطبيقات لصندوق الأدوات عند التحديد تتيح للتوسعات إضافة أوامر تظهر عند تحديد عناصر على اللوحة. عملية الإصدار: - كل إصدار ثانوي يتبع مرحلة تطوير لمدة أسبوعين، ثم مرحلة تجميد ميزات لمدة أسبوعين مع اختيار إصلاحات الأخطاء، ثم النشر. - تُنشر إصدارات ليلية يوميًا؛ يمكن للمستخدمين الاشتراك باستخدام --front-end-version Comfy-Org/ComfyUI_frontend@latest. - تتداخل الإصدارات الثانوية المتتالية، لذا تستغرق الميزة عادة حوالي أربعة أسابيع من الدمج إلى الإصدار المستقر. موارد التطوير: - يغطي CONTRIBUTING.md مسارات المساهمة، إعداد بيئة التطوير، أسلوب الكود، الاختبارات، وطلبات السحب. - ملفات README منفصلة توثق الإعدادات المحلية (i18n) وتطوير مكونات Storybook والاختبار البصري. - توثيق استكشاف الأخطاء وإصلاحها يغطي المشكلات العامة، مشكلات العقد المخصصة، وتثبيت سطح المكتب.