نظرة عامة

يمكن لمسؤولي مساحة العمل المشتركة استيراد متجر للمكوّنات الإضافية من GitHub إلى دليل مساحة العمل المشتركة. المتجر هو كتالوج بصيغة JSON يسرد المكوّنات الإضافية المطلوب استيرادها. بعد الاستيراد، تُحدّث المزامنة اليومية المكوّنات الإضافية وفقًا للتغييرات في المستودع.


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


للتعرّف على المكوّنات الإضافية والتطبيقات المضمّنة فيها، راجع: المكوّنات الإضافية في ChatGPT وCodex.

قبل البدء

• استخدم حساب GitHub لديه صلاحية قراءة مستودع المتجر وجميع المستودعات الأخرى التي يشير إليها. المستودعات العامة والخاصة على github.com مدعومة.

• استكمل أي موافقات مطلوبة من المؤسسة على GitHub ليتمكن الحساب المُستخدَم للاستيراد من الوصول إلى تلك المستودعات.

• راجع محتوى المستودع. تعالج عملية الاستيراد جميع المكوّنات الإضافية الصالحة دون خطوة موافقة منفصلة لكل منها، ويمكن لعمليات المزامنة المستقبلية إضافة مكوّنات إضافية جديدة.

تبدأ المكوّنات الإضافية الجديدة بسياسة تثبيت متاح، مع اشتراط المصادقة عند التثبيت. تكون المزامنة اليومية التلقائية مفعّلة للمتاجر الجديدة. بعد الاستيراد، راجع إعدادات كل مكوّن إضافي في مساحة العمل المشتركة والتطبيقات التي يتطلبها.

استيراد متجر

1. انتقل إلى وحدة تحكم المسؤول، وحدّد مساحة العمل المشتركة المطلوبة في ChatGPT، ثم افتح المكوّنات الإضافية. ثم حدّد إضافة واختر استيراد متجر.

2. في المصدر، أدخل عنوان URL للمستودع، مثل https://github.com/example/team-plugins. استخدم عنوان URL للمستودع فقط، وليس عنوان فرع أو مجلد.

3. إذا كان المتجر في مجلد فرعي، فأدخل ذلك المجلد في المسار. على سبيل المثال، أدخل team-tools للمسار team-tools/.agents/plugins/marketplace.json. اترك المسار فارغًا لاستخدام المجلد الجذر للمستودع. لا تُدخل اسم ملف التعريف.

4. يمكنك اختياريًا إدخال فرع أو وسم أو تثبيت. اترك الحقل فارغًا لاستخدام الفرع الافتراضي للمستودع. استخدم فرعًا لتلقّي التثبيتات المستقبلية. عند تحديد تثبيت بعينه، تظل النسخة عند ذلك الإصدار.

5. حدّد استيراد متجر وامنح إذن الوصول إلى GitHub عند مطالبتك بذلك.

6. راجع نتائج الاستيراد، ثم افتح كل مكوّن إضافي مستورَد لضبط سياسة تثبيته وأي تطبيقات مطلوبة.

قد يستغرق الاستيراد الأولي ما يصل إلى ساعة واحدة للمتاجر الكبيرة جدًا. تستغرق عمليات المزامنة اليومية اللاحقة عادةً بضع دقائق.

إذا تعذّر استيراد مكوّن إضافي، يوضّح التقرير الخطأ. يظل من الممكن استيراد المكوّنات الإضافية الأخرى الصالحة.

التنسيقات المدعومة

يجب أن يحتوي المجلد المحدّد على ملف تعريف مدعوم:

• .agents/plugins/marketplace.json لمتجر Codex.

• .claude-plugin/marketplace.json لمتجر متوافق مع Claude.

• .claude-plugin/plugin.json لمكوّن Claude إضافي مستقل عند عدم وجود ملف تعريف للمتجر.

يمكن لعناصر المتجر الإشارة إلى مجلدات مكوّنات إضافية في المستودع نفسه أو إلى مصادر مستودعات GitHub المدعومة. لا يدعم الاستيراد إلى مساحة العمل المشتركة خدمات استضافة Git الأخرى أو المصادر من سجلات الحزم، مثل npm.

