概覽
工作區管理員可以將 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 參照，並不會移除僅限桌面版標籤。所有參照的應用程式仍須對該成員的角色開放使用，且原有的存取與驗證要求仍然適用。