# Guía de usuario de Cosimo

Cosimo te ayuda a estudiar pares de pregunta y respuesta con repetición espaciada. Está diseñado para usarse con teclado y lector de pantalla.

## Inicio rápido

Cosimo es una aplicación portable. Para instalarlo, descomprime el archivo zip de la versión publicada en la carpeta desde la que quieras ejecutar Cosimo y después inicia `cosimo.exe` desde esa carpeta. Para actualizar, cierra Cosimo, descomprime el nuevo zip sobre la carpeta existente de Cosimo y permite que se sobrescriban los archivos de la aplicación. Los paquetes publicados no deberían sobrescribir datos de usuario como `cosimo.ini`, mazos personales, bases de datos de repaso, informes, directorios de audio junto al mazo o copias de seguridad.

Cuando Cosimo se inicia, abre el último mazo usado. En una instalación nueva, normalmente es `decks/deck.cosimo-deck`, junto al ejecutable. Usa `Archivo -> Abrir mazo` para abrir otro archivo `.cosimo-deck`. Si el archivo de mazo no existe, Cosimo pregunta si quieres crearlo.

Para añadir material, usa `Carta -> Añadir carta` para una sola carta, o `Carta -> Añadir cartas en bloque` para introducir varias seguidas. Una carta tiene una pregunta, que es la cuestión o pista que ves primero, y una respuesta, que es la solución contra la que te compruebas. Mantén preguntas concretas y evita preguntas duplicadas.

La pantalla inicial muestra un resumen, una lista de preguntas de cartas y una barra de estado. La barra de estado indica las cartas totales, las cartas disponibles ahora, y si hay una sesión programada pendiente o cuánto falta aproximadamente para la próxima. La pantalla inicial se actualiza aproximadamente una vez por minuto. Pulsa `F5` para actualizarla manualmente.

Usa `Comenzar` para ejecutar la sesión programada. Durante una sesión normal de estudio, Cosimo muestra primero la pregunta. Puedes valorar tu predicción:

- `1`: no lo sé
- `2`: probablemente no lo sé
- `3`: probablemente lo sé
- `4`: seguro que lo sé

También puedes elegir `Mostrar respuesta`, o pulsar Espacio, para mostrar la respuesta sin registrar una predicción. Después de mostrar la respuesta, elige la valoración de recuerdo:

- `1`: Repetir
- `2`: Difícil
- `3`: Bien
- `4`: Fácil

La valoración de recuerdo es lo que Cosimo usa de forma más directa para programar la carta. Pulsa `0` durante una sesión normal de estudio para terminarla antes de tiempo. Los intentos completados se guardan igualmente.

Usa `Forzar comienzo` para practicar más cuando quieras ignorar la programación. Usa `Estudiar marcadas` para cartas que hayas señalado para atención manual. Usa `Comenzar examen` para una prueba con respuestas escritas a partir de una muestra aleatoria, y `Comenzar cuestionario` para practicar con respuestas de opción múltiple. Las sesiones de examen y cuestionario son solo informativas: no cambian la programación de repetición espaciada.

Después de estudiar, Cosimo muestra un resumen. Elige `Guardar informe` para escribir un informe de texto en el directorio `reports`, o `Continuar` para volver a la pantalla inicial.

Otras funciones útiles:

- `Estudio -> Panel de aprendizaje` o `Ctrl+L` muestra progreso, calibración, carga de trabajo e información diagnóstica de todo el mazo.
- `Herramientas -> Opciones` configura idioma, mínimo de cartas por sesión, copias de seguridad, audio de repaso, notificaciones, minimización al área de notificación y calibración del panel.
- `Herramientas -> Generar audio` puede crear audio de repaso en Opus o WAV cuando un mazo tiene metadatos de voz.
- `Archivo -> Exportar mazo completo`, `Archivo -> Copia completa del mazo` y `Archivo -> Restaurar mazo completo` gestionan paquetes comprimidos del mazo para compartirlo, migrarlo o hacer una copia manual.
- `Mazo -> Sincronizar` permite iniciar sesión en un servidor de sincronización y subir o descargar el mazo actual.
- `Ayuda -> Guía de usuario`, `Ayuda -> Wiki del proyecto` y `Ayuda -> Informar de un error` abren recursos locales o del proyecto.

## Organización de los menús

Cosimo agrupa las órdenes según aquello sobre lo que actúan:

- `Archivo` sirve para abrir mazos, acceder a mazos recientes, exportar, hacer copias o restaurar paquetes comprimidos, y salir.
- `Mazo` contiene operaciones que afectan al mazo entero, como propiedades, metadatos, sincronización, reversibilidad en bloque y reparación de preguntas duplicadas.
- `Carta` contiene acciones y detalles sobre la carta seleccionada o la carta actual durante una sesión de estudio.
- `Estudio` sirve para iniciar sesiones de estudio, estudiar cartas marcadas, hacer exámenes y abrir el panel de aprendizaje.
- `Herramientas` contiene opciones de la aplicación, generación de audio y mantenimiento de la base de datos de repaso.
- `Ver` controla cómo se ordena la lista inicial.
- `Ayuda` abre la guía, enlaces del proyecto y el diálogo Acerca de.

## Cómo estudia cartas Cosimo

La repetición espaciada es un método de estudio basado en repasar el material a intervalos crecientes. Cuando algo es nuevo, difícil o se ha fallado recientemente, debería volver pronto. Cuando algo es fácil y se recuerda de forma consistente, puede esperar más. El objetivo es dedicar más tiempo al material que necesita atención y menos a repetir lo que ya está seguro.

Cosimo registra tus respuestas y valoraciones, y usa ese historial para decidir qué cartas están pendientes.

Cosimo usa algunos términos de forma específica:

- Una `carta` es un par de pregunta y respuesta dentro del mazo.
- Un `elemento de estudio` es una dirección programable de una carta. Una carta normal tiene un elemento de estudio; una carta inversa generada añade otro con pregunta y respuesta intercambiadas.
- Una `sesión de estudio` es un recorrido desde Comenzar, Forzar comienzo o Estudiar marcadas hasta el resumen.
- Una `pregunta` es una presentación de una pregunta durante una sesión de estudio.
- Un `intento` es una respuesta almacenada con valoración de recuerdo y, si se indicó, una estimación de confianza previa a revelar la respuesta.

Cosimo conserva expresiones como `base de datos de repaso`, `historial de repaso`, `repaso programado` y `audio de repaso` para partes establecidas de la aplicación. En esas expresiones, repaso se refiere al proceso más amplio de repetición espaciada o al historial de estudio almacenado, no necesariamente a una sesión entera.

Cosimo guarda cada intento completado en la base de datos de repaso. Para cada carta, consulta el historial de repaso y estima cuándo debe volver la carta.

En general:

- las cartas sin historial de repaso están pendientes inmediatamente
- las cartas falladas o incorrectas vuelven antes
- las respuestas marcadas como `Difícil` avanzan con más cautela que las marcadas como `Bien` o `Fácil`
- las cartas que se recuerdan con facilidad esperan más tiempo

Cosimo usa un algoritmo de programación FSRS-6. Sigue la dificultad y la estabilidad de cada carta. Las respuestas correctas repetidas hacen que la carta sea más estable y alargan el intervalo, mientras que las respuestas falladas o incorrectas devuelven la carta hacia el aprendizaje. Las cartas marcadas como `Repetir` usan pasos cortos automáticos: las cartas nuevas normalmente usan pasos de aprendizaje de 1 minuto y 10 minutos, y las cartas en estado de repaso marcadas como `Repetir` usan un paso de reaprendizaje de 10 minutos. Las cartas marcadas como `Repetir` no se repiten automáticamente al final de la sesión actual; Cosimo espera hasta que venza el paso de aprendizaje o reaprendizaje programado.

Los cuatro botones de recuerdo tienen las mismas etiquetas en todos los estados, pero su efecto de programación depende de si el elemento de estudio es nuevo, está en aprendizaje, en repaso, o en reaprendizaje:

- `Repetir` significa que no recordaste la respuesta lo bastante bien. En una carta nueva o en aprendizaje, mantiene la carta en aprendizaje y reinicia el primer paso corto de aprendizaje. En una carta en estado de repaso, es una recaída: la carta pasa a reaprendizaje y vence después del paso corto de reaprendizaje. En una carta que ya está en reaprendizaje, la mantiene en reaprendizaje sin contar otra recaída.
- `Difícil` significa que recordaste la respuesta, pero con dificultad. En una carta en aprendizaje o reaprendizaje, mantiene la carta en ese estado de pasos cortos en vez de graduarla inmediatamente. En una carta en estado de repaso, sigue siendo un recuerdo correcto, pero programa un intervalo más prudente que `Bien` o `Fácil`.
- `Bien` significa que recordaste la respuesta de forma aceptable. En una carta en aprendizaje, pasa al siguiente paso de aprendizaje, o gradúa la carta al estado de repaso si los pasos de aprendizaje se han completado. En una carta en reaprendizaje, devuelve la carta al estado de repaso. En una carta en estado de repaso, programa el siguiente intervalo normal.
- `Fácil` significa que recordaste la respuesta con facilidad. En una carta nueva, en aprendizaje, o en reaprendizaje, gradúa directamente la carta al estado de repaso. En una carta en estado de repaso, programa un intervalo más largo que `Bien`.

Los mazos estudiados por primera vez con versiones beta antiguas pueden contener filas de programación existentes del algoritmo anterior, de estilo FSRS, de Cosimo. Las versiones actuales migran esas filas derivadas de programación reproduciendo el historial de repaso almacenado con el programador FSRS-6 actual. Esto no elimina el historial de repaso, pero las fechas pendientes y los diagnósticos de recaídas del panel pueden cambiar una vez cuando una base de datos de repaso antigua se abre con una compilación de Cosimo más reciente.

En términos de programación, una recaída es más específica que cualquier respuesta `Repetir`. Significa que una carta que ya había llegado al estado de repaso se marcó como `Repetir` y pasó a reaprendizaje. `Repetir` cuando una carta es nueva, está en aprendizaje, o ya está en reaprendizaje se registra como respuesta, pero no añade otra recaída programada.

El intervalo exacto es automático. No necesitas gestionar fechas manualmente. Para cartas ordinarias en estado de repaso, Cosimo puede variar ligeramente y de forma determinista los intervalos más largos. Esto evita que las cartas vuelvan a agruparse siempre en la misma fecha futura. Los pasos cortos de aprendizaje y reaprendizaje no se varían.

El mínimo de cartas por sesión controla cuántas cartas intenta incluir Cosimo cuando pulsas `Comenzar`. Por ejemplo:

- si el mínimo es `0`, Cosimo incluye solo cartas pendientes
- si el mínimo es `10` y solo hay 6 cartas pendientes, Cosimo añade 4 cartas adicionales al azar
- si hay 20 cartas pendientes y el mínimo es `10`, Cosimo incluye las 20 cartas pendientes

