نمای کلی

مدیران فضای کاری می‌توانند یک بازارچهٔ افزونه را از GitHub به فهرست فضای کاری خود وارد کنند. بازارچه یک فهرست با قالب JSON است که افزونه‌های قابل وارد کردن را مشخص می‌کند. پس از وارد کردن، همگام‌سازی روزانه افزونه‌ها را با تغییرات محل نگهداری به‌روز نگه می‌دارد.


همگام‌سازی بازارچه محتوای افزونه‌ها را وارد می‌کند؛ اما حساب‌های اعضای فضای کاری را متصل نمی‌کند و دسترسی به برنامه‌های موجود در افزونه را فراهم نمی‌سازد.


برای آشنایی با افزونه‌ها و برنامه‌های موجود در آن‌ها، ببینید: افزونه‌ها در ChatGPT و Codex.

پیش از شروع

• از حساب GitHub دارای دسترسی خواندن به محل نگهداری بازارچه و تمام محل‌های نگهداری مورد ارجاع آن استفاده کنید. محل‌های نگهداری عمومی و خصوصی در github.com پشتیبانی می‌شوند.

• هرگونه تأیید لازم از سازمان GitHub را برای دسترسی حساب واردکننده به آن محل‌های نگهداری دریافت کنید.

• محتوای محل نگهداری را بررسی کنید. فرایند وارد کردن، تمام افزونه‌های معتبر را بدون مرحلهٔ تأیید جداگانه برای هرکدام پردازش می‌کند و همگام‌سازی‌های آینده می‌توانند افزونه‌های جدیدی اضافه کنند.

افزونه‌های جدید در ابتدا با سیاست نصب در دسترس و احراز هویت هنگام نصب تنظیم می‌شوند. همگام‌سازی خودکار روزانه برای بازارچه‌های جدید فعال است. پس از وارد کردن، تنظیمات فضای کاری و برنامه‌های موردنیاز هر افزونه را بررسی کنید.

وارد کردن بازارچه

1. به کنسول مدیریت بروید، فضای کاری موردنظر را در ChatGPT انتخاب کنید و افزونه‌ها را باز کنید. سپس افزودن و بعد وارد کردن بازارچه را انتخاب کنید.

2. در منبع، نشانی اینترنتی محل نگهداری را وارد کنید؛ مثلاً https://github.com/example/team-plugins. فقط از نشانی اینترنتی محل نگهداری استفاده کنید، نه نشانی یک شاخه یا پوشه.

3. اگر بازارچه در یک زیرپوشه قرار دارد، آن پوشه را در مسیر وارد کنید. برای مثال، برای team-tools/.agents/plugins/marketplace.json مقدار team-tools را وارد کنید. برای استفاده از ریشهٔ محل نگهداری، مسیر را خالی بگذارید. نام فایل اساس نامه را وارد نکنید.

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/ آمده است کپی کنید.

3. آن شناسه را با کلید pluginId در کنار name و source به ورودی متناظر در آرایهٔ plugins بازارچه اضافه کنید. آن را به فایل plugin.json افزونه اضافه نکنید.

شناسه، تنظیمات اشتراک‌گذاری و سیاست‌های فضای کاری افزونه حفظ می‌شوند. GitHub منبع به‌روزرسانی‌های آینده می‌شود؛ بنابراین، بارگذاری فایل‌های آرشیو در آینده نمی‌تواند جایگزین آن شود.


برای مشاهدهٔ نمونه‌ای از انتقال و الزامات آن، ببینید: مدیریت افزونه‌ها.

ارجاع به یک برنامهٔ موجود

یک افزونه می‌تواند در فایل .app.json در ریشهٔ افزونه به یک برنامهٔ موجود ارجاع دهد. نقطهٔ ابتدای نام فایل را حفظ کنید و به‌جای شناسهٔ افزونه از شناسهٔ برنامه استفاده کنید. برای یک افزونهٔ بومی، مقدار فیلد apps در .codex-plugin/plugin.json را روی ./.app.json تنظیم کنید.


این ارجاع برنامه‌ای ایجاد نمی‌کند و مجوزهای بیشتری نمی‌دهد. تنظیمات فعلی برنامه برای دسترسی در فضای کاری، احراز هویت، کنترل اقدامات و مجوزهای سرویس متصل همچنان اعمال می‌شوند.


برای آشنایی با قالب JSON، ببینید: مدیریت افزونه‌ها.

آشنایی با برچسب «فقط دسکتاپ»

افزونه‌ای با برچسب فقط دسکتاپ نمی‌تواند در نسخهٔ وب ChatGPT اجرا شود. افزونه‌های واردشده ممکن است در صورت تعریف سرورهای MCP، مثلاً در mcp.json یا .mcp.json، این برچسب را دریافت کنند؛ حتی اگر سرور از یک نشانی HTTPS راه دور استفاده کند.


افزودن ارجاع در .app.json به‌تنهایی برچسب فقط دسکتاپ را حذف نمی‌کند. هر برنامهٔ مورد ارجاع همچنان باید برای نقش عضو در دسترس باشد و الزامات معمول دسترسی و احراز هویت آن اعمال می‌شوند.