للاطّلاع على التنسيقات المدعومة وأمثلة JSON وحقول المصدر، راجع: إدارة المكوّنات الإضافية.

ضبط الوصول في مساحة العمل المشتركة

يوفّر GitHub محتوى المكوّن الإضافي، بينما تتحكم إعدادات مساحة العمل المشتركة في التثبيت والمصادقة. لا يطبّق الاستيراد والمزامنة قيم السياسات المحدّدة في المستودع، مثل AVAILABLE أو ON_USE. اضبط هذه الإعدادات لكل مكوّن إضافي في مساحة العمل المشتركة.


استخدم سياسة التثبيت لاختيار متاح أو مثبّت لكل دور مؤهل. يجب أيضًا تفعيل التطبيقات المطلوبة، ويجب أن يكون لدى الأعضاء حق الوصول إلى الخدمة المتصلة وأن يستكملوا أي مصادقة مطلوبة.


تُحفظ سياسات المكوّن الإضافي في مساحة العمل المشتركة عند مزامنة تحديث له أو نقل إدارة مكوّن إضافي موجود إلى GitHub. لا يمنح استيراد مكوّن إضافي حق الوصول إلى التطبيقات ولا يربط حسابات الأعضاء.


لمعرفة كيفية التنقّل في مساحة العمل المشتركة والوصول إلى التطبيقات واستخدام ضوابط مساحة العمل المشتركة، راجع: ضوابط المسؤول والأمان والامتثال للمكوّنات الإضافية والتطبيقات.

إبقاء المكوّنات الإضافية محدّثة

تتحقق المتاجر الجديدة من وجود تحديثات يوميًا. لطلب تحديث دون انتظار المزامنة التلقائية:

1. انتقل إلى وحدة تحكم المسؤول، وحدّد مساحة العمل المشتركة المطلوبة في ChatGPT، ثم افتح المكوّنات الإضافية.

2. افتح المتاجر وحدّد المتجر.

3. حدّد مزامنة الآن.

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

مراجعة نتائج المزامنة

بعد المزامنة، راجع حالتها والتقرير المحفوظ. تعني عبارة اكتملت — عدد الأخطاء: N أن المزامنة انتهت، لكن تعذّرت معالجة بعض المكوّنات الإضافية.


إذا كان تحديث مكوّن إضافي موجود غير صالح، يُحتفَظ بآخر إصدار يعمل منه. يظل من الممكن إكمال التحديثات الأخرى الصالحة. أصلح المشكلة الواردة في التقرير على GitHub، ثم حدّد مزامنة الآن لإعادة المحاولة.


إذا ظهر خيار تحديث في واجهة المسؤول لمكوّن إضافي مستورَد بشكل منفرد، فاستخدمه لتحديث ذلك المكوّن الإضافي. يُعيد خيار تحديث قائمة المكوّنات الإضافية تحميل القائمة المعروضة فقط، ولا يُجري مزامنة من GitHub.

فهم الإزالة والحذف

لا تؤدي إزالة عنصر من المستودع إلى حذف نسخته المستورَدة في مساحة العمل المشتركة. يُوسم المكوّن الإضافي بعبارة لم يعد موجودًا في المصدر.


يؤدي حذف المتجر في ChatGPT إلى حذف جميع المكوّنات الإضافية المستورَدة منه. لا تحذف متجرًا لإعادة الاتصال بـGitHub أو تغيير الملكية.

إعادة الاتصال بـGitHub أو تغيير صلاحيات الوصول

تستخدم مزامنة المتجر اتصال GitHub الخاص بالمسؤول الذي استورده. يحتاج ذلك الحساب إلى استمرار صلاحية الوصول إلى مستودع المتجر وأي مستودعات يشير إليها.

إعادة ربط الحساب الأصلي

1. تأكّد من أن حساب GitHub المُستخدَم للاستيراد لا يزال يملك صلاحية الوصول إلى جميع المستودعات المطلوبة.

2. اطلب من المسؤول الذي استورد المتجر في الأصل فتح المكوّن الإضافي GitHub في ChatGPT وإعادة ربط حسابه.

نقل الإدارة إلى مسؤول جديد

