Plugins

Un plugin es una extensión que añade una función nueva a Zettly. Los plugins pueden añadir una herramienta pequeña (un temporizador de enfoque), un explorador de archivos, un conector a un servicio externo o modelos de IA en el dispositivo. Los plugins son cómo Zettly crece sin hacer crecer la app principal.

El sistema de plugins está diseñado alrededor de tres ideas: fácil de instalar, fácil de controlar, fácil de confiar. Instala desde un marketplace con un clic. Configura cada plugin independientemente. Verifica la integridad de cada plugin antes de que se ejecute.

Esta página cubre qué son los plugins, cómo instalarlos y configurarlos, plugins destacados del marketplace y el modelo de seguridad.

Qué es un plugin

Un plugin es una extensión empaquetada que vive junto a la app principal. Puede:

• Añadir una herramienta o superficie nueva. Un widget de temporizador. Una vista nueva en un tablero. Un atajo de teclado para una acción específica.
• Conectar con un servicio externo. Un puente de búsqueda web. Un proveedor de calendario. Un rastreador de proyectos.
• Añadir IA en el dispositivo. Chat, embeddings e imágenes locales con el plugin Local AI Models. Consulta Memoria y RAG.
• Añadir un panel de UI. Una pestaña nueva del sidebar. Una tarjeta del panel. Un widget de barra de estado.

Lo que un plugin no hace:

• Los plugins no pueden modificar la app principal. Los plugins corren en un entorno aislado con una API clara. No pueden alcanzar los internals de la app ni reemplazar comportamiento central.
• Los plugins no pueden leer notas sin permiso. La primera vez que un plugin quiere leer tu vault, pregunta. Puedes conceder o denegar el permiso.
• Los plugins no pueden hacer solicitudes de red sin declaración. Cualquier servicio externo con el que hable un plugin está declarado en su manifiesto y se te muestra al instalar.

El modelo es “preguntar primero, actuar después”. Un plugin que quiere hacer algo nuevo tiene que declararlo, y tú tienes que aprobarlo.

No todo es un plugin. Sugerir mejoras de notas (sugerencias de etiquetas, enlaces y resúmenes con IA) y otra automatización en segundo plano están integrados en la app principal como Flows. Actívalos en el rail Flows — consulta Memoria y RAG.

El marketplace

Los plugins se distribuyen a través de una tienda oficial externa en store.zettly.studio. Los paquetes de plugins se descargan al instalar y no vienen incluidos con la app principal.

Algunas cosas sobre el marketplace:

• Verificados antes de activar. Cada release oficial de plugin incluye una suma de comprobación SHA-256. La app verifica el hash antes de ejecutar código del plugin.
• Instalación con un clic. Haz clic en instalar en Ajustes → Plugins → Marketplace. La app descarga desde la tienda, verifica y activa.
• Releases versionados. Cada plugin tiene releases semver en el CDN de la tienda.
• Fácil de eliminar. Desinstalar elimina el código del plugin de tu vault y revoca permisos.

La tienda lleva tres plugins oficiales de Zettly hoy.

Explora la galería pública: zettly.studio/plugins (sitio de marketing).

Plugins destacados del marketplace

Tres plugins son buenos puntos de partida — instálalos desde el marketplace como cualquier otra extensión.

Temporizador Pomodoro

Un temporizador de enfoque con intervalos de trabajo y descanso configurables. Instálalo desde el marketplace. El plugin Pomodoro añade un pequeño widget de temporizador que corre en el sidebar, con:

• Intervalos de trabajo configurables. El predeterminado es 25 minutos.
• Intervalos de descanso configurables. El predeterminado es 5 minutos para descansos cortos, 15 para largos.
• Un contador de ciclos. Rastrea cuántos Pomodoros has completado en una sesión.
• Integración opcional con tareas. El plugin puede sugerir tomar una tarea del hub de Tareas en la que enfocarte, y (opcionalmente) marcar la tarea como en progreso mientras el temporizador corre.

El Pomodoro es un plugin pequeño y enfocado. Es un buen ejemplo de un plugin que añade una herramienta sin intentar hacer demasiado.

Local AI Models

