KnowX Knowledge Base

Una base de conocimiento con búsqueda para EmDash: categorías, opiniones sobre los artículos y un informe de lo que buscan los lectores.

Extensión

KnowX Knowledge Base

Una base de conocimiento con búsqueda para EmDash: categorías, opiniones sobre los artículos y un informe de lo que buscan los lectores.

Categoría: knowledge base
Estado: Disponible
Versión: 0.2.1
Precio: Desconocido
Fuente: Registro oficial de plugins
Instalación: Plugin aislado del registro
Verificado: 2026-10-21

Abrir en Claude Abrir en ChatGPT

Compartir en X Compartir en LinkedIn Compartir en Reddit

Descripción

KnowX convierte un sitio EmDash en un centro de ayuda. Los visitantes buscan una respuesta, exploran los temas e indican si un artículo les ayudó. Usted ve qué búsquedas no encuentran nada y qué artículos reciben más votos de No que de Sí.

Qué obtiene

Inicio de la ayuda. Un cuadro de búsqueda y tarjetas de temas. Cuando tiene más de una categoría de primer nivel, cada tarjeta muestra un nombre, una breve descripción y un icono que usted elige.
Artículos. Tabla de contenidos, copiar enlace en los títulos, copiar en el código, anterior y siguiente, fecha de la última actualización, insignia de versión opcional.
Búsqueda. La búsqueda propia de EmDash, limitada a los tipos de contenido que usted marque. Resultados instantáneos mientras escribe, más una página de resultados. Cada resultado indica de qué tipo de contenido se trata.
FAQ. Su propia página, con datos de FAQ para los motores de búsqueda.
¿Le resultó útil? Sí o No en cada artículo. Tras un No puede pedir un breve comentario.
¿Aún necesita ayuda? Un botón de contacto tras una búsqueda vacía y tras un voto de No. Usted establece un enlace. Se oculta cuando este ajuste está vacío.
Información y búsquedas. Los artículos débiles por nombre, los comentarios como texto sin formato, las búsquedas principales, las búsquedas que no encontraron nada.
Tarjeta del panel. Las búsquedas vacías de esta semana y el artículo menos útil.

Cómo encaja todo

KnowX es el motor: rutas, almacenamiento y las pantallas de administración. Un plugin de EmDash no puede añadir páginas a su sitio, así que las páginas públicas se entregan como un kit de sitio que copia una sola vez. Véase Instalación.

Los invitados buscan, leen y votan cuando el host da a EmDash la dirección del visitante (Cloudflare, o trustedProxyHeaders). En otros casos, los invitados ven un enlace de inicio de sesión para votar, y los miembros votan como de costumbre.

Instalación

Antes de instalar

1. Su sitio necesita un ejecutor de sandbox. Los plugins del registro se ejecutan en un sandbox. Mientras el sitio no tenga uno, Admin, Plugins muestra «No plugins configured» y no hay Registry en el menú.

Node: en su sitio, ejecute npm install @emdash-cms/sandbox-workerd workerd y luego añada sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox", dentro de emdash() en astro.config.mjs.
Cloudflare: añada import from "@emdash-cms/cloudflare"; y sandboxRunner: sandbox(),. Necesita el plan Workers Paid, el enlace worker_loaders llamado LOADER (descomente en su configuración de Wrangler) y un bucket R2 como storage: r2(...), o la instalación se detiene con «Storage error while installing plugin». Luego ejecute npm run deploy.

Detenga el servidor de desarrollo y vuelva a iniciarlo. Registry aparece ahora en el menú de administración.

2. El plugin es el motor. Las páginas para visitantes provienen de su kit de sitio. Un plugin del registro no puede añadir páginas a su sitio. Hasta que copie el kit, sus direcciones (por ejemplo /docs/) muestran la página 404 de su sitio. Es lo esperado. La copia del kit que sigue requiere un solo comando.

3. Necesita Node 22.16 o posterior para el paso npx emdash seed.

Comprobado en EmDash 1.3.1 con la plantilla blog, en Node y en Cloudflare Workers (instalación desde el registro).

Instalar

Admin, Registry, busque KnowX, Install y acepte los permisos.

Desde la carpeta raíz de su sitio:

kit="$(mktemp -d)" &&
  git clone --depth 1 \
    --branch v0.2.1 \
    https://github.com/wbcomdesigns/emdash-knowx \
    "$kit/emdash-knowx" &&
  "$kit/emdash-knowx/scripts/add-to-site.sh" .

Reinicie el servidor de desarrollo.
En Admin, Menus, añada /docs/ y /docs/faq/.
Abra KnowX, Insights y luego añada artículos en Content, Help articles.

Vuelva a ejecutar el paso 2 tras cada actualización. Guía: https://github.com/wbcomdesigns/emdash-knowx/blob/v0.2.1/docs/website/getting-started/install.md

Preguntas frecuentes

¿Por qué /docs/ da un 404 tras la instalación? El plugin no puede crear páginas. Ejecute las dos líneas del kit de la pestaña Installation y luego reinicie el servidor de desarrollo.

¿Fallan los votos o el registro de búsquedas tras una instalación desde el registro? Copie el kit de sitio actual. Los kits antiguos solo llamaban a /plugins/knowx/. Una instalación desde el registro usa un id generado. El kit actual prueba ese id y luego el nombre.

¿Pueden los invitados votar y buscar? Buscar y leer, siempre. Votar, cuando el host da a EmDash la dirección del visitante (Cloudflare, o trustedProxyHeaders); en otros casos los invitados ven un enlace de inicio de sesión y los miembros votan.

¿La búsqueda recorre entradas y páginas? Solo los tipos de contenido que marque en Settings. Help articles está activado por defecto. Un tipo con la búsqueda desactivada en su colección no devolverá resultados.

¿Envía correo electrónico? No. El botón de contacto es un enlace que usted establece: una página, una dirección http(s) o una dirección mailto.

¿Funciona en modo oscuro? Sí. Los colores del kit siguen el tema de su sitio.

¿Hay una versión de pago? No. Todo lo que hay aquí es gratis.

¿Puedo poner un cuadro de búsqueda dentro de un artículo? No con la instalación desde el registro. Eso requiere una instalación de confianza y no forma parte de esta versión.

Registro de cambios

0.2.1

Tras actualizar desde la 0.1.x, Insights muestra el progreso de la migración hasta que termina.

Corrección - Insights ya no muestra «None yet» mientras los votos de la 0.1.x aún se están trasladando.
Corrección - Un clic en Sí o No antes de que cargue el script de la página se conserva y se envía. Vuelva a copiar el kit.

0.2.0

Cada página de ayuda, voto, búsqueda y pantalla de administración cabe ahora en el límite de Cloudflare de 10 solicitudes por llamada de plugin.

Novedad - Cada artículo conserva recuentos acumulados de Sí y No, actualizados con el voto.
Novedad - Una pantalla Searches contiene Top searches y Searches with no results.
Novedad - Los datos de la 0.1.x se trasladan paso a paso al abrir Insights.
Mejora - Was this helpful responde a los clics al instante y muestra que el voto se está enviando. Vuelva a copiar el kit.
Corrección - En Cloudflare, un voto ya no muestra «Something went wrong» después de haberse guardado.
Corrección - En Cloudflare, Insights, Settings y sus acciones ya no fallan en un sitio con mucho tráfico.
Corrección - La tarjeta de configuración indica dónde crear los tipos de contenido en un sitio sin SQLite.

0.1.5

Seguridad: los votos de invitados y las búsquedas solo se cuentan cuando el host da a EmDash la dirección del visitante; en otros casos los invitados inician sesión para votar. Registro de búsquedas limitado a 5000 términos.
Novedad: un solo comando copia el kit y crea los tipos de contenido. Insights muestra una tarjeta Set up visitor pages, y Top searches tiene búsqueda y paginación.
Corrección: Insights cuenta cada búsqueda y voto; las páginas de ayuda se alinean con el marco del tema; los botones del modo oscuro alcanzan 4,5:1.

Versiones anteriores: https://github.com/wbcomdesigns/emdash-knowx/blob/main/CHANGELOG.md

Para copiar el kit de esta versión, desde la carpeta raíz de su sitio:

kit="$(mktemp -d)" &&
  git clone --depth 1 \
    --branch v0.2.1 \
    https://github.com/wbcomdesigns/emdash-knowx \
    "$kit/emdash-knowx" &&
  "$kit/emdash-knowx/scripts/add-to-site.sh" .