插件注册表是沙箱插件的受支持目录。任何人都可以在 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。有关共享的更新和卸载步骤，请参阅安装插件。