El registro de plugins

El registro de plugins es el catálogo compatible para plugins en sandbox. Cualquiera puede explorar plugins publicados en plugins.emdashcms.com. Los administradores pueden revisarlos e instalarlos desde la sección Registry del panel de administración de EmDash.

EmDash usa el registro alojado en https://registry.emdashcms.com por defecto cuando el sitio tiene un sandbox de plugins habilitado.

Nombres públicos de plugins

Cada plugin del registro tiene un nombre público formado por el handle actual de la cuenta Atmosphere de su editor y su slug de paquete. Por ejemplo, un paquete con el slug my-gallery publicado por example.com aparece como @example.com/my-gallery.

El nombre público aparece en los resultados del registro y bajo Plugins después de la instalación. Selecciónelo para abrir la página de detalles del plugin, o pegue el nombre completo en la búsqueda del registro para encontrar ese paquete exacto. EmDash resuelve el handle al identificador de cuenta estable del editor antes de cargar el paquete.

Si el handle deja de resolverse de manera concluyente al editor, EmDash muestra INVALID HANDLE y evita nuevas instalaciones desde la página de detalles del paquete. Las instalaciones existentes permanecen en su estado actual para que una búsqueda de identidad no pueda deshabilitar un sitio en ejecución. Revise el plugin instalado y contacte a su editor antes de actualizarlo. Un fallo temporal de búsqueda muestra el identificador de editor estable con Handle unavailable en lugar de reportar un handle inválido.

Habilitar instalaciones de registro

Para instalar plugins desde el registro, configure almacenamiento y un runner de sandbox disponible. Complete primero la configuración del sandbox de plugins específica de la plataforma.

Agregue el runner de sandbox de Cloudflare a la configuración emdash() en astro.config.mjs:

import { defineConfig } from "astro/config";
import { sandbox } from "@emdash-cms/cloudflare";
import emdash from "emdash/astro";

export default defineConfig({
	integrations: [
		emdash({
			sandboxRunner: sandbox(),
		}),
	],
});

EmDash muestra el catálogo Registry después de que se configura el runner de sandbox. Consulte la referencia de configuración de registry para seleccionar un agregador diferente, establecer política de registro o deshabilitar el descubrimiento.

Instalar un plugin del registro

Antes de mostrar el diálogo de consentimiento, EmDash verifica el checksum, nombre, versión y permisos del bundle descargado. Si el editor requiere provenance de compilación, EmDash verifica esa evidencia también. La instalación se detiene si falla una verificación. El diálogo de consentimiento muestra el estado de verificación y los permisos exactos antes de la instalación.

Las actualizaciones del registro repiten estas verificaciones. Una actualización espera confirmación cuando agrega permisos o herramientas MCP, o cambia una ruta de autenticada a pública. La desinstalación elimina el bundle y preserva los datos de almacenamiento del plugin a menos que seleccione Also delete plugin storage data. Consulte Instalar plugins para los pasos compartidos de actualización y desinstalación.

Páginas relacionadas

• Consultar el registro documenta el cliente experimental de descubrimiento de solo lectura.
• Empaquetado y publicación cubre la publicación de un plugin en sandbox.
• Capacidades y seguridad describe el modelo de permisos del sandbox.