El plugin de IA en el dispositivo. Instálalo desde el marketplace (id zettly-local-models) — no viene incluido con la app principal ni el instalador de escritorio. Cuando está instalado, Local AI Models te permite ejecutar modelos de chat GGUF, modelos de embedding ONNX y generación de imágenes local enteramente en tu máquina. Nada sale de tu ordenador.

El plugin añade su propia sección de ajustes Local models con un asistente de ajuste de hardware: escanea tu máquina, recomienda un modelo que encaje y lo descarga desde Hugging Face cuando lo instalas. Úsalo para chat privado del Asistente de IA y para embeddings locales en Memoria y RAG. Sin este plugin instalado, solo están disponibles proveedores de IA en la nube y embeddings en la nube.

Local AI Models es el plugin más grande del marketplace hoy. También es el primero que debes instalar si quieres que el asistente corra sin enviar tu vault a un proveedor en la nube.

File Manager

Plugin de confianza en el hilo principal para operaciones de archivos del vault. Instálalo desde el marketplace (id zettly-file-manager). Añade una pestaña Archivos con arrastrar y soltar entre el sidebar del Explorador, tableros, presentaciones y adjuntos del chat.

File Manager necesita permisos de sistema de archivos más amplios que la mayoría de plugins (vault-readwrite). Revisa la lista de permisos al instalar.

Ajustes por plugin

Cada plugin tiene su propio panel de ajustes. Puedes configurar:

• Encendido/apagado. Un interruptor maestro para el plugin. Apagado significa que el plugin está instalado pero no corriendo.
• Permisos. Los datos a los que el plugin puede acceder. Un plugin que quiere leer tus notas pregunta; puedes conceder o revocar en cualquier momento.
• Opciones específicas del plugin. El intervalo de trabajo del Pomodoro. Los modelos de chat y embedding activos de Local AI Models. Cada plugin tiene sus propias opciones.
• Almacenamiento. Algunos plugins almacenan datos en tu vault. El panel de ajustes muestra qué datos ha almacenado el plugin y te permite borrarlos.

Los ajustes son por vault. Un plugin puede configurarse de forma distinta en tu vault de trabajo y tu vault personal.

Permisos

El sistema de permisos es la parte del modelo de plugins que más importa para la confianza. Los plugins preguntan antes de actuar, y puedes revocar cualquier permiso en cualquier momento.

Las categorías de permisos estándar:

• Leer notas. El plugin puede leer el contenido de notas en el vault activo.
• Escribir notas. El plugin puede crear o modificar notas. (La mayoría de plugins no piden esto — proponen cambios a través del flujo de vista previa en su lugar.)
• Leer tareas. El plugin puede leer el hub de Tareas.
• Escribir tareas. El plugin puede crear o modificar tareas.
• Leer calendario. El plugin puede leer la superficie Calendario.
• Leer tableros. El plugin puede leer diseños de tableros y widgets.
• Escribir tableros. El plugin puede crear o modificar tableros.
• Leer presentaciones. El plugin puede leer presentaciones de diapositivas.
• Escribir presentaciones. El plugin puede crear o modificar presentaciones.
• Leer y escribir archivos. El plugin puede acceder a archivos en el vault más allá de las notas.
• Acceso a red. El plugin puede hacer solicitudes HTTP. Los destinos están declarados en el manifiesto.
• Mostrar notificaciones. El plugin puede mostrar notificaciones del sistema o de la app.
• Acceso a conector MCP. El plugin puede hablar con un conector MCP externo (mcp:<connector-id>).

Cada manifiesto de plugin también declara un alcance del sistema de archivos: none, vault-readonly o vault-readwrite. Esto es separado de los permisos por recurso anteriores y controla qué tan ampliamente el plugin puede tocar archivos del vault.

Cuando se instala un plugin, ves la lista de permisos que pide. Puedes conceder todos, conceder selectivamente o denegar la instalación. Después de instalar, puedes revocar cualquier permiso desde los ajustes del plugin. Revocar un permiso que un plugin necesita para funcionar pausará el plugin y te dirá por qué.

Interruptores por plugin

