← Volver al catálogo

Evalua

Guides teachers through a short interview for printable school math exams and keeps the teacher profile, workspace and exam numbering.

Detalles:

Arnés de metodologíaMantenido aquí

npmRepositorioSitioReportar un problema

Instalación

alisio install npm:@alisio/plugin-evalua@0.13.1

Metadatos

Paquete	@alisio/plugin-evalua
Versión	0.13.1
Publicado	11 nov 2026
Autor	Alisio
Licencia	MIT
Categorías	Arnés de metodología
Tamaño	5.9 MB
Dependencias	1
Peer dependencies	1
Descargas (último mes)	967
Origen	Primera parte
Palabras clave	alisio-plugin, education, math, exams

Nota de seguridad: Los plugins se ejecutan en proceso con tus privilegios de usuario y no están en un sandbox. Revisa el código fuente antes de instalar un plugin de terceros.

@alisio/plugin-evalua

Léelo en inglés. Ambos README se mantienen sincronizados y deben actualizarse juntos.

Evalúa ayuda a un docente a preparar exámenes de matemáticas imprimibles mediante una entrevista breve y guiada, con las respuestas y los distractores calculados por código y un presupuesto de páginas que se mide, nunca se adivina.

Estado: v1 completo en funcionalidad. El perfil, el espacio de trabajo y la entrevista, el núcleo matemático exacto, la base de conocimiento extensible, la generación y verificación de ítems, y el flujo de extremo a extremo (Puerta A → generate → build → Puerta B) que escribe los cuatro documentos en HTML y PDF están implementados y probados.

Instalación

Instálalo de forma persistente con Alisio:

alisio install npm:@alisio/plugin-evalua

Instala una versión concreta, o actualiza un plugin instalado a una versión concreta:

alisio install npm:@alisio/plugin-evalua@0.2.1
alisio install npm:@alisio/plugin-evalua@0.2.1 --update

alisio install --update (sin spec) actualiza todos los plugins instalados.

Para desarrollo local en el proyecto, en su lugar:

npm install --save-dev @alisio/plugin-evalua
alisio --plugin @alisio/plugin-evalua

Requiere Node 22.16 o superior y @alisio/sdk >=0.9.0 <0.12.0. El flujo por chat funciona en cualquier host de ese rango; la app Evalúa necesita Alisio 0.11.6 o superior (ver abajo).

La app Evalúa

En Alisio 0.11.6 o superior, Evalúa (Evalua en inglés) aparece en el grupo Apps del panel izquierdo: una app de página completa que lleva al docente por el mismo flujo con formularios en lugar de respuestas en el chat. Sigue el idioma de Alisio (inglés o español) y su tema claro u oscuro.

1. Perfil docente: nombre, colegio, asignatura, tamaño del papel y un logo opcional (PNG, JPEG o WebP, hasta 2 MB).
2. Nuevo examen: elige el grado, luego un tema de la lista de la base de conocimiento, el nivel, los tipos de preguntas (solo los que el tema admite), cuántas, el banco (si lo hay) y el formato. Un resumen acompaña cada respuesta. Si el tema tiene menos preguntas distintas de un tipo de las que pediste, la app lo indica antes de aprobar, con el tema, el tipo y el máximo.
3. Revisa y aprueba el plan (Gate A); solo entonces se crea la carpeta del examen.
4. Redacción: deja la frase predeterminada de cada tipo de ejercicio, escribe la tuya o pide al modelo elegido en Configuración un borrador para revisar y editar. La redacción hecha con IA puede contener errores: lee cada frase antes de aprobarla. Se listan todos los tipos de ejercicio de los temas elegidos, sin importar qué tipos de pregunta pida el plan; un examen hecho solo con preguntas del banco ya tiene su redacción, así que no hay nada que redactar. Sin un modelo conectado, la redacción con IA se apaga y todo lo demás funciona.
5. Preguntas y luego Documentos: crea los cuatro documentos con el progreso a la vista (y un botón Cancelar), míralos y descarga el PDF o el HTML.
6. Aprobación final (Gate B). Si la última creación informó problemas (por ejemplo, un límite de páginas que no se pudo cumplir), la app los muestra y pide que los confirmes.

Los exámenes anteriores quedan en solo lectura: al abrir uno se ve su configuración, sus preguntas (si llegaron a crearse) y sus documentos para ver y descargar. Para cambiarlo o volver a crear sus preguntas, Usar esta configuración en un examen nuevo abre un borrador nuevo con la misma configuración para revisarlo; un tipo de pregunta que el tema ya no ofrece se quita, y la app avisa cuál. Los comandos y herramientas del chat siguen funcionando igual y ven los mismos exámenes; si el chat cambia un examen con la app abierta, la app lo vuelve a cargar, y mientras la app crea documentos, generate, build, approve y set-prompts del chat responden que hay una creación en curso. En Alisio 0.11.5 la app abre, pero cada guardado se rechaza salvo que la sesión ya lo permita; los hosts anteriores no tienen app y conservan el flujo por chat. Cada guardado pide la aprobación de Alisio igual que el chat: permite guardar archivos y, para los documentos, ejecutar la impresora de PDF. Sin Chrome, Chromium, Edge, Brave, Vivaldi u Opera, la app escribe y muestra solo el HTML. Por ahora los documentos del examen se escriben en español (el único idioma incluido).

