概覽
工作區管理員可以從 GitHub 將外掛程式市集匯入工作區目錄。市集是一份 JSON 目錄，列出要匯入的外掛程式。匯入後，系統會每日同步程式碼庫的變更，讓外掛程式保持最新狀態。
市集同步會匯入外掛程式內容，但不會連接工作區成員的帳戶，也不會授予外掛程式所含應用程式的存取權。
如需了解外掛程式及其包含的應用程式，請參閱：ChatGPT 和 Codex 中的外掛程式。
開始前的準備
請使用可讀取市集程式碼庫及其引用的所有其他程式碼庫的 GitHub 帳戶。支援 github.com 上的公開及私人程式碼庫。
請完成所有必要的 GitHub 組織審批，讓執行匯入的帳戶能夠存取這些程式碼庫。
審查程式碼庫的內容。匯入時會處理所有有效的外掛程式，無須逐一審批，而日後同步時也可能新增外掛程式。
新外掛程式的初始安裝政策為可用，並設為安裝時進行驗證。新市集已啟用每日自動同步。匯入後，請檢查每個外掛程式的工作區設定及所需的應用程式。
匯入市集
前往管理員控制台，選擇目標 ChatGPT 工作區，然後開啟外掛程式。接著選擇新增，再選擇匯入市集。
在來源中輸入程式碼庫網址，例如
https://github.com/example/team-plugins。僅使用程式碼庫網址，不要使用分支或資料夾的網址。如果市集位於子目錄，請在路徑中輸入該目錄。例如，若檔案位於
team-tools/.agents/plugins/marketplace.json，請輸入team-tools。如果位於程式碼庫根目錄，請將路徑留空。請勿輸入資訊清單的檔案名稱。你也可以選擇輸入分支、標籤或提交。留空即可使用程式碼庫的預設分支。使用分支即可接收日後的提交。指定固定提交則會維持在該版本。
選擇匯入市集，並在出現提示時授予 GitHub 存取權。
檢查匯入結果，然後逐一開啟已匯入的外掛程式，設定其安裝政策及所需的應用程式。
對於規模非常大的市集，首次匯入最多可能需要 1 小時。之後的每日同步通常只需幾分鐘。
如果某個外掛程式無法匯入，報告會說明錯誤原因。其他有效的外掛程式仍可匯入。
支援的格式
所選目錄必須包含受支援的資訊清單：
Codex 市集使用
.agents/plugins/marketplace.json。與 Claude 相容的市集使用
.claude-plugin/marketplace.json。沒有市集資訊清單時，獨立的 Claude 外掛程式使用
.claude-plugin/plugin.json。
市集項目可以引用同一程式碼庫中的外掛程式資料夾，或受支援的 GitHub 程式碼庫來源。工作區匯入不支援其他 Git 託管平台及套件註冊庫來源，例如 npm。
如需了解支援的格式、JSON 範例及來源欄位，請參閱：外掛程式管理。
設定工作區存取權
GitHub 提供外掛程式內容，而工作區設定則控制安裝和驗證。匯入和同步不會套用程式碼庫中的政策值，例如 AVAILABLE 或 ON_USE。請在工作區中為每個外掛程式配置這些設定。
使用安裝政策，為每個符合資格的角色選擇可用或已安裝。所需的應用程式也必須啟用，而成員必須具有已連接服務的存取權，並完成所需的驗證。
同步外掛程式更新或將現有外掛程式改由 GitHub 管理時，其工作區政策會保留不變。匯入外掛程式不會授予應用程式存取權，也不會連接成員的帳戶。
如需了解工作區導覽、應用程式存取權及工作區控制項，請參閱：外掛程式和應用程式的管理員控制、安全性與合規性。
讓外掛程式保持最新狀態
新市集會每日檢查更新。如要立即要求更新，而不等待自動同步：
前往管理員控制台，選擇目標 ChatGPT 工作區，然後開啟外掛程式。
開啟市集，並選擇所需市集。
選擇立即同步。
同步可以新增市集項目，並更新現有外掛程式。合併程式碼庫的變更前，請先審查變更內容，因為自動同步可以直接匯入新的外掛程式，無須再次執行匯入步驟。
檢查同步結果
同步後，請檢查同步狀態及已儲存的報告。已完成 — N 個錯誤表示同步已結束，但部分外掛程式無法處理。
如果現有外掛程式的更新無效，系統會保留其上一個可正常運作的版本。其他有效的更新仍可完成。在 GitHub 中修正報告所指出的問題，然後選擇立即同步以重試。
如果管理員介面為個別匯入的外掛程式顯示重新整理選項，請使用該選項重新整理該外掛程式。重新整理外掛程式清單只會重新載入畫面上的清單，不會從 GitHub 同步。
了解移除與刪除
從程式碼庫移除項目，不會刪除已匯入工作區的副本。該外掛程式會標示為來源中已不存在。
在 ChatGPT 中刪除市集，會刪除從該市集匯入的所有外掛程式。請勿為了重新連接 GitHub 或變更擁有者而刪除市集。
重新連接或變更 GitHub 存取權
市集同步會使用匯入該市集的管理員的 GitHub 連線。該帳戶必須持續擁有市集程式碼庫及其引用的所有程式碼庫的存取權。
重新連接原有帳戶
確認用於匯入的 GitHub 帳戶仍擁有所有必要程式碼庫的存取權。
請最初匯入市集的管理員在 ChatGPT 中開啟 GitHub 外掛程式，並重新連接其帳戶。
轉交新的管理員
新的工作區管理員可以使用自己的 GitHub 連線匯入同一市集：
前往管理員控制台，選擇目標 ChatGPT 工作區，然後開啟外掛程式。接著選擇新增 > 匯入市集。
輸入與現有市集相同的來源、路徑及分支、標籤或提交值。
選擇匯入市集，並在出現提示時授予 GitHub 存取權。
日後的同步會使用新管理員的 GitHub 連線。新管理員的帳戶必須能夠讀取市集程式碼庫及其引用的每個程式碼庫。
將現有外掛程式改由 GitHub 管理
如果現有的工作區外掛程式是以封存檔上載，或尚未由 GitHub 來源管理，你可以透過市集管理該外掛程式。現有外掛程式必須位於同一工作區，且外掛程式名稱必須相同。已由另一個 GitHub 來源管理的外掛程式，無法透過此方式接管。
如要在市集中指定現有外掛程式：
前往管理員控制台，選擇目標 ChatGPT 工作區，然後開啟外掛程式。開啟該外掛程式。
複製其網址中
/admin/plugins/後面的外掛程式 ID。在市集的
plugins陣列中，找到對應項目，並在name和source旁新增pluginId，以該 ID 作為值。請勿將其加入外掛程式的plugin.json檔案。
外掛程式會保留其 ID、分享設定和工作區政策。GitHub 將成為日後更新的來源，因此之後上載的封存檔將無法取代該外掛程式。
如需遷移範例和相關要求，請參閱：外掛程式管理。
引用現有應用程式
外掛程式可以在其根目錄的 .app.json 中引用現有應用程式。檔案名稱必須包含開頭的句點，並使用應用程式 ID，而非外掛程式 ID。原生外掛程式則須將 .codex-plugin/plugin.json 中的 apps 欄位設為 ./.app.json。
引用不會建立應用程式或授予額外權限。應用程式現有的工作區存取權、驗證要求、操作控制和已連接服務的權限仍然適用。
如需了解 JSON 格式，請參閱：外掛程式管理。
了解「僅限桌面版」標籤
標示為僅限桌面版的外掛程式無法在 ChatGPT 網頁版中執行。如果已匯入的外掛程式宣告了 MCP 伺服器，例如在 mcp.json 或 .mcp.json 中宣告，即使伺服器使用遠端 HTTPS 網址，也可能被加上此標籤。
僅新增 .app.json 引用，並不會移除僅限桌面版標籤。任何被引用的應用程式仍須開放予該成員所屬角色使用，且一般的存取與驗證要求仍然適用。