El mínimo no es un máximo. Las cartas pendientes no se ocultan solo porque haya más que el mínimo.

Cuando empieza una sesión, las cartas pendientes en aprendizaje y reaprendizaje aparecen antes que las cartas normales de repaso. Después vienen las cartas nuevas. Dentro de los grupos de aprendizaje/reaprendizaje y repaso, aparecen primero las cartas que llevan más tiempo pendientes. Las cartas con la misma fecha pendiente, o con fechas pendientes separadas por aproximadamente una hora o menos, se ordenan al azar dentro de ese grupo. Las cartas nuevas también se ordenan al azar, para que las cartas añadidas por grupos temáticos no se repasen en el orden del mazo.

Las cartas útiles son concretas y no ambiguas. Una pregunta debería pedir una sola cosa, y la respuesta esperada debería ser lo bastante breve como para poder juzgarla de forma consistente. Evita preguntas duplicadas: una pregunta debería identificar una sola carta. Las respuestas duplicadas están bien, pero las cartas inversas generadas exigen cuidado adicional porque una respuesta duplicada se convertiría en una pregunta inversa duplicada.

## Cartas y mazos

Un mazo es un archivo que contiene cartas. Los archivos de mazo de Cosimo usan la extensión `.cosimo-deck`.

Puedes editar cartas dentro de Cosimo o editar directamente el archivo del mazo en un editor de texto. El archivo del mazo guarda preguntas, respuestas, metadatos del mazo y marcas de cartas, como el estado no reversible. El historial de repaso y las valoraciones se guardan por separado.

Los archivos de mazo también contienen un pequeño marcador numerado al final de cada carta, como `=1=`. Deja ese número en su sitio cuando edites a mano. Permite que Cosimo conserve el historial de repaso de la carta aunque cambies el texto de la pregunta o de la respuesta. Si añades cartas nuevas a mano, termina cada carta nueva con `===` en vez de inventar un marcador numerado. Cosimo elegirá un ID seguro y no usado la próxima vez que abra el mazo. Usa `=i=` en vez de `===` para una carta añadida a mano que no deba ser reversible. Cosimo también puede escribir `next_card_id` en los metadatos del mazo; déjalo en su sitio, porque evita que las cartas nuevas reutilicen IDs antiguos después de una limpieza. Cuando Cosimo abre un mazo antiguo, guarda una copia de seguridad del original según la configuración de copias del mazo y actualiza el archivo al formato actual.

Usa `Mazo -> Propiedades del mazo` para ver la versión del formato del mazo y los campos opcionales de metadatos, como título, autor, descripción, URL, voces elegidas y si la generación automática de audio está desactivada. Usa `Mazo -> Editar metadatos del mazo` para editar esos campos de metadatos. El mismo diálogo contiene la visibilidad del mazo para sincronización: público, no listado o privado. La URL del servidor de sincronización, la sesión de sincronización y el nombre local del dispositivo son ajustes de la aplicación en `Herramientas -> Opciones` y `Mazo -> Sincronizar`, porque identifican esta instalación de Cosimo y la cuenta usada, no solo un mazo concreto.

El mazo predeterminado es `decks/deck.cosimo-deck`, junto al ejecutable de Cosimo. En instalaciones portables de Windows, guarda tus mazos en la carpeta `decks` junto a la aplicación. Si falta el mazo predeterminado, Cosimo crea uno vacío. Puedes abrir otro mazo desde `Archivo -> Abrir mazo`. Si eliges un archivo de mazo que no existe, Cosimo pregunta si quieres crear ahí un mazo vacío.

Cuando Cosimo se cierra, recuerda el último mazo abierto y vuelve a abrirlo la próxima vez. También conserva hasta ocho mazos abiertos recientemente en `Archivo -> Mazos recientes`, omitiendo el mazo actual. Si solo hay otro mazo reciente, Cosimo lo muestra directamente en el menú `Archivo`, sin colocarlo en un submenú. Guarda esta y otras opciones de la aplicación en `cosimo.ini`, junto al ejecutable. Cosimo también recuerda el filtro y el modo de ordenación de la lista inicial. Si encuentra archivos antiguos `cosimo-settings.txt` o `cosimo-last-open-deck.txt`, los migra a `cosimo.ini` y elimina los archivos antiguos.

### Añadir y editar cartas

Usa `Carta -> Añadir carta` para añadir una carta. El editor tiene campos de pregunta y respuesta. También tiene una casilla `Marcar como no reversible`. Déjala sin marcar para una carta normal; márcala cuando la carta no deba usarse nunca para generar una carta inversa.

Para introducir varias cartas seguidas, usa `Carta -> Añadir cartas en bloque`. Escribe la pregunta y la respuesta, y pulsa `Ctrl+Enter` desde cualquiera de los dos campos para añadir la carta y volver al campo de pregunta. Al pulsar Tab desde el campo de respuesta también se añade la carta y se vuelve al campo de pregunta cuando ambos campos contienen texto. Pulsa Escape para cerrar el diálogo de entrada en bloque. La entrada en bloque no muestra la casilla de carta no reversible, para mantener breve el flujo de entrada repetida.

Usa `Carta -> Editar carta seleccionada` para editar la carta seleccionada desde la lista inicial. Después de revelar una carta durante una sesión de estudio, esta orden cambia a `Carta -> Editar carta actual`. También puedes elegir `Editar carta` o pulsar `e` en ese momento. Cosimo abre el mismo editor que se usa en el resto de la aplicación, guarda el texto de la carta y vuelve al paso de valoración posterior a la respuesta. La decisión de programación se toma solo después de elegir la valoración de recuerdo.

Usa `Delete` o `Carta -> Eliminar carta seleccionada` para eliminar la carta seleccionada del mazo. Eliminar una carta principal también elimina su carta inversa generada de la lista de preguntas, porque la carta inversa se deriva de la carta principal. Los datos de repaso de la carta inversa permanecen en la base de datos, pero solo vuelven a ser útiles si restauras una copia de seguridad del mazo que contenga la carta principal original.

Usa `Alt+Enter`, `Carta -> Detalles de la carta` o el menú contextual de la lista de preguntas para mostrar detalles y estadísticas de la carta seleccionada.

### Preguntas y respuestas duplicadas

Evita preguntas duplicadas. Una pregunta debería identificar una sola carta. Cosimo rechaza las acciones normales de añadir y editar que crearían una pregunta duplicada. Si editas un mazo a mano e introduces preguntas duplicadas, Cosimo abre el mazo con un aviso. Usa el filtro `Preguntas duplicadas` para encontrarlas, o usa `Mazo -> Resolver enunciados duplicados` para elegir la respuesta que se conservará para cada pregunta duplicada; las otras cartas con esa pregunta se eliminan del mazo, y sus datos de repaso quedan inactivos salvo que se depure la base de datos de repaso. Durante la resolución de duplicados, `Saltar enunciado` deja la pregunta duplicada actual sin cambios y continúa con preguntas duplicadas posteriores. `Cancelar resolución` detiene el proceso por completo. Las preguntas ya resueltas permanecen cambiadas.

Las respuestas duplicadas sí están permitidas. A menudo son útiles cuando distintas preguntas comparten la misma respuesta. La restricción solo afecta a las cartas inversas generadas: de cada grupo de cartas con la misma respuesta, como máximo una carta puede tener una carta inversa generada activa. Si hubiera más de una, las cartas inversas generadas tendrían la misma pregunta y ya no estaría claro qué carta original se está preguntando. Cosimo impide crear o editar cartas inversas cuando eso produciría esa ambigüedad. Marca una carta como no reversible si su respuesta compartida no debería usarse nunca como pregunta inversa.

### Cartas reversibles y no reversibles

Usa `Carta -> Añadir carta inversa`, o pulsa `Ctrl+R` cuando la lista de preguntas tenga el foco, para añadir una carta inversa generada. Una carta inversa pregunta por la respuesta original y espera la pregunta original. Las cartas inversas tienen su propio estado de programación e historial de repasos. Cosimo impide hacer reversible una carta cuando otra carta con la misma respuesta ya tiene una carta inversa generada activa, porque la pregunta inversa sería ambigua. Las cartas inversas se marcan con `(inversa)` en la lista de preguntas y pueden encontrarse con el filtro `Cartas inversas`. Eliminar una carta inversa elimina solo la dirección inversa generada; no elimina la carta principal. Los datos de repaso de la carta inversa permanecen en la base de datos y se vuelven a usar si haces reversible de nuevo la carta principal. Cuando una carta inversa generada está seleccionada, el menú de cartas y el menú contextual ofrecen eliminar esa dirección inversa, no marcar la carta principal como no reversible.

Usa `Carta -> Marcar carta seleccionada como no reversible` cuando una carta no deba tener dirección inversa generada. Esto escribe una marca en el archivo del mazo, elimina cualquier carta inversa generada activa de esa carta principal e impide que `Hacer cartas aptas reversibles` la vuelva a añadir más adelante. Usa `Carta -> Quitar marca de carta no reversible` para quitar esa marca. La carta vuelve a ser apta para inversión manual o en bloque, siempre que su respuesta no esté ya usada por otra carta inversa generada activa. Las cartas no reversibles aparecen con `(no reversible)` en la lista de preguntas, pueden encontrarse con el filtro `Cartas no reversibles`, y muestran la marca no reversible en la línea de estado de detalles de la carta. Cuando una carta no reversible está seleccionada, los menús ofrecen quitar la marca de carta no reversible, no crear una carta inversa directamente.

Usa `Mazo -> Hacer cartas aptas reversibles` para marcar como reversibles en una sola operación todas las cartas que puedan serlo. Cosimo pide confirmación e indica cuántas cartas pueden cambiarse. Se excluyen las cartas que ya son reversibles, las cartas marcadas como no reversibles y las cartas cuyo grupo de respuestas ya tiene una carta inversa generada activa. Si las copias de la base de datos de repaso están activadas, esta operación actualiza la copia retenida antes de escribir y la confirmación avisa de que esa copia retenida se sobrescribirá.

Usa `Mazo -> Deshacer última reversión en bloque` para eliminar solo las cartas inversas creadas por la última reversión en bloque. Se conservan las cartas inversas creadas manualmente y los lotes anteriores. Las cartas principales y el historial de repaso inverso permanecen en la base de datos.

### Suspender, aplazar y marcar cartas

Usa `Carta -> Suspender carta seleccionada`, el menú contextual de la lista de preguntas, o `Ctrl+S` cuando la lista de preguntas tenga el foco, para conservar la carta en el mazo pero impedir que aparezca en sesiones normales o forzadas. La lista de preguntas marca las cartas suspendidas con `(suspendida)`. Las cartas suspendidas pueden encontrarse con el filtro `Cartas suspendidas` y reactivarse desde el mismo menú, menú contextual o atajo. Las cartas suspendidas también se ignoran cuando la barra de estado indica si hay un repaso pendiente ahora o cuándo será el próximo repaso.

