Skip to main content
متوفّرة الآن على Comfy Registry. ثبّت ComfyUI Agent Panel (comfyui-agent-panel) من ComfyUI-Manager، أو ثبّتها من git للحصول على أحدث نسخة (راجع الإعداد أدناه).
comfyui-mcp-panel يضع وكيلًا مستقلًا في الشريط الجانبي لـ ComfyUI. اطلب منه صورة أو سير عمل أو تعديلًا — فيعمل على ComfyUI لديك ويردّ عليك في المكان نفسه. اختر مزوّدًا — Claude أو ChatGPT أو Gemini أو Ollama (محلي) — فيعمل الوكيل المطابق له في الخلفية: الاشتراكات بلا مفتاح API، والنماذج المحلية بلا حساب أصلًا (كما تصل خلفية Ollama إلى أي نقطة وصول مستضافة متوافقة مع OpenAI أيضًا). راجع الخلفيات للاطّلاع على المصفوفة، وحلبة النماذج اللغوية لمعرفة الأداء الفعلي لكل فئة من النماذج.
بلا مفاتيح API وبلا فوترة على كل رمز لدى مزوّدي الاشتراكات — ومجانية تمامًا وتعمل دون اتصال على النماذج المحلية. يستوثق الوكيل ببيانات تسجيل دخولك المخزّنة على القرص (أو، في حالة Ollama، يتحدّث ببساطة إلى الخدمة المحلية). ومنسّق واحد على منفذ جسر استرجاع محلي واحد (ws://127.0.0.1:9180) يخدم كل المزوّدين؛ ويختار كل تبويب من تبويبات اللوحة مزوّده أثناء المصافحة. والجسر مقصور على الاسترجاع المحلي، واللوحة تنفّذ قائمة سماح ثابتة من أوامر المخطط (لا شيفرة JavaScript عشوائية).
جديد هنا؟ الخلفيات / المزوّدون يشرح أداة الاختيار، ومنفذ AgentBackend المحايد تجاه المزوّد، ومصفوفة القدرات (ما هو متطابق بين Claude وChatGPT، والفروق القليلة بينهما).

​
الإعداد

  1. ثبّت الحزمة — ابحث عن comfyui-agent-panel في ComfyUI-Manager، أو من git:
    اختر Latest لا Nightly من قائمة الإصدارات المنسدلة في Manager. رغم الاسم، فإن Nightly في Manager لا يُبنى ليليًا: فهو يستنسخ المستودع مرة واحدة وقت التثبيت ثم لا يتتبّع الفرع بعدها أبدًا. إنه يجمّدك عند أي إيداع صادف أن كان main في ذلك اليوم، بينما يواكب Latest كل إصدار — لذا فإن Nightly أقدم من Latest في المعتاد، ويزداد تخلّفه بصمت كلما طالت مدة تركه. وهو لا يبلّغ عن توفّر أي تحديث، لأنه من وجهة نظره لا يوجد تحديث.ولمعرفة موضعك الفعلي، قارن قيمة SHA تحت Node Pack Info → Version بـسجل إيداعات المستودع. وللخروج من ذلك، إما أن تختار Latest (x.y.z) من القائمة نفسها، أو — إن أردت البقاء على git — أن تنفّذ git pull في custom_nodes/comfyui-mcp-panel، فيتقدّم بسلاسة.
  2. سجّل الدخول إلى المزوّد الذي تريده مرة واحدة، حتى يستطيع الوكيل العامل في الخلفية استخدام اشتراكك:
  3. شغّل المنسّق على جهازك واتركه يعمل — راجع تشغيل منسّق اللوحة:
  4. أعد تشغيل ComfyUI، وافتح تبويب Agent، واختر مزوّدًا (شريحتا Claude / ChatGPT)، ثم انقر اتصال. ترتبط اللوحة بجسر الاسترجاع المحلي للمنسّق. اكتب طلبًا فيردّ الوكيل. وقطع الاتصال يفكّ الارتباط؛ ويظل المنسّق يعمل حتى توقفه.
لا حاجة إلى claude mcp add، ولا إلى مفتاح API. فاللوحة امتداد واجهة أمامية محض ولا تستطيع تشغيل المنسّق بنفسها، لذا فهو دائمًا عملية تبدؤها أنت — واللوحة تتصل تلقائيًا بجسر يعمل مسبقًا. والمتطلبات المسبقة هي وجود Node.js/npx في مسار PATH لديك، وتسجيل الدخول إلى المزوّد كما سبق. غيّر منفذ الجسر عبر COMFYUI_MCP_BRIDGE_PORT.
هل تقود ComfyUI بعيدًا (وحدة GPU سحابية، أو جهازًا آخر على شبكتك المحلية)؟ ما يزال الإعداد أعلاه ساريًا، لكن شغّل المنسّق على جهازك أنت، لا على الجهاز البعيد: فأمر npx -y comfyui-mcp@latest connect <remote-url> يتكفّل بالباقي، بما في ذلك نفق آمن يعود إلى صفحة HTTPS الخاصة بالـ Pod. ثم انقر «اتصال» في اللوحة. راجع النشر السحابي للشرح الكامل.
تهيئة المزوّد. عند الاتصال تتحقّق اللوحة من جاهزية كل مزوّد (وجود واجهة سطر الأوامر الخاصة به في PATH لديك + تسجيل دخول على القرص؛ وسلسلة مفاتيح macOS مُعالَجة). ولا تظهر بطاقة التهيئة إلا حين لا يكون أي من المزوّدَين مسجَّل الدخول. وإذا كان اختيارك المحفوظ غير صالح للاستخدام فإن اللوحة تنتقل تلقائيًا إلى مزوّد جاهز (مع الاحتفاظ بتفضيلك المحفوظ)، ويعرض صفّ المزوّد غير الجاهز إجراء «الإعداد» الذي يمهّد لخطوة claude / codex login التي تُنفَّذ مرة واحدة. راجع الخلفيات ← الجاهزية والتهيئة.

​
ما الذي يستطيع فعله

يحمّل الوكيل (Claude أو ChatGPT) مهارات النماذج الخاصة بـ comfyui-mcp (IDEOGRAM وWAN وLTX وQwen وغيرها)، فيعرف مسبقًا النماذج التي تشغّلها — يعرفها Claude أصليًا، ويعرفها ChatGPT عبر المعرفة نفسها معروضةً كأدوات MCP (تكافؤ المعرفة). ويستطيع توليد الصور والفيديو والصوت، وفحص ComfyUI لديك وإدارته، والاستدلال حول إعدادك — ثم الرد في محادثة اللوحة. كما يستطيع تحميل سير عمل كامل أو حزمة تثبيت دفعة واحدة (panel_load_workflow pack:<name>)، وهو واعٍ بالتكلفة: فالحزم المرفقة تعمل على GPU محلي ومجانًا، وفي حالة المخطط المرتجل يفحص الوكيل بيئة التشغيل (list_packs مع action:"check_runtime") ويسأل قبل إنفاق أرصدة API المدفوعة. راجع المهارات والحزم وتكلفة التشغيل.

​
قيادة المخطط الحيّ

يعمل الوكيل المستقل على ComfyUI الحيّ لديك عبر قائمة سماح ثابتة من أوامر panel_* — بلا شيفرة JavaScript عشوائية. وتمرّ كل تعديلات المخطط عبر تتبّع التغييرات في LiteGraph، فيمكن التراجع عن كل تعديل بـ Ctrl+Z. وسطح panel_* نفسه معروض بصورة متطابقة على الخلفيتين (داخل العملية نفسها لـ Claude، وعبر MCP على HTTP استرجاعي لـ ChatGPT/Codex)، فيكون التكافؤ تلقائيًا.

​
القراءة

​
تعديل المخطط (قابل للتراجع)

​
المخططات الفرعية

​
التخطيط المكاني

يستطيع الوكيل رؤية هندسة العقد — إذ تُرجع صفوف التفاصيل في panel_query_graph قيمتَي pos/size لكل عقدة، إضافةً إلى rails مداخل ومخارج المخططات الفرعية، وgroups، وcolor/collapsed لكل عقدة — ويرتّب لوحة الرسم بمجموعة مقابلة من عمليات الكتابة، ثم يلتقط صورة للشاشة ليحكم على تخطيطه بنفسه. وتربط مهارة workflow-layout هذه الأدوات في تخطيط تلقائي مُطبَّق على طبقات الاعتماديات وخالٍ من التداخل، قاعدته الأبرز أبقِ المداخل والمخارج مكشوفة دائمًا حتى تستطيع الانطلاق مباشرة.

​
تبويبات سير العمل

​
تحميل سير عمل دفعة واحدة

​
المعرفة والوعي بالتكلفة

يكتشف الوكيل الخبرة المرفقة ويفحص تكلفة التشغيل قبل إنفاق الأرصدة (الأدوات نفسها على الخلفيتين — راجع المهارات والحزم وتكلفة التشغيل):

​
التشغيل والعرض

​
العقد المخصّصة (ComfyUI Manager المدمج)

​
MCP والجلسة

​
التفاعل مع المستخدم

تقبل كل أداة مُعاملًا اختياريًا باسم tab_id — فلكل تبويب في المتصفح اتصاله الخاص، والتوجيه يؤول افتراضيًا إلى التبويب الوحيد، أو إلى التبويب الذي كتب فيه المستخدم آخر مرة.

​
الإرجاع والاسترجاع

الرسائل السابقة ليست مجمّدة. مرّر المؤشر فوق أي رسالة، فيفتح زر ✎ التحرير نافذة استرجاع: استرجع الشيفرة (أعد المخطط إلى لقطة ذلك الدور)، أو المحادثة (فرّع الجلسة رجوعًا إلى تلك النقطة)، أو كليهما، ثم أعد إرسال رسالة معدَّلة من هناك. وتعتمد استعادة المخطط على لقطات لكل دور، فالتراجع عن دور يعيد المخطط تمامًا إلى ما بدأ منه. اختصاران يغطّيان الحالتين الشائعتين:
  • /revert — تراجع عن تعديلات المخطط في الدور الأخير.
  • ضغط Esc مرتين — إرجاع سريع للدور الأخير: يستعيد المخطط ويعيد الرسالة إلى مربع الكتابة لتحريرها وإرسالها من جديد.
استرجاع الشيفرة (المخطط) يعمل على كلتا الخلفيتين — فهو موجود في المنسّق عبر لقطات لكل دور. أما استرجاع المحادثة (تفريع الدردشة رجوعًا إلى دور سابق) فمتاح لـ Claude فقط حاليًا؛ إذ لا تستأنف خلفية ChatGPT/Codex إلا خيوط المحادثة كاملة، فتحجب اللوحة ذلك النطاق عنها. راجع مصفوفة القدرات.

​
لوحة الرسائل المعلّقة

اكتب بينما الوكيل مشغول ولن تضيع رسالتك في المحادثة — بل تنتظر في لوحة المعلّقة الثابتة المرسّاة فوق لوحة التنزيلات، خارج تدفّق المحادثة. ولكل رسالة معلّقة أزرار تحرير وإرسال الآن وحذف، ومقبض سحب (≡، على اليسار) لـإعادة ترتيب الطريقة التي يصرّفها بها الوكيل. وإرسال الآن يقاطع الدور الحالي لتوجيهه فورًا. وحين تُسحب رسالة معلّقة من الطابور تظهر في أسفل المحادثة، فيُقرأ السجل بالترتيب الذي عالجها به الوكيل (Claude أو ChatGPT) تمامًا.

​
تأكيد العمليات المدمِّرة

الإجراءات التي لا رجعة فيها تسأل أولًا. فـpanel_clear (مسح كل العقد) وpanel_restart_comfyui يعرضان بطاقة نعم / لا ولا يتصرّفان إلا عند نعم — فلا يستطيع الوكيل أن ينسف مخططك أو يعيد تشغيل ComfyUI بصمت.

​
متانة إعادة الاتصال

لم يعد المنسّق المتعثّر يترك اللوحة عالقة. فإن كان منسّق سابق ما يزال محتجزًا لمنفذ الجسر، فإن نقر اتصال يستعيد تلك النسخة الشبح بدل أن يفشل — فتعيد اللوحة الاتصال بدل أن تتركك عالقًا.

​
مرفقات مربع الكتابة

أرفِق أو أفلِت أو الصق في مربع الكتابة. وإلى جانب الصور، صار مربع الكتابة يقبل ملفات الفيديو وسير العمل .json والنصوص، فيمكنك أن تسلّم الوكيل مقطعًا مرجعيًا، أو سير عمل ليكيّفه، أو ملف ملاحظات مباشرة.

​
الوسائط الغنية في ردود الوكيل

حين تُعاد وسائط عملية تشغيل إلى الوكيل، لا يكون الناتج مجرد كتلة صورة — بل يحمل بيانات وصفية يستطيع الوكيل الاستدلال بها: مسار كل مخرَج (نسبةً إلى المجلد الفرعي)، وحجم الملف، وأبعاده بالبكسل، وتجميع مجموعة الأصول («المخرَج K من N في هذا التشغيل» مع أسماء ملفاته الشقيقة، أو «مخرَج وحيد»)، إضافةً إلى مدة التوليد ووقت الانتهاء. وتضيف لوحات الفيديو القصصية الصيغة وعدد الإطارات الحقيقي ومعدّلها حين تحملها الحمولة. فيسمّي الوكيل النتيجة المحفوظة فعليًا تسميةً دقيقة، ويستطيع الحديث عن الحجم والأبعاد وعدد الملفات التي أنتجها التشغيل.

​
نسخ كتل الشيفرة ولفّ أسطرها

تحصل كتل الشيفرة المعروضة على زر نسخ يظهر عند تمرير المؤشر، وعلى مفتاح لفّ الأسطر عام ومحفوظ (معطّل افتراضيًا — تتمرّر الأسطر الطويلة أفقيًا حتى تفعّله). وللشيفرة السطرية زر نسخ خاص بها. وكلاهما مُنسَّق ليطابق اللوحة.

​
تحذير تعثّر التوليد

يشغّل المنسّق مراقبًا سلبيًا على قائمة انتظار ComfyUI لديك: فأي عملية توليد يتوقّف تقدّمها أو عقدتها عن التحرّك تُعلَّم بأنها متعثّرة ويُبلَّغ الوكيل بذلك (حتى يكفّ عن تكديس المهام عميانًا خلف مهمة متعثّرة). والعتبة هي إعداد تحذير تعثّر التوليد (بالثواني) ضمن الإعدادات → Comfy MCP Agent → عام (الافتراضي 180 ثانية، والمدى 15–3600). ويُرسَل عند الاتصال ويُدفَع حيًّا — فتغييره يُطبَّق دون إعادة اتصال. راجع الإعدادات ← COMFYUI_MCP_STALL_S.

​
الموثوقية في التبويبات الخلفية

صارت الردود المتدفّقة تُعرض حتى حين يكون تبويب ComfyUI في الخلفية. فقد كانت آلة كتابة الرد تعمل سابقًا على requestAnimationFrame، وهو ما يوقفه المتصفح في تبويب مخفي — فكان الانتقال إلى تبويب آخر أثناء تشغيل طويل متعدّد المراحل يترك الفقاعة فارغة مع مؤشّر تدفّق عالق، وكأن الوكيل «عالق في التفكير» رغم انتهاء الدور. أما الآن فيُنهى الرد تزامنيًا حين يُخفى التبويب، ويقوم معالج visibilitychange بتصريف أي رد معلّق عند الإخفاء واستئناف آلة الكتابة عند العودة. ولم يتغيّر التحريك في المقدّمة.

​
التحكم السحابي عبر RunPod

تعرض شريحة المضيف في شريط الأدوات 🟢 محلي · جهازك أو 🔵 RunPod · <pod> · GPU · /hr∗∗وتفتح∗∗لوحةتحكمRunPod∗∗:بطاقةحالةحيّة(GPU/VRAM/مدةالتشغيل//hr** وتفتح **لوحة تحكم RunPod**: بطاقة حالة حيّة (GPU / VRAM / مدة التشغيل / ·hr / رابط ComfyUI / العدّ التنازلي للإيقاف التلقائي عند الخمول)، وقائمة منسدلة تسرد الـ Pods لديك بالاسم، وأزرار اتصال / تشغيل / إيقاف / استخدام المحلي، ونشر** مسلّح بتأكيد. اضبط RUNPOD_API_KEY مرة واحدة في بطاقة مفاتيح API وستتمكّن من النشر والمراقبة والتبديل بين المحلي والـ Pod وإيقاف وحدة GPU سحابية دون لمس وحدة تحكم RunPod — وشريحة المضيف تخبرك دائمًا أين ستُنفَّذ عملية التوليد التالية. راجع النشر السحابي والمدوّنة شغّل ComfyUI على وحدة GPU سحابية مستأجرة.

​
متصفّح CivitAI

يفتح زر Civitai في شريط الأدوات متصفّح CivitAI كاملًا — صور وفيديوهات وملفات checkpoint وLoRA ومسارات سير عمل، مع بحث وعوامل تصفية وعارض ملء الشاشة. اختر نتيجة لـمشاركتها مع الوكيل، أو تنزيلها إلى جهازك، أو حفظ سير عمل مضمّن على لوحة الرسم. والقصة كاملة في CivitAI داخل ComfyUI.

​
اطّلع أيضًا