Más allá del interruptor maestro de encendido/apagado, muchos plugins tienen interruptores por función. Algunos ejemplos:

• El Pomodoro tiene interruptores para integración con tareas, efectos de sonido y comportamiento de recordatorio de descanso.
• Local AI Models tiene interruptores para el modelo de chat activo, modelo de embedding, modo de ejecución (auto o solo CPU) y aceleración GPU.
• Un puente de búsqueda web tiene un interruptor para si debe usarse por defecto o solo cuando se pida explícitamente.

El principio es el mismo: cada plugin te da tanto control como tenga sentido, con valores predeterminados sensatos.

Seguridad: cómo se verifican los plugins

La confianza en un sistema de plugins viene de la verificación. El sistema de plugins de Zettly está diseñado para ser auditable.

Cada plugin en el marketplace:

• Se envía como release versionado. Un plugin es una versión específica, con un changelog claro y una fecha.
• Tiene una suma de comprobación SHA-256. La suma de comprobación del paquete se publica con el release. Cuando instalas, la app verifica que la suma coincida antes de activar.
• Fue revisado manualmente. Un humano revisó el manifiesto del plugin, sus permisos y su comportamiento. La revisión es la puerta.
• Tiene una lista de permisos declarada. El manifiesto declara cada permiso que el plugin necesita. La lista que ves al instalar es la lista que el plugin usará — no más.
• Corre en un entorno aislado. El plugin no puede alcanzar los internals de la app ni el sistema de archivos en general.

La combinación de verificación de suma de comprobación, revisión manual y aislamiento es lo que hace seguro instalar desde el marketplace. No tienes que tomar la palabra de un plugin sobre lo que hace; el manifiesto es el contrato.

Algunas notas prácticas:

• Los plugins autoalojados son posibles. Si quieres instalar un plugin que no está en el marketplace (uno que escribiste, o uno de una fuente de confianza), la app soporta cargarlo desde un archivo local. Se aplica el mismo modelo de suma de comprobación y manifiesto.
• Las actualizaciones de plugins están firmadas. Cuando un plugin se actualiza, la nueva versión se verifica contra su suma de comprobación. Si la suma no coincide, la actualización se rechaza.
• Los plugins se pueden desinstalar limpiamente. Desinstalar elimina el código del plugin, revoca sus permisos y (opcionalmente) borra sus datos almacenados.

Una nota sobre el estado alpha

El sistema de plugins es funcional pero nuevo. El marketplace es pequeño, y los plugins más útiles hoy (Pomodoro, Local AI Models, File Manager) son descargables desde el marketplace. A medida que avance el alpha, el marketplace crecerá.

Si tienes una idea para un plugin, o quieres escribir uno, consulta la documentación para desarrolladores (que vive en otro lugar; esta es la página de documentación para usuarios). Para usuarios, el sistema de plugins hoy es: un marketplace pequeño pero sólido, tres plugins destacados bien probados, y un modelo de seguridad que hace que probar plugins nuevos sea de bajo riesgo.

Consejos y convenciones

Algunas cosas que no son obvias hasta que has instalado unos plugins:

• Empieza con los plugins destacados. Pomodoro, Local AI Models y File Manager son buenos casos de prueba para el modelo de plugins. Instálalos desde el marketplace, configúralos, mira cómo se siente el flujo de permisos.
• Lee la lista de permisos. Cuando instalas un plugin, la lista de permisos es el contrato. Si un plugin pide permisos que no coinciden con lo que hace, no lo instales.
• Revoca permisos no usados. Si un plugin tiene acceso a algo que no necesita, revócalo. El plugin te dirá si no puede funcionar sin el permiso.
• Actualiza plugins con regularidad. Las actualizaciones de plugins están versionadas y tienen suma de comprobación. Actualizar es seguro; no actualizar significa perderse correcciones de seguridad.
• Desinstala limpiamente. Cuando ya no necesites un plugin, desinstálalo. La limpieza de permisos y datos es automática.

Consulta Asistente de IA para las funciones adyacentes a plugins del sistema de IA, y Memoria y RAG para el enriquecimiento integrado del vault y la revisión en la bandeja de entrada del chat.