Usa `Carta -> Aplazar carta seleccionada hasta mañana`, o el menú contextual de la lista de preguntas, para posponer temporalmente la carta seleccionada sin cambiar su programación almacenada. Una carta aplazada permanece en el mazo y vuelve automáticamente cuando caduca el aplazamiento. Mientras está aplazada, aparece con `(aplazada)`, se muestra en el filtro `Cartas aplazadas` y queda excluida de sesiones programadas, sesiones forzadas, recuentos de la pantalla inicial y cálculos de pendientes en la barra de estado. Usa `Carta -> Quitar aplazamiento de carta seleccionada`, o el menú contextual, para hacerla disponible de nuevo inmediatamente.

Durante una sesión de estudio, antes de mostrar la respuesta, usa `Ctrl+D` o el botón `Aplazar carta hasta mañana` para posponer la carta actual y continuar. El aplazamiento no está disponible después de mostrar la respuesta. Si todas las cartas de la sesión se aplazan antes de registrar ninguna respuesta, Cosimo muestra un aviso indicando que no se estudió ninguna carta.

Usa `Carta -> Marcar carta seleccionada`, el menú contextual de la lista de preguntas, o `Ctrl+F` cuando la lista de preguntas tenga el foco para marcar o desmarcar la carta seleccionada. Durante una sesión de estudio, `Ctrl+F` marca o desmarca la carta actual. La pantalla de estudio también tiene un botón para marcar o desmarcar en ambas fases, después de los botones de valoración correspondientes. Marcar sirve para seguimiento manual: úsalo cuando una carta pueda necesitar edición, resulte confusa o ambigua, tenga una respuesta dudosa o requiera atención después de la sesión. Marcar una carta no afecta a la programación ni a si la carta aparece en el estudio normal. Las cartas marcadas aparecen con `(marcada)` en la lista de preguntas y pueden encontrarse con el filtro `Cartas marcadas`.

## Pantalla inicial

Cuando Cosimo se inicia, se abre en la pantalla inicial. Esta pantalla muestra:

- cuántas cartas hay en el mazo
- cuántas cartas están programadas ahora
- el mínimo de cartas por sesión
- el archivo de base de datos de repaso
- una lista de preguntas de cartas

Si el mínimo de cartas por sesión hace que Cosimo añada cartas adicionales que todavía no están pendientes, el recuento de programadas también muestra entre paréntesis cuántas están pendientes. Por ejemplo, `Programadas ahora: 10 (6 pendientes)` significa que la sesión incluiría 6 cartas pendientes y 4 cartas adicionales para llegar al mínimo.

La barra de estado de la ventana principal da un resumen breve: cartas totales, cartas pendientes ahora, y si hay un repaso pendiente ahora o cuánto falta aproximadamente para el próximo repaso programado. Las duraciones se redondean hacia arriba a unidades cómodas para síntesis de voz, como `2 días`, `4 semanas` o `3 meses`. Durante una sesión, la barra de estado cambia al contexto de la sesión, como sesión de estudio programada, sesión de estudio no programada, examen o cuestionario, con el progreso actual.

Mientras la pantalla inicial está abierta, Cosimo actualiza el resumen, los filtros de la lista y la barra de estado aproximadamente una vez por minuto. Una carta que pase a estar pendiente mientras la aplicación está abierta quedará disponible para `Comenzar` sin cerrar y volver a abrir el mazo.

Teclas útiles en la pantalla inicial:

- `Alt-M`: comenzar la sesión programada
- `Alt-F`: forzar el comienzo con todas las cartas no suspendidas ni aplazadas
- `Alt-X`: comenzar una sesión de examen con una muestra aleatoria de cartas activas
- `Alt-Z`: comenzar una sesión de cuestionario con una muestra aleatoria de cartas activas
- `Alt-L`: ir al filtro de texto de la lista de preguntas
- `F5`: actualizar el resumen, los filtros de lista y la barra de estado
- `Ctrl+L`: mostrar el panel de aprendizaje
- `Alt-S`: salir
- `Alt+Enter`: mostrar detalles y estadísticas de la carta seleccionada
- `Delete`: eliminar la carta seleccionada de la lista de preguntas
- `Ctrl+S`: suspender o reactivar la carta seleccionada
- `Ctrl+F`: marcar o desmarcar la carta seleccionada
- `Ctrl+D`: aplazar la carta seleccionada hasta mañana, o quitar su aplazamiento
- `Ctrl+R`: hacer reversible la carta seleccionada, o eliminar la carta inversa generada

Usa `Ver -> Orden del mazo`, `Ver -> Próximo repaso programado`, `Ver -> Último repaso`, `Ver -> Texto de pregunta`, `Ver -> Texto de respuesta` o `Ver -> Recuerdo estimado` para elegir cómo se ordena la lista de preguntas. Usa `Ver -> Ascendente` o `Ver -> Descendente` para elegir la dirección. Los elementos marcados del menú Ver muestran el criterio y la dirección actuales. Cuando eliges otro criterio de ordenación, Cosimo restablece la dirección al valor por defecto de ese criterio. Último repaso usa descendente por defecto, poniendo primero las cartas estudiadas más recientemente y dejando las cartas nuevas al final; último repaso ascendente pone primero las cartas estudiadas hace más tiempo y también deja las cartas nuevas al final. Recuerdo estimado usa la misma estimación de programación que el panel de aprendizaje; recuerdo estimado ascendente pone primero las cartas que se estiman menos probables de recordar y deja al final las cartas sin estimación, como las nuevas.

El filtro de texto reduce la lista buscando en la pregunta o la respuesta. El cuadro combinado de filtro controla qué tipo de cartas se muestran, incluidas cartas marcadas, preguntas duplicadas, respuestas duplicadas, cartas no reversibles, cartas aplazadas, cartas problemáticas, problemas de asimetría, fallos con confianza alta y aciertos con confianza baja. Sus recuentos siguen el filtro de texto actual. El filtro de respuestas duplicadas es especialmente útil antes de hacer cartas reversibles.

El menú Cartas también puede actuar sobre las cartas que se muestran actualmente en la lista inicial. Usa `Marcar todas las cartas visibles` o `Desmarcar todas las cartas visibles` para marcar todo un conjunto filtrado para revisión manual, por ejemplo todas las cartas problemáticas antes de elegir `Estudiar marcadas`. `Suspender todas las cartas visibles` y `Quitar suspensión de todas las cartas visibles` funcionan del mismo modo. Cosimo pide confirmación e indica cuántas cartas visibles cambiarán realmente; las cartas que ya estén en el estado pedido se dejan sin cambios.

El filtro `Cartas problemáticas` muestra elementos de estudio activos que parecen inusualmente difíciles en el mazo actual. Espera hasta que un elemento tenga al menos 4 intentos, y usa el comportamiento de repaso en vez de simplemente la edad de la carta. Una carta puede aparecer ahí si al menos 2 de sus últimos 5 intentos fueron `Repetir`, si su tasa vitalicia de `Repetir` está en el 20% más alto del mazo y es al menos 25%, si sus lapsos programados por intento están en el 20% más alto del mazo y son al menos 20%, o si su dificultad de programación está en el 20% más alto del mazo y es al menos 8 en la escala de dificultad FSRS de 1 a 10. Las cartas suspendidas y actualmente aplazadas no se muestran ahí.

El filtro `Problemas de asimetría` es para cartas reversibles. Cuando ambas direcciones tienen al menos 4 intentos y una dirección es sustancialmente más débil, el filtro muestra el elemento de estudio más débil. Cosimo compara una tasa de recuerdo estricta ligeramente suavizada, donde solo `Bien` y `Fácil` cuentan como recordadas, y considera sustancial una diferencia de 30 puntos porcentuales o más. Esto es útil cuando, por ejemplo, ver una palabra indonesia y recordar el español es fácil, pero producir la palabra indonesia desde el español sigue siendo poco fiable.

Los filtros `Fallos con confianza alta` y `Aciertos con confianza baja` usan intentos recientes con valoración de confianza. `Fallos con confianza alta` muestra elementos de estudio activos donde elegiste recientemente `Probablemente lo sé` o `Seguro que lo sé`, pero después respondiste sin recordar la respuesta según la regla activa de recuerdo de calibración; basta con el último intento con confianza, o al menos 2 de los últimos 5 intentos con confianza. `Aciertos con confianza baja` muestra elementos de estudio activos donde al menos 2 de los últimos 5 intentos con confianza fueron `No lo sé` o `Probablemente no lo sé` seguidos de una respuesta que cuenta como recordada según la regla activa de recuerdo de calibración. Con la regla permisiva, `Difícil`, `Bien` y `Fácil` cuentan como recordadas; con la regla estricta, solo `Bien` y `Fácil`. Las cartas suspendidas y actualmente aplazadas no se muestran en ninguno de los dos filtros.

El diálogo de detalles de carta muestra la pregunta, la respuesta, el ID de carta, el estado actual de la carta, el número de intentos, el último intento, el estado de programación, la disponibilidad, el recuerdo estimado ahora, el recuerdo reciente, el resumen de recaídas y el historial de intentos de la carta seleccionada. El estado de carta combina en una sola línea marcas visibles como suspendida, marcada, aplazada, inversa, tiene inversa y no reversible. La disponibilidad explica si una carta es nueva, está programada para más tarde, está lista para un repaso programado ordinario o espera un paso de aprendizaje o reaprendizaje. Cuando hay una hora programada, la línea de disponibilidad incluye tanto el tiempo relativo como la fecha y hora UTC exacta.

Las cartas inversas generadas muestran el ID de carta de la carta principal, porque editar la carta principal en el mazo también cambia su dirección inversa generada. Los campos de fecha del resumen, como último intento y última actualización de programación, se muestran primero como duración relativa completa, por ejemplo `1 día, 1 hora, 1 minuto, 1 segundo`, seguida de la fecha y hora UTC exacta entre paréntesis. Las fechas pasadas usan la misma duración relativa completa seguida de `atrás`. La lista de historial de intentos del final usa solo fechas y horas UTC exactas.

## Sesiones de estudio

Hay tres órdenes normales de sesión de estudio:

`Comenzar` usa la programación. Repasa primero las cartas pendientes. Si hay menos cartas pendientes que el mínimo de cartas por sesión configurado, Cosimo añade cartas adicionales al azar desde el resto del mazo.

`Forzar comienzo` ignora la programación. Pone todas las cartas no suspendidas ni aplazadas en orden aleatorio. Úsalo cuando quieras estudiar aunque no haya cartas pendientes, o cuando quieras una sesión de práctica más larga.

`Estudiar marcadas` inicia una sesión no programada solo con cartas marcadas. Esta sesión incluye cartas marcadas estén programadas o no, pero excluye las cartas suspendidas o aplazadas. El orden es aleatorio, y la sesión no quita las marcas; quita las marcas manualmente cuando esas cartas ya no requieran seguimiento. El botón está desactivado cuando no hay cartas marcadas disponibles para estudiar.

Cuando se muestra una pregunta, puedes valorar qué probabilidad crees que tienes de saber la respuesta:

