外掛註冊表是沙盒外掛的受支援目錄。任何人都可以在 plugins.emdashcms.com 瀏覽已發布的外掛。管理員可以從 EmDash 管理面板的 Registry 部分審查和安裝它們。
當網站啟用了外掛沙盒時，EmDash 預設使用託管在 https://registry.emdashcms.com 的註冊表。
外掛公開名稱
每個註冊表外掛都有一個由其發布者目前 Atmosphere 帳戶控制碼和套件 slug 組成的公開名稱。例如，由 example.com 發布的帶有 slug my-gallery 的套件顯示為 @example.com/my-gallery。
公開名稱出現在註冊表結果中和安裝後的 Plugins 下。選擇它以開啟外掛詳情頁面，或將完整名稱貼上到註冊表搜尋中以尋找該確切套件。EmDash 在載入套件之前將控制碼解析為發布者的穩定帳戶識別碼。
如果控制碼最終無法解析回發布者，EmDash 會顯示 INVALID HANDLE 並阻止從套件詳情頁面進行新安裝。現有安裝保持其目前狀態，因此身分查詢無法停用正在執行的網站。在更新之前審查已安裝的外掛並聯絡其發布者。臨時查詢失敗顯示帶有 Handle unavailable 的穩定發布者識別碼，而不是報告無效控制碼。
啟用註冊表安裝
要從註冊表安裝外掛，請設定儲存和可用的沙盒執行器。首先完成特定平台的外掛沙盒設定。
將 Cloudflare 沙盒執行器新增到 astro.config.mjs 中的 emdash() 設定：
import { defineConfig } from "astro/config";
import { sandbox } from "@emdash-cms/cloudflare";
import emdash from "emdash/astro";
export default defineConfig({
integrations: [
emdash({
sandboxRunner: sandbox(),
}),
],
});設定沙盒執行器後，EmDash 顯示 Registry 目錄。請參閱 registry 設定參考以選擇不同的聚合器、設定註冊表策略或停用探索。
安裝註冊表外掛
- 在管理面板中開啟 Registry。
- 按標題、描述或完整公開名稱（如
@example.com/my-gallery）搜尋，然後開啟外掛的詳情頁面。 - 選擇一個發布版本並審查其發布者、中繼資料、請求的權限和驗證狀態。
- 選擇 Install。
- 在同意對話方塊中審查驗證狀態和權限，然後確認。
在顯示同意對話方塊之前，EmDash 檢查下載的套件的校驗和、名稱、版本和權限。如果發布者需要建置來源，EmDash 也會驗證該證據。如果檢查失敗，安裝將停止。同意對話方塊在安裝前顯示驗證狀態和確切權限。
註冊表更新重複這些檢查。當更新新增權限或 MCP 工具，或將路由從已驗證變更為公開時，更新等待確認。解除安裝會刪除套件並保留外掛儲存資料，除非您選擇 Also delete plugin storage data。有關共享的更新和解除安裝步驟，請參閱安裝外掛。