Общ преглед

Администраторите на работното пространство могат да импортират каталог с плъгини от 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. Прегледайте Резултати от импортирането, след което отворете всеки импортиран плъгин, за да настроите правилата му за инсталиране и необходимите приложения.

Първоначалното импортиране може да отнеме до 1 час при много големи каталози. Следващите ежедневни синхронизации обикновено отнемат няколко минути.

Ако даден плъгин не може да бъде импортиран, отчетът обяснява грешката. Останалите валидни плъгини могат да бъдат импортирани въпреки това.

Поддържани формати

Избраната директория трябва да съдържа манифест в поддържан формат:

• .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 в основната си директория. Включете началната точка в името на файла и използвайте идентификатора на приложението, а не на плъгина. За плъгин в нативен формат задайте стойност ./.app.json на полето apps в .codex-plugin/plugin.json.


Препратката не създава приложение и не предоставя допълнителни разрешения. Съществуващите настройки на приложението за достъп в работното пространство, удостоверяване, контрол на действията и разрешения за свързаните услуги продължават да важат.


За JSON формата вижте: Управление на плъгини.

Какво означава етикетът „Само за настолното приложение“

Плъгин с етикет Само за настолното приложение не може да се изпълнява в уеб версията на ChatGPT. Импортираните плъгини могат да получат този етикет, когато декларират MCP сървъри, например в mcp.json или .mcp.json, дори ако сървърът използва отдалечен HTTPS URL адрес.


Добавянето на препратка в .app.json само по себе си не премахва етикета Само за настолното приложение. Всяко приложение, към което има препратка, трябва да е достъпно за ролята на съответния член, като обичайните изисквания за достъп и удостоверяване продължават да важат.