- `1`: no lo sé
- `2`: probablemente no lo sé
- `3`: probablemente lo sé
- `4`: seguro que lo sé

Esta es tu predicción antes de ver la respuesta.

También puedes elegir `Mostrar respuesta`, o pulsar Espacio, para mostrar la respuesta sin registrar una predicción. Esto se guarda como `Sin responder` en el resumen de la sesión.

Después de valorar tu predicción, o de mostrar directamente la respuesta, Cosimo muestra la respuesta. Entonces valora lo que ha ocurrido realmente:

- `1`: Repetir
- `2`: Difícil
- `3`: Bien
- `4`: Fácil

Esta valoración es lo que Cosimo usa de forma más directa para programar la carta. La misma valoración de recuerdo puede tener un efecto de programación distinto según si la carta todavía está en un paso corto de aprendizaje o ya ha llegado al estado de repaso ordinario; consulta `Cómo estudia Cosimo las cartas` para más detalles.

Si encuentras un error después de mostrar la respuesta, elige `Editar carta`, usa `Carta -> Editar carta actual`, o pulsa `e`. Cosimo abre el mismo editor que se usa en el resto de la aplicación, guarda el texto de la carta y vuelve al paso de valoración posterior a la respuesta. La decisión de programación se toma solo después de elegir la valoración de recuerdo.

Al final de una sesión de estudio, Cosimo muestra un resumen de esa sesión:

- cuántas cartas se han estudiado
- tiempo total y tiempo por carta
- recuentos y porcentajes de las valoraciones de predicción, incluidas las respuestas mostradas sin predicción
- recuentos y porcentajes de las valoraciones de recuerdo

Si una sesión antigua, o un modo de estudio futuro, contiene preguntas repetidas para el mismo elemento de estudio, Cosimo muestra la distinción más detallada entre cartas únicas, preguntas respondidas, tiempo por pregunta y tiempo por carta única. Los modos de estudio actuales normales no repiten las cartas valoradas como `Repetir` en la misma sesión. Una carta y su dirección inversa generada cuentan como cartas estudiadas distintas.

Las cartas aplazadas antes de mostrar la respuesta no cuentan como preguntas respondidas en el resumen de la sesión.

Elige `Guardar informe` para escribir una copia de texto del resumen de una sesión normal en el directorio `reports`, junto al ejecutable. Cosimo crea el directorio si hace falta. Los nombres de informe normales usan el nombre del archivo del mazo sin su extensión y la hora UTC en que terminó la sesión, por ejemplo `Indonesian-2026-05-03-06-04.txt`. Si ya existe un informe con ese nombre, Cosimo añade un sufijo numérico en vez de sobrescribirlo. El texto del informe incluye la ruta completa del mazo.

Elige `Continuar` para volver a la pantalla inicial.

## Exámenes y cuestionarios

`Comenzar examen` toma una muestra del mazo activo en vez de usar la programación. Las cartas suspendidas y aplazadas se excluyen. Cosimo te pide que elijas un número de preguntas o un porcentaje de cartas activas, y después selecciona y ordena las cartas al azar para reducir las pistas producidas por el orden del mazo.

Si el mazo tiene cartas inversas generadas, la configuración del examen incluye una opción de dirección de estudio: solo normal, solo inversa o ambas. Si el mazo no tiene cartas inversas generadas, esta opción queda oculta y el examen usa la dirección normal.

Durante un examen, Cosimo muestra cada pregunta y te pide que escribas la respuesta. No muestra la corrección mientras el examen está en curso. Las respuestas exactas cuentan como correctas automáticamente. Al final, para cada respuesta que no fue una coincidencia exacta, Cosimo muestra la pregunta, tu respuesta y la respuesta esperada, y pregunta si la respuesta debe contar como correcta.

Si la casilla `Exacto` está marcada al comenzar el examen, las respuestas no exactas no se corrigen manualmente. Cuentan como incorrectas, y Cosimo muestra cada una para revisión con la pregunta, tu respuesta y la respuesta esperada. Elige `Siguiente` o pulsa `Alt-N` para seguir revisando respuestas inexactas, o elige `Resumen` para ir directamente al resumen del examen.

Si la casilla `Examen cronometrado` está marcada, introduce un número entero de minutos para el examen. El tiempo restante se muestra en la barra de estado. Cosimo reproduce un tono muy breve en cada límite del 10% del tiempo. Cuando se agota el tiempo, cualquier texto que esté en el campo de respuesta se envía, se reproducen cuatro tonos cortos, y Cosimo muestra un aviso de tiempo agotado con el número de respuestas enviadas. El aviso empieza con el mensaje enfocado; usa Tab hasta `Siguiente` para continuar a la corrección, la revisión de respuestas o el resumen.

Cuando un examen que no se ha agotado por tiempo termina con al menos una respuesta enviada, Cosimo reproduce dos tonos largos y muestra un aviso de `Examen terminado` antes de la corrección, la revisión de respuestas o el resumen. Esto da a los usuarios que dependen del audio del examen un límite claro entre responder preguntas y comprobar respuestas.

Durante una sesión de examen, elige `Terminar examen` para parar después de las respuestas enviadas hasta ese momento. Si no se envió ninguna respuesta, Cosimo muestra un aviso.

Las sesiones de examen muestran un resumen de examen separado. Informa de preguntas seleccionadas, respuestas enviadas, respuestas correctas y porcentaje correcto, coincidencias exactas, respuestas no exactas aceptadas, respuestas incorrectas, tiempo total, tiempo por pregunta, si el examen terminó antes de tiempo y si se agotó el tiempo de un examen cronometrado. Los resúmenes de examen no cambian la base de datos de repaso. Elige `Guardar informe` para escribir una copia de texto del resumen de examen en el directorio `reports`. Los nombres de informe de examen añaden `-exam`, por ejemplo `Indonesian-exam-2026-05-03-06-04.txt`.

`Comenzar cuestionario` también es no programado y solo informativo. Está pensado para practicar reconocimiento con opciones múltiples, por ejemplo para preparar pruebas externas con preguntas de tipo cuestionario. Cosimo toma una muestra aleatoria de cartas activas y excluye las cartas suspendidas y aplazadas. Salvo que el tamaño solicitado del cuestionario lo haga imposible, evita poner las dos direcciones de la misma carta reversible en un mismo cuestionario, para que una pregunta no dé pistas sobre la dirección contraria.

Si el mazo tiene cartas inversas generadas, la configuración del cuestionario incluye una opción de dirección de estudio: solo normal, solo inversa o ambas. Si el mazo no tiene cartas inversas generadas, esta opción queda oculta y el cuestionario usa la dirección normal.

Durante un cuestionario, Cosimo muestra la pregunta y una lista de respuestas posibles. Elige una respuesta y envíala. La corrección no se muestra hasta el final. Después del cuestionario, Cosimo muestra cada respuesta enviada con la pregunta y la respuesta elegida. Si la respuesta elegida era incorrecta, también muestra la respuesta correcta. Elige `Siguiente` o pulsa `Alt-N` para avanzar por la revisión de respuestas, o elige `Resumen` para ir directamente al resumen de cuestionario. El modo cuestionario no registra intentos, no cambia la programación de las cartas y no añade respuestas falladas al final de la misma sesión. Necesita al menos cuatro opciones de respuesta distintas en la dirección de estudio actual, de modo que las preguntas directas toman las opciones de las respuestas y las preguntas invertidas las toman de los enunciados. Los enunciados de cartas marcadas como no reversibles no se usan como opciones para preguntas invertidas.

Las sesiones de cuestionario muestran un resumen de cuestionario con preguntas seleccionadas, respuestas enviadas, respuestas correctas e incorrectas, porcentaje correcto, tiempo total, tiempo por pregunta y si el cuestionario terminó antes de tiempo. Los resúmenes de cuestionario no cambian la base de datos de repaso. Elige `Guardar informe` para escribir una copia de texto del resumen de cuestionario en el directorio `reports`. Los nombres de informe de cuestionario añaden `-quiz`, por ejemplo `Indonesian-quiz-2026-05-03-06-04.txt`.

## Panel de aprendizaje

Usa `Estudio -> Panel de aprendizaje`, o pulsa `Ctrl+L`, para mostrar un resumen de aprendizaje de todo el mazo. El panel está dividido en secciones de solo lectura separadas para que puedas tabular entre resumen, distribución, carga de trabajo, diagnósticos y actividad en vez de leer un solo campo largo. Informa de varios tipos de datos:

- recuentos de cartas por estado de programación: nuevas, en aprendizaje, en repaso y en reaprendizaje
- recuentos de cartas disponibles, y cuántas de esas ya están programadas y pendientes ahora, ignorando las cartas suspendidas y aplazadas
- estimaciones de recuerdo del modelo para cartas activas con datos de programación
- distribución del recuerdo estimado, incluyendo mediana, media de las cartas más débiles y bandas de recuerdo
- previsión de carga para las próximas 24 horas, 3 días, 7 días y 30 días, con tiempo estimado de estudio cuando hay datos de tiempo registrados, además de afirmaciones prudentes en el resumen sobre la forma y la presión de la carga
- calibración de confianza a partir de tus predicciones previas a la respuesta y tus valoraciones posteriores del recuerdo
- tendencia de recuerdo, recuentos de recaídas y afirmaciones conservadoras de tendencia reciente cuando hay datos suficientes
- diagnósticos como cartas en riesgo, recaídas repetidas, fallos con alta confianza y retención de aprendizaje reciente
- actividad de estudio, incluyendo días con respuestas, respuestas almacenadas, respuestas en sesiones registradas, recuentos de elementos repetidos cuando las sesiones antiguas los contienen, tiempo empleado en sesiones completadas, tiempo de estudio registrado reciente y tiempo medio de estudio por día de estudio activo cuando existen datos de tiempo
- información sobre primera detección de cartas del mazo, que ayuda a comparar el material introducido recientemente con las cartas que han llegado al estado de repaso

La sección de recuerdo es una estimación del modelo de programación de Cosimo, no un resultado medido directamente. Para cada carta activa con datos de programación que no esté suspendida ni aplazada, Cosimo usa la hora del último repaso, la estabilidad almacenada y el intervalo programado real para estimar la probabilidad de que recuerdes la carta ahora. Las cartas nuevas sin datos de programación, las cartas suspendidas y las cartas aplazadas en ese momento no se incluyen en esta estimación. Las cartas en aprendizaje y reaprendizaje usan su intervalo corto programado como punto efectivo del 90%, de modo que una carta pendiente tras un paso corto por fallo no parezca más segura de lo que es.

`Disponibles ahora` cuenta las cartas activas no suspendidas ni aplazadas que se pueden estudiar inmediatamente. Esto incluye cartas nuevas, que Cosimo puede poner en una sesión de estudio inmediatamente, y cartas con datos de programación existentes cuya hora de repaso ya ha llegado. `De estas, ya programadas y pendientes ahora` es un subconjunto de `Disponibles ahora`: solo cuenta cartas disponibles con datos de programación existentes. Usa el mismo límite temporal que `Disponibles ahora`, así que una carta pendiente en el instante exacto en que se generó el panel queda incluida. El panel pone `Disponibles ahora` primero porque es la cifra operativa: cuántas cartas se pueden estudiar ahora.