Cómo se usa

Habla con el coordinador; empieza por el idioma, luego la institución, el docente y el logo opcional, y crea el espacio de trabajo sobre la marcha. Después pide el examen en tres rondas cortas. Nada se escribe en disco antes de la Puerta A, la aprobación del docente.

La entrevista pregunta solo lo que aún no sabe:

Ronda	Preguntas
Perfil (una vez por espacio)	idioma, institución, nombre del docente, logo opcional
1 — qué	tema (sugerencias de la base de conocimiento), grado, nivel (básico/intermedio/avanzado/genio), base de conocimiento
2 — forma	tipos de ítems que admite el tema (selección múltiple), número de preguntas, mismo examen o banco, columnas
2b — solo banco	tamaño del banco, número de variantes
3 — impresión y tono	límite de páginas (las mínimas legibles, 1, 2 o la cantidad que escribas), tiempo e instrumento, texto de cierre

También puedes usarlo sin interfaz: la ronda pendiente se guarda en el estado del espacio de trabajo y continúas con /evalua:new id=valor ... (el texto libre va en :text=...).

Cómo se genera y se revisa un examen

La tabla de especificaciones es una rejilla de tema × demanda cognitiva × tipo de ítem. Los candidatos salen primero de las familias de ítems y luego de los ítems estáticos del banco, y cada candidato se verifica por código antes de congelarse; un candidato que falla se vuelve a sortear (con límite) y una casilla que no se puede llenar se reporta. La app y el chat ensayan esta generación con semilla antes de registrar el plan, así que un tema que no alcanza la cantidad pedida se detecta en la entrevista y no después del Gate A.

Agentes

evl-coordinator conduce la entrevista y las puertas en prosa y llama a las herramientas. Nunca redacta una respuesta matemática: las familias, los solvers y el catálogo son la fuente de verdad. Los ítems redactados los revisan de forma independiente evl-math-reviewer (solo lectura) y evl-language-reviewer (solo lectura); el revisor nunca ve el razonamiento del autor.

Comandos y herramientas

Comando	Qué hace
/evalua:init [dir] [--edit]	Crea el espacio de trabajo (carpeta evalua/ por defecto) y pide el perfil del docente una vez.
/evalua:new [tema]	Corre la entrevista del examen y guarda el borrador hasta la Puerta A.
/evalua:status	Muestra el perfil, la ronda pendiente, el borrador y las carpetas de examen.
/evalua:approve a|b	La Puerta A asigna la carpeta del examen y congela exam.yaml; la Puerta B aprueba el paquete final.
/evalua:generate	Construye la tabla de especificaciones, genera y verifica los ítems y congela items.json.
/evalua:build	Lee la carpeta aprobada, ajusta el presupuesto de páginas y escribe el examen, la hoja de respuestas, el solucionario y la rúbrica en HTML y PDF.
/evalua:kb	Lista la base de conocimiento: packs, temas y niveles.
/evalua:doctor	Reporta la salud de la base de conocimiento y el navegador de impresión disponible.

Herramientas para agentes: evalua_profile, evalua_answer, evalua_status, evalua_kb, evalua_check, evalua_exam, evalua_generate y evalua_build.

CLI independiente:

alisio-evalua check    # el informe EVL-KB-*
alisio-evalua kb       # packs, temas y niveles en JSON
alisio-evalua doctor   # salud de la base de conocimiento y navegador

Cómo funciona