يمكن للمسؤول الجديد عن مساحة العمل المشتركة استيراد المتجر نفسه باستخدام اتصال GitHub الخاص به:

1. انتقل إلى وحدة تحكم المسؤول، وحدّد مساحة العمل المشتركة المطلوبة في ChatGPT، ثم افتح المكوّنات الإضافية. ثم حدّد إضافة > استيراد متجر.

2. أدخل القيم نفسها المُستخدَمة للمتجر الموجود في حقول المصدر والمسار وفرع أو وسم أو تثبيت.

3. حدّد استيراد متجر وامنح إذن الوصول إلى GitHub عند مطالبتك بذلك.

تستخدم عمليات المزامنة المستقبلية اتصال GitHub الخاص بالمسؤول الجديد. يجب أن يملك حساب المسؤول الجديد صلاحية قراءة مستودع المتجر وجميع المستودعات التي يشير إليها.

نقل إدارة مكوّن إضافي موجود إلى GitHub

يمكنك استخدام متجر لإدارة مكوّن إضافي موجود في مساحة العمل المشتركة، سبق رفعه كملف أرشيف أو لم يُربط بعد بمصدر على GitHub لإدارته. يجب أن يكون المكوّن الإضافي الموجود في مساحة العمل المشتركة نفسها وأن يحمل اسم المكوّن الإضافي نفسه. لا يمكن بهذه الطريقة نقل إدارة مكوّن إضافي يُدار من مصدر آخر على GitHub.


لتحديد المكوّن الإضافي الموجود في متجرك:

1. انتقل إلى وحدة تحكم المسؤول، وحدّد مساحة العمل المشتركة المطلوبة في ChatGPT، ثم افتح المكوّنات الإضافية. افتح المكوّن الإضافي.

2. انسخ معرّف المكوّن الإضافي الذي يأتي بعد /admin/plugins/ في عنوان URL الخاص به.

3. أضف هذا المعرّف في حقل pluginId بجانب name وsource في العنصر المطابق ضمن مصفوفة plugins الخاصة بالمتجر. لا تُضفه إلى ملف plugin.json الخاص بالمكوّن الإضافي.

يحتفظ المكوّن الإضافي بمعرّفه وإعدادات مشاركته وسياساته في مساحة العمل المشتركة. يصبح GitHub مصدر التحديثات المستقبلية، لذا لا يمكن استبدال المكوّن الإضافي برفع ملفات أرشيف لاحقًا.


للاطّلاع على مثال لنقل الإدارة ومتطلباته، راجع: إدارة المكوّنات الإضافية.

الإشارة إلى تطبيق موجود

يمكن للمكوّن الإضافي الإشارة إلى تطبيق موجود في ملف .app.json ضمن المجلد الجذر للمكوّن الإضافي. احرص على تضمين النقطة في بداية اسم الملف، واستخدم معرّف التطبيق بدلًا من معرّف المكوّن الإضافي. للمكوّن الإضافي الأصلي، اضبط حقل apps في .codex-plugin/plugin.json على ./.app.json.


لا تؤدي هذه الإشارة إلى إنشاء تطبيق أو منح أذونات إضافية. تظل إعدادات وصول التطبيق الحالية في مساحة العمل المشتركة، والمصادقة، وضوابط الإجراءات، وأذونات الخدمة المتصلة سارية.


للاطّلاع على تنسيق JSON، راجع: إدارة المكوّنات الإضافية.

فهم تصنيف «سطح المكتب فقط»

لا يمكن تشغيل مكوّن إضافي يحمل تصنيف سطح المكتب فقط في ChatGPT على الويب. قد تحصل المكوّنات الإضافية المستورَدة على هذا التصنيف عندما تعرّف خوادم MCP، مثلًا في mcp.json أو .mcp.json، حتى عندما يستخدم أحد الخوادم عنوان URL بعيدًا عبر HTTPS.


إضافة إشارة إلى تطبيق في .app.json لا تزيل بحد ذاتها تصنيف سطح المكتب فقط. يظل من الضروري أن يكون أي تطبيق مُشار إليه متاحًا للدور الذي يشغله العضو، وتظل متطلبات الوصول والمصادقة المعتادة الخاصة به سارية.