`Recuerdo medio estimado` es la media de esas estimaciones por carta. El panel también muestra la mediana y las cartas estimadas más débiles para que una media no oculte un grupo pequeño de material débil. La media de las cartas más débiles es la media del recuerdo estimado del 10% inferior de cartas activas con estimación, redondeado hacia arriba para incluir al menos una carta. `Probablemente sabidas` cuenta las cartas estimadas con un recuerdo del 90% o más. `Mayormente estables` es 70-89%, `Frágiles` es 50-69%, y `Muy bajo` es menos del 50%. `Cartas en riesgo` cuenta juntas las bandas frágil y muy baja. Estos números se usan mejor para triaje y tendencias, no como promesa de que responderás correctamente exactamente ese porcentaje de cartas en la próxima sesión.

La previsión de carga muestra cuántas cartas activas están programadas ahora y dentro de las próximas 24 horas, 3 días, 7 días y 30 días. Estos recuentos son acumulativos: una carta disponible ahora también se incluye en los horizontes posteriores. Las cartas suspendidas y aplazadas se excluyen. Cuando Cosimo tiene tiempos de sesión registrados, la previsión también estima el tiempo de estudio a partir del tiempo medio actual por carta única estudiada. Es solo una estimación: refleja intentos repetidos de sesiones registradas anteriores, pero no puede saber cuántos pasos de aprendizaje o reaprendizaje vencerán durante una sesión futura.

La sección Resumen describe la forma de la carga de los próximos 7 días solo cuando se prevén al menos 5 cartas. Si al menos la mitad de la carga de 7 días vence en 24 horas, Cosimo dice que la mayor parte vence en 24 horas. Si al menos tres cuartas partes vencen en 3 días, Cosimo dice que la mayor parte vence en 3 días. En caso contrario, Cosimo dice que la carga está repartida a lo largo de la semana. Cuando existen datos de tiempo de los últimos 7 días, el Resumen también compara la carga estimada de 7 días con tu tiempo de estudio registrado en los últimos 7 días. Si la diferencia es inferior a 5 minutos y al 20% del tiempo registrado reciente, Cosimo describe la estimación como parecida al tiempo de estudio reciente; en caso contrario la describe como mayor o menor y muestra ambas duraciones.

La sección de calibración trata tu predicción antes de ver la respuesta como un intervalo objetivo de si recordarás la respuesta, no como un porcentaje exacto. `No lo sé` significa un objetivo de recuerdo de 0-5%, `Probablemente no lo sé` 5-32%, `Probablemente lo sé` 68-95%, y `Seguro que lo sé` 95-100%. El intervalo central se deja sin cubrir deliberadamente; muestra la respuesta sin valorar confianza si no quieres hacer una predicción. La regla de recuerdo se configura en `Herramientas -> Opciones`. La regla permisiva cuenta `Difícil`, `Bien` y `Fácil` como recordadas, mientras que `Repetir` cuenta como no recordada. La regla estricta cuenta solo `Bien` y `Fácil` como recordadas. El panel muestra la regla activa antes de las cifras de calibración. El intervalo objetivo de recuerdo es la media de los intervalos objetivo de las valoraciones de confianza respondidas. La tasa de recuerdo observada es lo que ocurrió realmente con la regla de recuerdo actual. La calibración está dentro del objetivo si el recuerdo observado cae dentro del intervalo objetivo, hay falta de confianza si el recuerdo observado queda por encima del intervalo, y exceso de confianza si queda por debajo. Las líneas por confianza muestran la misma comparación para cada valoración de confianza. Las cartas mostradas sin predicción se cuentan por separado.

En la sección de diagnósticos, `Fallos con alta confianza` significa que elegiste `Probablemente lo sé` o `Seguro que lo sé` y después no recordaste la respuesta según la regla de recuerdo activa. Es señal de exceso de confianza. `Aciertos con baja confianza` significa que elegiste `No lo sé` o `Probablemente no lo sé` y después recordaste la respuesta según la regla de recuerdo activa. Es señal de falta de confianza. `Respuestas` cuenta eventos de respuesta almacenados; una carta puede aportar más de una respuesta. `Cartas afectadas` cuenta cuántas cartas tienen al menos una respuesta de ese tipo. Los recuentos recientes entre paréntesis usan los últimos 7 días: dicen `todos recientes` si todas las respuestas o cartas contadas son recientes, `ninguno reciente` si ninguna lo es, o en otro caso dan el número de respuestas o cartas recientes. `Cartas con exceso de confianza reciente significativo` y `Cartas con falta de confianza reciente significativa` usan la regla estricta de patrón reciente usada por los filtros diagnósticos de la lista inicial: para el exceso de confianza basta con el último intento con confianza, o al menos 2 de los últimos 5 intentos con confianza; para la falta de confianza deben coincidir al menos 2 de los últimos 5 intentos con confianza.

La sección de tendencia del recuerdo cuenta respuestas almacenadas de cartas del mazo actual. `Recuerdo global` usa la regla ordinaria del panel: `Difícil`, `Bien` y `Fácil` cuentan como recordadas, mientras que `Repetir` cuenta como no recordada. Las líneas de valoración muestran primero porcentajes, seguidos de recuentos entre paréntesis. La ventana reciente compara los últimos 7 días con los 7 días anteriores; Cosimo solo hace una afirmación cualitativa de tendencia cuando ambas ventanas contienen al menos 5 respuestas. Un cambio de 5 puntos porcentuales o más se describe como mejora o empeoramiento; diferencias menores se describen como ampliamente estables. Las tendencias de tasa de `Repetir` en cartas inversas usan las mismas ventanas de 7 días, el mínimo de 5 respuestas y el umbral de 5 puntos, pero una tasa de `Repetir` descendente es mejor y una ascendente es peor. Las líneas de recaídas vienen del estado de programación actual de las cartas activas y ayudan a identificar si el mazo contiene material que vuelve repetidamente desde el estado de repaso al reaprendizaje. Estas recaídas programadas solo cuentan `Repetir` en cartas que ya habían llegado al estado de repaso; las tasas ordinarias de `Repetir` se muestran por separado. Las afirmaciones de retención sobre aprendizaje reciente cuentan cartas aprendidas recientemente que no han tenido después una respuesta `Repetir`. Cosimo necesita al menos 5 cartas aprendidas recientemente antes de describir la retención reciente; 90% o más retenidas es `bien retenidas`, 70-89% es `mayormente retenidas`, y menos de 70% se muestra como recaídas de seguimiento.

Cuando existen datos temporizados de sesión, la sección Resumen incluye el tiempo medio de estudio por día de estudio activo para que esta métrica principal esté visible sin tabular hasta la sección completa de actividad.

Cosimo registra la primera vez que la base de datos de repaso ve cada carta física del mazo. Esto no es necesariamente la fecha real de creación de la carta: en mazos existentes, las cartas actuales se registrarán cuando esta función las vea por primera vez. Por eso el panel lo describe como cartas detectadas por primera vez por esta base de datos de repaso. Cuando la base de datos ya tenga observaciones anteriores, el Resumen puede mostrar una línea de `Flujo del mazo` para los últimos 7 días: cuántas cartas del mazo fueron detectadas por primera vez y cuántas cartas en dirección estándar llegaron al estado de repaso. Es información descriptiva. Su finalidad es ayudarte a juzgar el crecimiento del mazo y el ritmo de aprendizaje sin que Cosimo te diga si debes añadir más o menos cartas.

La sección de actividad de estudio se basa en intentos registrados y resúmenes de sesiones. `Respuestas almacenadas` cuenta respuestas individuales almacenadas. `Días con respuestas` cuenta días UTC con al menos una respuesta registrada. Los recuentos de sesiones, respuestas y tiempo etiquetados como sesiones registradas vienen de resúmenes de sesiones completadas. Las duraciones de tiempo de estudio usan segundos, minutos, horas, días, semanas y años; Cosimo no usa meses porque su duración varía. `Días de estudio temporizados` cuenta días UTC con al menos un resumen de sesión completada y es la base del tiempo medio de estudio por día de estudio activo. El tiempo de estudio reciente registrado y las preguntas recientes registradas comparan los últimos 7 días con los 7 días anteriores. Esto describe actividad de estudio real registrada en sesiones completadas; no es una previsión histórica de cuántas cartas estaban programadas. El Resumen describe el tiempo de estudio reciente como mayor, menor o parecido al de los 7 días anteriores cuando existen datos de sesiones con tiempo; las diferencias inferiores a 5 minutos y al 20% de la ventana anterior se tratan como parecidas. Si hay datos antiguos anteriores a los resúmenes de sesiones, el panel muestra `Respuestas antiguas sin tiempo de sesión` para no confundir el total de respuestas almacenadas con el total menor de sesiones con tiempo. Esa línea se oculta cuando el valor es cero. La misma sección también informa de cuántas cartas físicas del mazo ha detectado por primera vez esta base de datos de repaso, los recuentos de primera detección de los últimos 7 días, los 7 días anteriores y las observaciones anteriores cuando hay suficiente historial, y las cartas activas estándar del mazo que todavía no se han estudiado.

Usa el botón `Guardar informe` del panel para guardar el informe completo del panel en el directorio `reports`. El texto guardado usa encabezados de sección de estilo Markdown e incluye todas las secciones del panel, aunque el diálogo las muestre en campos separados. El nombre del informe usa el nombre del mazo y la hora UTC en la que se abrió el panel, y el informe incluye las rutas completas del mazo y de la base de datos de repaso. Usa `Copiar al portapapeles` para copiar al portapapeles el mismo texto completo del informe.

Si el mazo tiene cartas inversas generadas, el panel añade una comparación entre cartas estándar e inversas, porque una dirección puede ser mucho más fácil que la otra. Si las dos medias de recuerdo estimado difieren en menos de 5 puntos porcentuales, Cosimo describe las direcciones como similares.

## Audio

El soporte de audio tiene dos partes separadas. La reproducción usa archivos Opus existentes, y archivos WAV antiguos, mientras estudias, previsualizas cartas o revisas respuestas de examen. La generación automática usa `voice.exe`, desde la línea de órdenes o mediante `Herramientas -> Generar audio`, para crear archivos Opus o WAV a partir de voces de síntesis instaladas.

La reproducción de audio de repaso es opcional y admite archivos `.opus`, con retroceso a archivos `.wav` antiguos con el mismo ID de carta y lado si no existe archivo Opus. Configúrala en `Herramientas -> Opciones -> Audio durante el estudio`:

- `Sin audio`: Cosimo ignora el audio de las cartas.
- `Manual`: si la pregunta o respuesta actual tiene audio, Cosimo indica que hay audio disponible y muestra un botón `Reproducir/detener audio`.
- `Automático`: Cosimo reproduce el audio de la pregunta cuando aparece una pregunta y el audio de la respuesta cuando aparece una respuesta durante el repaso ordinario. El mismo botón puede detener o volver a reproducir el audio actual.

La opción separada `Tonos guía para el audio automático` añade señales de orientación breves cuando el audio automático está activado: un tono corto antes del audio de pregunta, dos tonos cortos antes del audio de respuesta y un arpegio de tres notas cuando aparece el resumen del repaso. La opción está desactivada por defecto.

`Herramientas -> Opciones -> Formato de generación de audio` controla el formato usado por la generación automática. `Opus` es el valor predeterminado y normalmente ocupa mucho menos espacio que WAV. `WAV` sigue disponible por compatibilidad o para usuarios que prefieran audio generado sin compresión.

`Ctrl+P` activa la misma acción de reproducir/detener cuando el audio de repaso está disponible. En la lista inicial de cartas, `Ctrl+P` o el botón `Reproducir/detener audio` previsualiza la carta seleccionada reproduciendo el audio de la pregunta y después el audio de la respuesta. Pasar a la carta siguiente, mostrar la respuesta, terminar la sesión o cerrar la ventana detiene inmediatamente cualquier audio de carta que se esté reproduciendo. En modo examen, el audio de la pregunta está disponible mientras respondes la pregunta.

`Herramientas -> Opciones -> Reproducir audio automáticamente durante la corrección y revisión de examen` controla lo que ocurre después de enviar una respuesta de examen, cuando Cosimo muestra un diálogo de corrección o revisión. `Sin audio automático` deja esa fase en silencio salvo que pidas audio manualmente. `Pregunta`, `Respuesta` y `Ambas` reproducen automáticamente la pregunta, la respuesta esperada, o la pregunta seguida de la respuesta esperada. En los diálogos de corrección y revisión, `Ctrl+P` siempre reproduce la pregunta seguida de la respuesta esperada cuando esos archivos de audio existen, incluso si el audio automático de corrección/revisión de examen está desactivado.

`Herramientas -> Opciones -> Reproducir audio automáticamente durante cuestionarios` controla el audio de los cuestionarios. `Sin audio automático` deja los cuestionarios en silencio salvo que reproduzcas audio manualmente durante la revisión de respuestas. `Pregunta` reproduce el audio de la pregunta cuando aparece cada pregunta de cuestionario. `Opciones` reproduce el audio de una opción de respuesta cuando esa opción se selecciona, y lo detiene cuando la lista de opciones pierde el foco o cambia la selección. `Ambas` combina esos comportamientos. Durante la revisión de respuestas del cuestionario, el mismo ajuste controla la reproducción automática de la pregunta y de la respuesta correcta; `Ctrl+P` reproduce la pregunta seguida de la respuesta correcta cuando esos archivos de audio existen. Si los tonos guía están activados, la revisión de respuestas del cuestionario también reproduce un tono breve ascendente para una respuesta correcta y un tono breve descendente para una respuesta incorrecta antes de cualquier audio automático de revisión.

Los archivos de audio viven en el directorio con el mismo nombre base junto al mazo. Para la carta `1` de `Indonesian.cosimo-deck`, usa `Indonesian/1.prompt.opus` para el lado de pregunta y `Indonesian/1.response.opus` para el lado de respuesta. Los nombres `.wav` antiguos, como `Indonesian/1.prompt.wav`, siguen reproduciéndose si no existe archivo `.opus`. Las cartas inversas generadas reutilizan los archivos de la carta principal con pregunta y respuesta intercambiadas. La herramienta de generación de audio escribe archivos nuevos en el formato seleccionado en ese directorio, así que conserva copias separadas de cualquier grabación que hayas creado tú.

`Herramientas -> Eliminar audio inoperativo del mazo` elimina archivos de audio reconocidos por Cosimo en ese directorio cuando no pueden usarse: archivos para ID de carta que ya no existen en el mazo, y archivos de formato menos preferido ocultos por un formato preferido para el mismo lado de carta, por ejemplo un `.wav` cuando existe el `.opus` correspondiente. También elimina las entradas correspondientes de `audio-manifest.tsv`. La orden ignora otros archivos del directorio, pide confirmación y no puede deshacerse.

Las copias automáticas del contenido del mazo y de la base de datos de repaso no incluyen archivos de audio junto al mazo. Las exportaciones y copias completas del mazo sí incluyen el directorio auxiliar. Si grabas o editas tu propio audio, asegúrate de usar copias completas del mazo o haz copia del directorio de audio por tu cuenta. La generación actual conserva los archivos `.opus` y `.wav` existentes sin seguimiento en lugar de sobrescribirlos, pero el directorio de audio sigue estando fuera del sistema de copias automáticas del contenido del mazo y de la base de datos.

Los paquetes de Windows también incluyen `voice.exe`, una herramienta auxiliar para generar esos archivos de audio a partir de voces OneCore o SAPI instaladas. Ejecútala desde un símbolo del sistema. Por ejemplo, si `voice.exe` está junto a `cosimo.exe`, esta orden lee `decks/Indonesian.cosimo-deck` y escribe archivos de audio en `decks/Indonesian/`:

    voice Indonesian --prompt-voice "Nombre de voz indonesia" --response-voice "Nombre de voz española"

Por defecto, `voice.exe` escribe archivos Opus. Usa `--format wav` si quieres salida WAV.

También puedes usar `Herramientas -> Generar audio` desde Cosimo después de abrir un mazo. Esta opción solo está disponible cuando el mazo tiene metadatos de `Voz de la pregunta`, `Voz de la respuesta`, `Motor de voz de la pregunta` y `Motor de voz de la respuesta`, para que Cosimo no genere audio silenciosamente con la voz predeterminada equivocada del sistema. Si la opción está desactivada, usa `Mazo -> Editar metadatos del mazo` para escoger esas voces y motores, y comprueba si el mazo está marcado como mazo de audio manual. Muestra un diálogo de progreso mientras `voice.exe` trabaja sobre el mazo actual y escribe la salida de la herramienta en un archivo de texto dentro del directorio `reports`. Si ya existe un archivo `.opus` o `.wav` antiguo sin seguimiento para un lado concreto, `voice.exe` lo deja intacto. Al terminar, Cosimo informa del número de cartas para las que se generó audio, cuántos archivos nuevos se crearon, cuántos archivos gestionados se regeneraron o convirtieron, cuántos archivos sin seguimiento se conservaron y cuántos archivos ya registrados se omitieron. Si el informe menciona archivos regenerados forzosamente por sobrescritura explícita, se refiere a una ruta de sobrescritura de línea de órdenes antigua o futura, no a la generación ordinaria desde la interfaz.

Esta política conservadora está pensada para evitar sustituir grabaciones del usuario. Para un mazo cuyo audio mantienes manualmente, activa `Mazo de audio manual (proteger contra generación automática de audio)` en `Mazo -> Editar metadatos del mazo`. Esto escribe `audio_generation=disabled` en la cabecera del mazo, desactiva `Herramientas -> Generar audio`, y hace que `voice.exe` se niegue a generar audio para ese mazo. No impide reproducir el audio existente.

Usa `voice --list-voices` para ver las voces instaladas. En aprendizaje de idiomas, escoge una voz que corresponda al idioma de cada lado: si las preguntas están en indonesio y las respuestas en español, usa una voz en indonesio para las preguntas y una voz en español para las respuestas. Si ambos lados están en el mismo idioma, `--voice "Nombre de voz"` usa la misma voz para ambos. Usa `--engine onecore` o `--engine sapi` para listar o generar con un motor concreto; `--prompt-engine` y `--response-engine` pueden seleccionar motores distintos para los dos lados.

Los metadatos del mazo también pueden guardar filtros de voz y motores de voz predeterminados. Configura `Voz de la pregunta`, `Voz de la respuesta`, `Motor de voz de la pregunta` y `Motor de voz de la respuesta` en `Mazo -> Editar metadatos del mazo`, o añade `prompt_voice=`, `response_voice=`, `prompt_voice_engine=` y `response_voice_engine=` a la cabecera del mazo. `voice.exe` usa esos valores predeterminados cuando no se indica la opción correspondiente en la línea de órdenes. El mismo editor puede marcar un mazo como de audio manual, lo que añade `audio_generation=disabled`. Cuando `voice.exe` está disponible junto a `cosimo.exe`, el editor de metadatos lista las voces instaladas para el motor seleccionado. Los campos de voz siguen siendo editables, así que puedes escribir un filtro manualmente si la lista falla o si quieres usar un valor que no aparece en ella. El selector de motor puede listar voces OneCore, voces SAPI, o ambas; cuando eliges una voz de la lista, Cosimo guarda automáticamente el motor correspondiente. Si escribes o editas un filtro de voz manualmente, elige `onecore` o `sapi` antes de guardar para que `voice.exe` sepa qué motor usar. Las opciones de línea de órdenes siguen teniendo prioridad sobre los metadatos del mazo, pero no tienen prioridad sobre `audio_generation=disabled`.

La herramienta escribe un archivo `audio-manifest.tsv` en el directorio de audio. Usa ese manifiesto para omitir el audio cuyo texto de carta, voz seleccionada y motor seleccionado no han cambiado. El audio registrado en el manifiesto se considera gestionado por Cosimo y puede regenerarse o convertirse al formato de salida seleccionado. Los archivos `.opus` y `.wav` existentes sin seguimiento se consideran grabaciones del usuario y se dejan intactos; en ese caso Cosimo no crea un archivo nuevo para ese lado de la carta, porque podría ocultar el audio del usuario. `--dry-run` muestra lo que se generaría sin escribir archivos.

## Archivos, copias de seguridad y mantenimiento

Haz copia de seguridad tanto del archivo del mazo como de su base de datos de repaso correspondiente. El archivo del mazo contiene tus cartas, metadatos del mazo y marcas de cartas no reversibles. La base de datos de repaso contiene el estado de programación, valoraciones e historial de repaso.

Cosimo también crea copias automáticas del contenido del mazo. Antes de sobrescribir un mazo existente, copia la versión actual en el directorio `backups` de la aplicación, junto al ejecutable. Los archivos de copia tienen números crecientes, por ejemplo `backups/000001-deck.cosimo-deck`. El archivo `backups/index.txt` registra cada nombre de copia y la ruta del mazo original.

Configura las copias automáticas del mazo en `Herramientas -> Opciones`:

- `Completas`: conserva todas las copias automáticas del mazo.
- `Solo última`: conserva solo la copia automática más reciente de cada ruta de mazo original.
- `Ninguna`: no crea copias automáticas del mazo.

Configura las copias de la base de datos de repaso en `Herramientas -> Opciones`:

- `Al comenzar sesión`: actualiza una copia retenida de la base de datos de repaso cuando comienza una sesión de estudio.
- `Desactivadas`: no crea ni actualiza copias de la base de datos de repaso.

