Gambaran keseluruhan

Pentadbir ruang kerja boleh mengimport pasaran pemalam daripada GitHub ke dalam direktori ruang kerja mereka. Pasaran ialah katalog JSON yang menyenaraikan pemalam untuk diimport. Selepas import, penyegerakan harian memastikan pemalam sentiasa dikemas kini mengikut perubahan dalam repositori.


Penyegerakan pasaran mengimport kandungan pemalam — proses ini tidak menyambungkan akaun ahli ruang kerja atau memberikan akses kepada aplikasi yang disertakan dalam pemalam.


Untuk pengenalan kepada pemalam dan aplikasi yang disertakan, lihat: Pemalam dalam ChatGPT dan Codex.

Sebelum anda bermula

• Gunakan akaun GitHub yang boleh membaca repositori pasaran dan setiap repositori lain yang dirujuknya. Repositori awam dan peribadi di github.com disokong.

• Dapatkan sebarang kelulusan organisasi GitHub yang diperlukan supaya akaun yang digunakan untuk mengimport boleh mengakses repositori tersebut.

• Semak kandungan repositori. Import memproses semua pemalam yang sah tanpa langkah kelulusan berasingan bagi setiap pemalam, dan penyegerakan akan datang boleh menambah pemalam baharu.

Pemalam baharu bermula dengan dasar pemasangan Tersedia dan pengesahan semasa pemasangan. Penyegerakan harian automatik didayakan untuk pasaran baharu. Selepas import, semak tetapan ruang kerja dan aplikasi yang diperlukan bagi setiap pemalam.

Import pasaran

1. Pergi ke Konsol Pentadbir, pilih ruang kerja ChatGPT yang dikehendaki, dan buka Pemalam. Kemudian pilih Tambah dan pilih Import pasaran.

2. Dalam Sumber, masukkan URL repositori, seperti https://github.com/example/team-plugins. Gunakan URL repositori sahaja, tanpa URL cabang atau folder.

3. Jika pasaran berada dalam subdirektori, masukkan direktori itu dalam Laluan. Contohnya, masukkan team-tools untuk team-tools/.agents/plugins/marketplace.json. Biarkan Laluan kosong untuk menggunakan direktori akar repositori. Jangan masukkan nama fail manifes.

4. Jika perlu, masukkan Cabang, tag atau komit. Biarkannya kosong untuk menggunakan cabang lalai repositori. Gunakan cabang untuk menerima komit akan datang. Komit yang ditetapkan kekal pada semakan tersebut.

5. Pilih Import pasaran dan benarkan akses GitHub apabila diminta.

6. Semak Hasil import, kemudian buka setiap pemalam yang diimport untuk mengkonfigurasi dasar pemasangannya dan mana-mana aplikasi yang diperlukan.

Import awal boleh mengambil masa sehingga 1 jam untuk pasaran yang sangat besar. Penyegerakan harian seterusnya biasanya mengambil masa beberapa minit.

Jika pemalam tidak dapat diimport, laporan akan menerangkan ralat tersebut. Pemalam sah yang lain masih boleh diimport.

Format yang disokong

Direktori yang dipilih mesti mengandungi manifes yang disokong:

• .agents/plugins/marketplace.json untuk pasaran Codex.

• .claude-plugin/marketplace.json untuk pasaran yang serasi dengan Claude.

• .claude-plugin/plugin.json untuk pemalam Claude kendiri apabila tiada manifes pasaran.

Entri pasaran boleh merujuk folder pemalam dalam repositori yang sama atau sumber repositori GitHub yang disokong. Hos Git lain dan sumber daftar pakej, seperti npm, tidak disokong oleh fungsi import ruang kerja.

Untuk format yang disokong, contoh JSON dan medan sumber, lihat: Pengurusan Pemalam.

Konfigurasikan akses ruang kerja

GitHub membekalkan kandungan pemalam, manakala tetapan ruang kerja mengawal pemasangan dan pengesahan. Import dan penyegerakan tidak menerapkan nilai dasar repositori, seperti AVAILABLE atau ON_USE. Konfigurasikan tetapan ini untuk setiap pemalam dalam ruang kerja anda.


Gunakan Dasar pemasangan untuk memilih Tersedia atau Dipasang bagi setiap peranan yang layak. Aplikasi yang diperlukan juga mesti didayakan, dan ahli mesti mempunyai akses kepada perkhidmatan tersambung serta melengkapkan sebarang pengesahan yang diperlukan.


Menyegerakkan kemas kini pemalam atau memindahkan pemalam sedia ada ke pengurusan GitHub akan mengekalkan dasar ruang kerjanya. Mengimport pemalam tidak memberikan akses aplikasi atau menyambungkan akaun ahli.


Untuk navigasi ruang kerja, akses aplikasi dan kawalan ruang kerja, lihat: Kawalan pentadbir, keselamatan dan pematuhan untuk pemalam dan aplikasi.

Pastikan pemalam sentiasa dikemas kini

Pasaran baharu menyemak kemas kini setiap hari. Untuk meminta kemas kini tanpa menunggu penyegerakan automatik:

1. Pergi ke Konsol Pentadbir, pilih ruang kerja ChatGPT yang dikehendaki, dan buka Pemalam.

2. Buka Pasaran dan pilih pasaran yang dikehendaki.

3. Pilih Segerakkan sekarang.