• Matemática exacta. Las respuestas y los distractores salen de aritmética racional exacta (fracciones con BigInt) y un tipo pequeño de polinomio racional multivariable; el azar es un xoshiro128** con semilla, así que el mismo examen siempre reconstruye las mismas preguntas en el mismo orden.
• Base de conocimiento extensible. Packs YAML versionados declaran temas, calibración por nivel y fuentes (familias de ítems o ítems estáticos de banco). Un pack de workspace en /knowledge-packs/ extiende o reemplaza uno empaquetado sin tocar código. El cargador aplica EVL-KB-001..007.
• Generación y verificación. Una tabla de especificaciones determinista guía los candidatos por familias y luego banco, con un bucle de resorteo acotado, deduplicación y referencias estables; las comprobaciones EVL-ITM-* y EVL-EXM-* controlan el resultado.
• Renderizado y ajuste. Un modelo de documento tipado alimenta un emisor HTML autocontenido (KaTeX en el servidor, incrustado, sin red) y printToPDF de la familia Chrome; una escalera de densidad mide páginas reales y elige el preset más legible que cumpla el presupuesto, fallando de forma explícita con EVL-LAY-001 cuando no puede. Una auditoría in-page revisa desbordamiento horizontal, cajas solapadas, texto bajo el piso, ajuste de fórmulas y espacio de respuesta (EVL-LAY-002, EVL-LAY-004).
• Cobertura. Siete packs incluidos siguen los DBA y los Estándares del MEN: primary-math de Primero a Quinto (valor posicional, operaciones con naturales, dinero en pesos, la hora, secuencias y patrones, el signo igual y el número desconocido, fracciones como parte de un todo, pictogramas y gráficas de barras, perímetro y área, volumen con cubos, ángulos, fracción/decimal/porcentaje, probabilidad simple y medición), basic-math de Cuarto a Noveno (incluye divisibilidad con paridad y múltiplos, estadística con cuartiles y diagramas de caja, el plano cartesiano del primer cuadrante a los cuatro, valor absoluto, notación científica, números racionales e irracionales, y porcentajes con razones y proporciones), geometry de Sexto a Noveno (escalas en planos y mapas, ángulos en triángulos y polígonos, longitud y área del círculo, teorema de Pitágoras, semejanza y Tales, y volumen de cilindro, cono y esfera, con respuestas exactas en π), probability-statistics (diagramas de árbol y eventos compuestos, conteo con y sin reemplazo, rango, varianza y desviación estándar, permutaciones y combinaciones, probabilidad condicional e independencia), functions (sucesiones aritméticas y geométricas, funciones exponenciales y logaritmos, función cuadrática, y dominio, rango, composición e inversa), precalculus para Décimo y Undécimo (razones trigonométricas con valores exactos de los ángulos notables, círculo unitario y radianes, circunferencia y parábola, tasa de variación media y límites, y derivadas) y algebra (las inecuaciones lineales se amplían con notación de intervalo e inecuaciones con valor absoluto).
• Figuras. Se generan por código figuras SVG deterministas a partir de los mismos parámetros que la respuesta y se incrustan en los ítems con un bloque figure: diagramas de conjuntos (Venn), planos cartesianos y cuadrículas de coordenadas numeradas, triángulos, cuadrados, rectángulos y figuras en L con sus lados rotulados, polígonos regulares, circunferencias, elipses, prismas (también rotulados o armados con cubos unidad), cilindros, conos, rectas numéricas, barras y círculos de fracción, gráficas de barras y pictogramas, ángulos a escala, relojes de manecillas, ruletas y bolsas de bolas con letras, triángulos rectángulos con lados rotulados y un ángulo marcado, triángulos trazados desde sus ángulos, triángulos semejantes y paralelas de Tales, esferas, mapas y planos a escala, diagramas de árbol, diagramas de caja, gráficas de funciones (también curvas trigonométricas y rectas secantes y tangentes), el círculo unitario con un ángulo marcado, circunferencias y parábolas en la cuadrícula con centro, foco y directriz, e intervalos en la recta numérica con extremos abiertos y cerrados. Cada figura tiene un título accesible en español, se imprime en blanco y negro y no necesita assets externos ni red.
• Temas. Se envían tres temas por datos (classic, blue, dark), elegidos por exam.yaml.template y extensibles desde templates/themes//.
• Textos de cierre. Un catálogo con fuente (frases célebres y versículos de la Reina-Valera 1909 en dominio público) más una capa de citas de workspace para textos del docente; nada se escribe de memoria.

Navegadores de impresión

Los PDF necesitan un navegador compatible con Chromium; no se descarga nada. La detección acepta Google Chrome, Chromium, Brave, Microsoft Edge, Vivaldi y Opera en Linux, macOS y Windows, respetando ALISIO_EVALUA_CHROME, PUPPETEER_EXECUTABLE_PATH y CHROME_PATH. Sin navegador, la construcción igual escribe los HTML autocontenidos con KaTeX y avisa de que no se verificaron los límites de página.

Estructura del espacio de trabajo

<workspace>/
  .alisio/evalua/state.json     estado de la máquina (escrituras atómicas)
  .alisio/evalua/app.json       solo la app Evalúa: modelo elegido, redacción de IA pendiente, última creación
  evalua/
    teacher.yaml                perfil del docente, editable a mano
    assets/logo.png             logo opcional (PNG, JPEG o WebP, hasta 2 MB; SVG se rechaza)
    knowledge-packs/            packs de workspace opcionales (extienden o reemplazan los empaquetados)
    quotes/                     textos de cierre del docente, opcionales
    exams/NN-slug/              se crea solo después de que el docente aprueba la especificación

Los números de examen son consecutivos y nunca se reutilizan, aunque se borre una carpeta a mano.

Campos del perfil

teacherName, institution (se imprime en mayúsculas), logo opcional, subject (por defecto Matemáticas), language (por defecto es) y paper (letter o a4, por defecto letter).

Licencia

MIT. KaTeX vendorizado es MIT; ver THIRD_PARTY_NOTICES.md.