Configura las copias completas automáticas en `Herramientas -> Opciones`:

- `Diarias`: cuando Cosimo arranca o abre un mazo, escribe una copia completa comprimida retenida si el mazo actual no tiene una copia completa de menos de 24 horas. Esta copia incluye el archivo del mazo, el directorio auxiliar con el mismo nombre base y la base de datos de repaso. Solo se escribe después de abrir correctamente el mazo y pasar la comprobación de integridad de la base de datos.
- `Desactivadas`: no crea copias completas retenidas automáticamente.

Para el mazo predeterminado, copia:

- `decks/deck.cosimo-deck`
- `decks/deck.reviews.sqlite3`, si existe
- `decks/deck/`, si usas audio junto al mazo

Para otro mazo, la base de datos de repaso está junto al mazo y usa el mismo nombre base. Por ejemplo, `spanish.cosimo-deck` usa `spanish.reviews.sqlite3`; su directorio de audio, si existe, usa el mismo nombre base que el mazo.

Cierra Cosimo antes de copiar o restaurar archivos de copia de seguridad. Restaurar solo el archivo `.cosimo-deck` recupera las cartas, pero las deja sin su historial de repaso anterior. Restaurar ambos archivos conserva las cartas y su historial de programación.

Cosimo comprueba la integridad de la base de datos de repaso al abrir un mazo. Si Cosimo indica que esa comprobación ha fallado, cierra Cosimo y restaura el archivo `.reviews.sqlite3` correspondiente desde tu copia de seguridad.

Las copias automáticas del contenido del mazo contienen solo el texto del mazo, no el historial de repaso. Para restaurar una, cierra Cosimo y copia la copia elegida por encima del archivo `.cosimo-deck` activo. Para restaurar el historial de programación, restaura el archivo `.reviews.sqlite3` correspondiente desde tu propia copia de seguridad o desde la copia retenida de la base de datos de repaso de Cosimo. Las copias automáticas del contenido del mazo y de la base de datos de repaso no contienen audio junto al mazo. Las copias completas del mazo sí contienen el directorio auxiliar; si no tienes una, restaura el audio desde tu propia copia del directorio de audio.

Las copias completas automáticas son distintas: cuando están activadas, son paquetes comprimidos retenidos que incluyen el mazo, el directorio auxiliar y la base de datos de repaso. Sirven como red de seguridad diaria para el mazo que estás usando, no como sustituto de las exportaciones manuales antes de cambios arriesgados.

`Archivo -> Exportar mazo completo` escribe un paquete comprimido `.zip` con el archivo `.cosimo-deck` actual y su directorio auxiliar con el mismo nombre base, incluidos los archivos de audio y `audio-manifest.tsv` si existen. No incluye la base de datos de repaso. Cosimo propone un nombre con fecha y hora y te permite elegir dónde guardar el paquete. Usa esta exportación cuando quieras compartir el contenido del mazo sin tu historial personal de estudio.

`Archivo -> Exportar mazo completo con historial` escribe el mismo paquete más una instantánea consistente de la base de datos de repaso. Úsalo para mover tu propio entorno de estudio a otro equipo o para hacer una copia manual completa. El archivo contiene datos personales de estudio como programaciones, valoraciones, historial de repaso, suspensiones, marcas y aplazamientos.

`Archivo -> Copia completa del mazo` escribe automáticamente el paquete de mazo y directorio auxiliar en el directorio `backups` de la aplicación y lo registra en `backups/deck-bundle-index.txt`. No incluye la base de datos de repaso.

La copia completa automática diaria opcional también escribe en `backups`, pero usa `backups/automatic-deck-bundle-index.txt` y conserva una copia retenida por ruta de mazo. Incluye la base de datos de repaso.

`Archivo -> Restaurar mazo completo` restaura uno de estos paquetes comprimidos en el directorio `decks` de Cosimo. Cosimo comprueba primero el paquete y muestra el nombre del archivo de mazo, el número de cartas, el número de archivos de audio, el total de archivos y si el paquete contiene historial de estudio. Si se van a sobrescribir archivos existentes, Cosimo avisa y escribe una copia completa comprimida del mazo de destino antes de restaurar. Si se sobrescribirían archivos auxiliares pero no existe un mazo de destino que pueda copiarse, Cosimo rechaza la restauración en lugar de sobrescribirlos.

Restaurar un paquete puede causar pérdida de datos. Puede reemplazar texto de cartas más reciente, audio auxiliar más reciente, un `audio-manifest.tsv` más reciente o historial de programación y valoración más reciente en la base de datos `.reviews.sqlite3`. Un paquete sin historial de estudio no restaurará programación ni historial de valoraciones; un paquete con historial de estudio reemplazará ese historial por la instantánea contenida en el zip. Cierra otros programas que puedan estar usando el mismo mazo o base de datos de repaso antes de restaurar.

## Sincronización de mazos

`Mazo -> Sincronizar` usa la misma maquinaria de paquetes, pero almacena la instantánea en el servidor de sincronización configurado en `Herramientas -> Opciones`. Las instalaciones nuevas de Cosimo usan por defecto el servidor público del proyecto, `https://cosimo.isonomia.net/sync.cgi`; puedes sustituir esa URL por la de tu propio servidor. Los servidores locales de desarrollo pueden usar URL `http://`; los servidores desplegados deberían usar `https://`. Usa `Mazo -> Sincronizar -> Iniciar sesión` para iniciar sesión en el servidor con una cuenta compatible con Mastodon. Cosimo abre la URL de autorización en el navegador, pide el código de autorización y guarda localmente la identidad de sincronización y el token portador de sincronización de Cosimo. Por tanto, trata el archivo local de configuración como privado.

Si no quieres que esta instalación de Cosimo use sincronización, borra la URL del servidor de sincronización en `Herramientas -> Opciones` y guarda las opciones. Cosimo registra esa decisión como `sync_server_url=none` en `cosimo.ini` y no volverá al servidor público hasta que vuelvas a establecer una URL. También puedes hacer lo mismo editando `cosimo.ini` manualmente y poniendo `sync_server_url=None`.

El inicio de sesión compatible con Mastodon es deliberadamente limitado. La instancia fediversa sólo pide autorizar el ámbito `read:accounts`, suficiente para que el servidor de sincronización confirme qué cuenta ha iniciado sesión. No permite leer mensajes privados, publicar estados, seguir cuentas ni actuar como tú. El cliente de escritorio de Cosimo nunca recibe tu contraseña fediversa ni el token de acceso fediverso. Ve la URL de la instancia, el código de autorización que pegas, la identidad de sincronización verificada que devuelve el servidor y el token portador de Cosimo que usará en las siguientes peticiones de sincronización. El servidor de sincronización recibe el código de autorización pegado, recibe brevemente un token de acceso fediverso de la instancia, lo usa para llamar a `verify_credentials`, y después revoca ese token fediverso temporal antes de emitir un token portador de Cosimo. El servidor conserva la identidad de cuenta verificada, las credenciales de la aplicación OAuth para la instancia, los paquetes de mazo que subas y un verificador con hash del token portador de Cosimo; no guarda tu contraseña fediversa ni el token de acceso fediverso. La instancia fediversa ve los metadatos de la aplicación OAuth Cosimo Sync, la URL de sitio web de la aplicación registrada por el servidor de sincronización y el intercambio breve de autenticación; no ve tu token portador de Cosimo ni tus mazos.

`Mazo -> Sincronizar -> Cerrar sesión` borra la identidad de sincronización y el token portador de Cosimo guardados en esta instalación de Cosimo y pide al servidor que revoque el token portador de Cosimo cuando el servidor está disponible; no elimina mazos remotos ni registros locales de revisión.

`Estado de sincronización` empieza por las acciones disponibles, como si la subida o descarga con historial está disponible. Después muestra la copia remota, si existe, y los datos útiles para decidir qué hacer: visibilidad, propietario, historial de estudio, último dispositivo que subió el mazo y cuotas del servidor. Los datos opacos, como UUID, revisión remota y hashes de paquetes, aparecen más tarde como detalles técnicos para resolver problemas o compartir identificadores.

`Mazos remotos` abre una lista seleccionable de mazos encontrados en el servidor configurado. Si el servidor tiene resumen del mazo, la lista y los detalles empiezan por información legible: título o nombre de archivo, número de cartas, audio, formatos, visibilidad, propietario, disponibilidad de historial de estudio y último dispositivo que lo subió. UUID, revisiones y hashes aparecen al final como detalles técnicos. `Copiar ID` copia el UUID del mazo seleccionado, y `Buscar por ID` permite pegar un UUID o URL de mazo compartido para encontrar un mazo público o no listado. `Subir con historial de estudio` sube el mazo, el directorio auxiliar y la base de datos de repaso. `Descargar con historial de estudio` restaura la instantánea para el mismo UUID de mazo y cuenta iniciada, escribiendo una copia completa comprimida antes de sustituir archivos de mazo existentes. Subir y descargar puede tardar si el mazo contiene audio, por lo que Cosimo muestra un diálogo de progreso mientras la transferencia y la restauración se ejecutan fuera del hilo principal de la interfaz. Esto es sincronización por instantáneas, no mezcla: si dos equipos cambian el mismo mazo de manera independiente, Cosimo detecta conflictos de revisión en lugar de combinar los cambios. Si un equipo recién configurado indica un conflicto al subir porque el mazo remoto ya tiene una revisión, descarga primero el mazo sincronizado; eso registra la revisión remota localmente y permite comprobar las subidas posteriores contra el estado remoto actual.

Cada mazo sincronizado tiene además un UUID. Si el servidor ya tiene ese UUID bajo otra cuenta autenticada, Cosimo rechaza la subida en lugar de apropiarse del mazo remoto. Si esto ocurre porque has descargado un mazo público o no listado de otra persona y quieres mantener tu propia copia sincronizada, usa `Mazo -> Editar metadatos del mazo -> Hacer copia independiente` y guarda. Cosimo asigna un nuevo UUID de mazo, restablece la visibilidad a privado, conserva las cartas, el audio y el historial de estudio local, y olvida el estado local de sincronización del UUID anterior.

## Mantenimiento de base de datos y copias

Usa `Herramientas -> Depurar base de datos de repaso` para eliminar permanentemente filas inactivas de la base de datos de repaso correspondientes a cartas que ya no están en el mazo actual y a cartas inversas generadas inactivas. Se conservan las cartas activas, las cartas inversas generadas activas, las programaciones actuales, las suspensiones actuales y las marcas actuales. Las marcas de carta no reversible se guardan en el archivo del mazo, no en la base de datos de repaso. Si las copias de la base de datos de repaso están desactivadas, Cosimo avisa de que la depuración es irreversible. Si las copias están activadas, Cosimo actualiza la copia retenida antes de depurar y avisa de que la copia retenida se sobrescribirá. Después de eliminar las filas inactivas, Cosimo compacta la base de datos para que el archivo SQLite pueda recuperar espacio no usado.