Penyegerakan boleh menambah entri pasaran baharu dan mengemas kini pemalam sedia ada. Semak perubahan repositori sebelum menggabungkannya, kerana penyegerakan automatik boleh mengimport pemalam baharu tanpa langkah import tambahan.

Semak hasil penyegerakan

Selepas penyegerakan, semak statusnya dan laporan yang disimpan. Selesai — N ralat bermakna penyegerakan telah selesai, tetapi sesetengah pemalam tidak dapat diproses.


Jika kemas kini bagi pemalam sedia ada tidak sah, versi terakhirnya yang berfungsi akan dikekalkan. Kemas kini sah yang lain masih boleh diselesaikan. Betulkan masalah yang dilaporkan dalam GitHub, kemudian pilih Segerakkan sekarang untuk mencuba semula.


Jika paparan pentadbir anda menunjukkan Muat semula untuk pemalam yang diimport secara individu, gunakannya untuk memuat semula pemalam itu. Muat semula senarai pemalam hanya memuat semula senarai yang dipaparkan; tindakan ini tidak menyegerakkan kandungan daripada GitHub.

Fahami penyingkiran dan pemadaman

Menyingkirkan entri daripada repositori tidak memadamkan salinannya yang telah diimport ke ruang kerja. Pemalam ditandakan sebagai Tiada lagi dalam sumber.


Memadamkan pasaran dalam ChatGPT akan memadamkan semua pemalam yang diimport daripadanya. Jangan padamkan pasaran untuk menyambungkan semula GitHub atau menukar pemilikan.

Sambungkan semula atau ubah akses GitHub

Penyegerakan pasaran menggunakan sambungan GitHub pentadbir yang mengimportnya. Akaun itu memerlukan akses berterusan kepada repositori pasaran dan mana-mana repositori yang dirujuk.

Sambungkan semula akaun asal

1. Pastikan akaun GitHub yang digunakan untuk import masih mempunyai akses kepada semua repositori yang diperlukan.

2. Minta pentadbir yang mula-mula mengimport pasaran itu membuka pemalam GitHub dalam ChatGPT dan menyambungkan semula akaun mereka.

Pindahkan kepada pentadbir baharu

Pentadbir ruang kerja baharu boleh mengimport pasaran yang sama menggunakan sambungan GitHub mereka sendiri:

1. Pergi ke Konsol Pentadbir, pilih ruang kerja ChatGPT yang dikehendaki, dan buka Pemalam. Kemudian pilih Tambah > Import pasaran.

2. Masukkan nilai Sumber, Laluan dan Cabang, tag atau komit yang sama seperti yang digunakan untuk pasaran sedia ada.

3. Pilih Import pasaran dan benarkan akses GitHub apabila diminta.

Penyegerakan akan datang menggunakan sambungan GitHub pentadbir baharu. Akaun pentadbir baharu mesti boleh membaca repositori pasaran dan setiap repositori yang dirujuknya.

Pindahkan pemalam sedia ada ke pengurusan GitHub

Anda boleh menggunakan pasaran untuk mengurus pemalam ruang kerja sedia ada yang dimuat naik sebagai arkib atau belum diurus melalui sumber GitHub. Pemalam sedia ada mestilah berada dalam ruang kerja yang sama dan mempunyai nama pemalam yang sama. Pemalam yang diurus melalui sumber GitHub lain tidak boleh diambil alih dengan cara ini.


Untuk mengenal pasti pemalam sedia ada dalam pasaran anda:

1. Pergi ke Konsol Pentadbir, pilih ruang kerja ChatGPT yang dikehendaki, dan buka Pemalam. Buka pemalam tersebut.

2. Salin ID pemalam selepas /admin/plugins/ dalam URLnya.

3. Tambahkan ID itu sebagai pluginId di sebelah name dan source dalam entri yang sepadan dalam tatasusunan plugins pasaran. Jangan tambahkannya ke dalam fail plugin.json pemalam.

Pemalam mengekalkan ID, perkongsian dan dasar ruang kerjanya. GitHub menjadi sumber untuk kemas kini akan datang, jadi muat naik arkib selepas itu tidak boleh menggantikan pemalam tersebut.


Untuk contoh migrasi dan keperluannya, lihat: Pengurusan Pemalam.

Rujuk aplikasi sedia ada

Pemalam boleh merujuk aplikasi sedia ada dalam .app.json di direktori akar pemalam. Sertakan titik di awal nama fail, dan gunakan ID aplikasi, bukannya ID pemalam. Untuk pemalam natif, tetapkan medan apps dalam .codex-plugin/plugin.json kepada ./.app.json.


Rujukan ini tidak mencipta aplikasi atau memberikan kebenaran tambahan. Akses ruang kerja, pengesahan, kawalan tindakan dan kebenaran perkhidmatan tersambung yang sedia ada untuk aplikasi tersebut masih terpakai.


Untuk format JSON, lihat: Pengurusan Pemalam.

Fahami label Desktop sahaja

Pemalam yang ditandakan sebagai Desktop sahaja tidak boleh dijalankan dalam ChatGPT di web. Pemalam yang diimport boleh menerima label ini apabila pemalam tersebut mengisytiharkan pelayan MCP, contohnya dalam mcp.json atau .mcp.json, walaupun pelayan menggunakan URL HTTPS jauh.


Menambahkan rujukan .app.json sahaja tidak mengalih keluar label Desktop sahaja. Mana-mana aplikasi yang dirujuk masih perlu tersedia untuk peranan ahli, dan keperluan akses serta pengesahan biasanya tetap terpakai.