Usa `Herramientas -> Recuperar espacio de base de datos` para ejecutar la misma compactación SQLite sin eliminar datos de repaso inactivos. Esto reescribe el archivo de base de datos de repaso y puede tardar en una base de datos grande. Si las copias de la base de datos de repaso están activadas, esta orden no sobrescribe la copia retenida; si están desactivadas, Cosimo te recuerda que compruebes que tienes una copia si te preocupa.

Usa `Herramientas -> Opciones -> Eliminar copias antiguas` para conservar solo la copia automática más reciente de cada ruta de mazo original. Cosimo pide confirmación antes de eliminar o renumerar archivos de copia.

Usa `Herramientas -> Borrar directorio de copias` solo cuando quieras vaciar deliberadamente el directorio `backups` de la aplicación. Cosimo avisa antes de hacerlo porque la orden elimina todos los archivos y carpetas de ese directorio, incluidos archivos que quizá no hayan sido generados ni registrados por Cosimo. La orden conserva el directorio `backups`, pero Cosimo no puede recuperar su contenido después de eliminarlo.

Para ayuda paso a paso sobre recuperación, consulta Solución de problemas.

## Accesibilidad

Cosimo está diseñado para usarse con teclado y lector de pantalla. La mayoría de acciones de estudio pueden completarse sin abrir menús:

- las teclas numéricas `1` a `4` eligen valoraciones de confianza antes de la respuesta y valoraciones de recuerdo después de la respuesta
- la tecla Espacio muestra la respuesta sin registrar una valoración de confianza
- `0` termina antes de tiempo una sesión normal de estudio
- `e` edita la carta actual después de revelar la respuesta
- `Ctrl+D` aplaza la carta actual antes de revelar la respuesta
- `Ctrl+F` marca o desmarca la carta actual
- `Ctrl+P` reproduce o detiene el audio de carta disponible

La pantalla inicial también tiene órdenes directas de teclado para acciones comunes:

- `Alt-M` comienza la sesión programada
- `Alt-F` fuerza el comienzo con cartas disponibles
- `Alt-X` comienza un examen
- `Alt-Z` comienza un cuestionario
- `Ctrl+L` abre el panel de aprendizaje
- `Alt+Enter` abre detalles de la carta seleccionada

El audio de repaso puede usarse manual o automáticamente. Cuando el audio automático durante el estudio está activado, los tonos guía opcionales dan señales sin voz: un tono corto antes del audio de pregunta, dos tonos cortos antes del audio de respuesta y un arpegio de tres notas cuando se muestra el resumen del repaso. Los exámenes cronometrados también usan tonos para marcar el progreso del tiempo y los agotamientos de tiempo.

El panel de aprendizaje está dividido en secciones de solo lectura separadas para que los usuarios de lector de pantalla puedan tabular entre resumen, distribución, carga de trabajo, diagnósticos y actividad en vez de leer un solo campo largo. El panel también tiene botones `Guardar informe` y `Copiar al portapapeles` para revisar el informe completo fuera del diálogo.

La barra de estado principal informa del estado del mazo y del tiempo de repaso con expresiones breves y cómodas para síntesis de voz. Las fechas programadas en los detalles de carta incluyen duraciones relativas antes de las fechas y horas UTC exactas, porque los tiempos relativos son más fáciles de entender con voz.

Problema conocido: cuando entras en la lista de preguntas con Tab o Shift+Tab, algunas combinaciones de lector de pantalla y wxWidgets anuncian el elemento seleccionado dos veces. Una vez dentro de la lista, la navegación con flechas debería funcionar normalmente.

## Opciones e idiomas

La mayoría de ajustes de la aplicación están en `Herramientas -> Opciones`. Los metadatos propios del mazo, como título, voces, protección de audio manual y visibilidad de sincronización, están en `Mazo -> Editar metadatos del mazo`.

Usa `Idioma` para elegir inglés, español o gallego. El idioma elegido se guarda y se usa la próxima vez. Si todavía no se ha guardado ningún idioma, Cosimo usa español cuando la configuración regional del sistema es española, gallego cuando es gallega, y en caso contrario usa inglés. Las configuraciones regionales desconocidas también usan inglés.

`Mínimo de cartas por sesión` controla cuántas cartas intenta incluir Cosimo cuando eliges `Comenzar`. Es un mínimo, no un máximo: si hay más cartas pendientes, se incluyen todas. Si hay menos, Cosimo rellena desde otras cartas disponibles hasta alcanzar el mínimo.

`Copias del mazo`, `Copias de la base de datos de repaso` y `Copias completas automáticas` controlan los tres sistemas de copia descritos en Archivos, copias de seguridad y mantenimiento.

Las notificaciones sonoras pueden configurarse como `Siempre`, `Cuando Cosimo esté visible`, `Cuando Cosimo esté en el área de notificación` o `Nunca`. Cuando la política elegida permite sonido, Cosimo reproduce un sonido breve si la actualización temporizada de la pantalla inicial detecta que hay repasos disponibles, o que hay más repasos disponibles desde la última actualización automática. Los cambios provocados por el usuario, como añadir o eliminar cartas, y las actualizaciones manuales con `F5` no reproducen este sonido. Cosimo también permanece en silencio mientras hay una sesión de estudio activa, aunque pasen a estar pendientes más cartas durante esa sesión.

`Audio durante el estudio` controla sesiones de estudio programadas, forzadas y con cartas marcadas:

- `Sin audio`: Cosimo ignora el audio de las cartas durante el estudio normal.
- `Manual`: Cosimo indica que hay audio y permite reproducirlo con `Ctrl+P` o el botón `Reproducir/detener audio`.
- `Automático`: Cosimo reproduce el audio de la pregunta al aparecer la pregunta y el audio de la respuesta al aparecer la respuesta. `Ctrl+P` o el botón de audio pueden detener o repetir la reproducción.

`Tonos guía para el audio automático` añade señales no habladas cuando el audio del estudio normal está en automático: un tono de 200 ms antes del audio de la pregunta, dos tonos de 100 ms antes del audio de la respuesta, y un arpegio ascendente de tres notas antes del resumen de estudio. El mismo ajuste activa también tonos de acierto/error durante la revisión de respuestas de cuestionarios: dos tonos ascendentes para una respuesta correcta y dos tonos descendentes para una incorrecta. Los tonos de progreso, fin de tiempo y fin de examen son señales propias del examen temporizado y no dependen de esta casilla.

`Formato de generación de audio` controla el audio nuevo generado por `voice.exe` y `Herramientas -> Generar audio`. `Opus` es el valor predeterminado y normalmente ocupa mucho menos espacio. `WAV` sigue disponible por compatibilidad y para audio generado sin compresión.

`Reproducir audio automáticamente durante la corrección y revisión de examen` solo controla la fase posterior a responder en exámenes. `Sin audio automático` deja esa fase en silencio salvo que pulses `Ctrl+P`. `Pregunta`, `Respuesta` y `Ambas` reproducen la pregunta, la respuesta esperada o ambas. Durante la corrección o revisión de examen, `Ctrl+P` siempre reproduce la pregunta seguida de la respuesta esperada si esos archivos existen.

`Reproducir audio automáticamente durante cuestionarios` controla las preguntas y la revisión de respuestas de cuestionarios. `Sin audio automático` deja el cuestionario en silencio salvo por `Ctrl+P` manual durante la revisión. `Pregunta` reproduce la pregunta al aparecer cada pregunta. `Opciones` reproduce el audio de una opción de respuesta cuando se selecciona y lo detiene cuando se mueve el foco o cambia la selección. `Ambas` combina ambos comportamientos. Durante la revisión de respuestas, `Pregunta`, `Opciones` y `Ambas` controlan la reproducción automática de pregunta y respuesta correcta; `Ctrl+P` reproduce la pregunta seguida de la respuesta correcta si esos archivos existen.

`Regla de recuerdo para la calibración` cambia cómo el panel de aprendizaje y los diagnósticos de confianza deciden si una respuesta contó como recordada. `Flexible` cuenta `Difícil`, `Bien` y `Fácil` como recordadas. `Estricto` cuenta solo `Bien` y `Fácil`. La programación sigue usando la valoración real de recuerdo; esta opción afecta a la interpretación del panel, no al programador.

`URL del servidor de sincronización` es el servidor predeterminado usado por `Mazo -> Sincronizar`. Las instalaciones nuevas usan `https://cosimo.isonomia.net/sync.cgi`, el servidor público del proyecto. Puedes sustituirlo por tu propio servidor. Los servidores desplegados deberían usar normalmente `https://`; las pruebas locales en la misma máquina pueden usar `http://`. Para desactivar la sincronización en esta instalación, borra el campo y guarda las opciones; esto escribe `sync_server_url=none` e impide que Cosimo use el servidor público predeterminado hasta que vuelvas a establecer una URL. `Nombre local del dispositivo` es una etiqueta opcional, como `sobremesa` o `portátil`, mostrada en el estado de sincronización y en los detalles de mazos remotos para reconocer qué instalación subió un mazo por última vez.

Con la minimización al área de notificación activada, usar la acción normal de minimizar la ventana oculta Cosimo en el área de notificación en vez de dejarlo en la barra de tareas. Activar el icono del área de notificación restaura la ventana, y el menú contextual del icono contiene Restaurar y Salir. Cerrar Cosimo sigue saliendo de la aplicación.

Las traducciones se mantienen en archivos `.po` de estilo gettext, con una pequeña cantidad de código de conexión para cada idioma nuevo. Si quieres trabajar en una traducción, contacta primero con David Picón Álvarez en `@modulux@node.isonomia.net` para coordinar el trabajo.

El menú `Ayuda` abre la guía local de usuario, la wiki del proyecto y la página de nuevo ticket para informar de errores. Los informes de errores se gestionan mediante tickets de Fossil en el sitio del proyecto.

## Consejos

- Haz preguntas concretas. Una carta debe preguntar una sola cosa.
- Evita preguntas duplicadas. Hacen ambiguo el mazo; usa el filtro de preguntas duplicadas y `Mazo -> Resolver enunciados duplicados` si una edición manual las crea.
- Mantén las respuestas lo bastante cortas como para poder juzgarlas de forma consistente.
- Las respuestas duplicadas están bien, pero solo una carta de un grupo con la misma respuesta puede tener una carta inversa generada activa.
- Usa `Forzar comienzo` para practicar más, no como sustituto de la sesión programada.
- Si una carta resulta confusa, edítala antes de la siguiente sesión. Si encuentras una errata o una respuesta incorrecta después de mostrar la carta, edítala antes de valorar el recuerdo.
- Usa `0` cuando quieras terminar una sesión antes de tiempo; tus intentos completados se guardan igualmente.

## ¿Por qué se llama Cosimo?

Cosimo recibe su nombre en honor a Cosimo Piovasco di Rondò, el protagonista de la novela El barón rampante, de Italo Calvino. El Cosimo de Calvino es un notorio polímata y políglota, lo que hace que su nombre encaje con una herramienta de estudio.