# 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 WAV cuando un
  mazo tiene metadatos de voz.
- `Archivo -> Exportar mazo completo` y `Archivo -> Copia completa del mazo`
  escriben paquetes comprimidos del mazo para compartirlo o hacer una copia
  manual.
- `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 o hacer
  copias comprimidas, y salir.
- `Mazo` contiene operaciones que afectan al mazo entero, como propiedades,
  metadatos, reversibilidad en bloque y reparación de preguntas duplicadas.
- `Carta` contiene acciones 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. Si una carta fallada se repite al final de la misma sesión, esa
  repetición es otra pregunta.
- 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 de estilo FSRS. 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` se programan con un paso corto de aprendizaje o
reaprendizaje de unos 10 minutos. También aparecen una vez más al final de la
sesión actual. Cuando varias cartas necesitan repetirse, esas repeticiones se
ordenan al azar. Si la repetición vuelve a marcarse como `Repetir`, se registra
normalmente pero no se añade otra vez a la misma sesión.

El intervalo exacto es automático. No necesitas gestionar fechas manualmente.

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. 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 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.

### 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.

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 -> Hacer carta seleccionada reversible`, 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 -> Permitir invertir la carta seleccionada` 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 permitir invertirla de nuevo,
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`.

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.
Ú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 y problemas de asimetría.
Sus recuentos siguen el filtro de texto actual. El filtro de respuestas
duplicadas es especialmente útil antes de hacer cartas reversibles.

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.

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.

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 únicas se han estudiado, sin contar repeticiones
- cuántas preguntas se han respondido en total, incluidas las repeticiones
- tiempo total, tiempo por pregunta y tiempo por carta única
- recuentos y porcentajes de las valoraciones de predicción, incluidas las
  respuestas mostradas sin predicción
- recuentos y porcentajes de las valoraciones de recuerdo

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.

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.

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.

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, la respuesta elegida y la respuesta correcta, y después muestra un
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 textos de respuesta distintos en el mazo
activo, para que cada pregunta pueda tener una respuesta correcta y tres
distractores.

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.

## 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 cartas programadas atrasadas, 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
- 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, 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

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 sin programación
y cartas programadas cuya hora de repaso ya ha llegado. `Cartas programadas
atrasadas` es un subconjunto más estrecho de ese número: cartas programadas no
suspendidas ni aplazadas cuya hora pendiente ya está en el pasado. No incluye
cartas nuevas sin programación. 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 si las cartas falladas se repetirán durante una sesión futura.

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 respondiste
`Repetir`. `Éxitos 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.

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 al reaprendizaje. 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.

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. `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. 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.

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
WAV existentes 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 esos WAV a partir de voces
de síntesis instaladas.

La reproducción de audio de repaso es opcional y por ahora solo admite archivos
WAV. Configúrala en `Herramientas -> Opciones -> Audio durante los repasos`:

- `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 de repaso` 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.

`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.

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.wav` para el lado de pregunta y
`Indonesian/1.response.wav` para el lado de respuesta. Las cartas inversas
generadas reutilizan los archivos de la carta principal con pregunta y
respuesta intercambiadas. La herramienta de generación de audio puede escribir
y sobrescribir archivos en ese directorio, así que conserva copias separadas de
cualquier grabación que hayas creado tú.

Las copias automáticas del mazo y de la base de datos de repaso no incluyen
archivos de audio junto al mazo. Si grabas o editas tus propios WAV, haz copia
del directorio de audio antes de usar `Herramientas -> Generar audio` o
`voice --overwrite`.

Los paquetes de Windows también incluyen `voice.exe`, una herramienta auxiliar
para generar esos WAV 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/`:

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

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`. La opción del menú no sobrescribe audio existente salvo que el
manifiesto indique que ha cambiado el texto de carta generado, la voz
seleccionada o el motor seleccionado. Si todavía no existe manifiesto, los WAV
existentes que coincidan se regeneran una vez para que el nuevo manifiesto
refleje el texto actual de la carta, la voz seleccionada y el motor
seleccionado. Si ya existe un manifiesto pero un archivo de audio individual no
tiene entrada, ese archivo no se toca y se añade al manifiesto para que puedan
detectarse cambios posteriores en el texto de la carta, la voz o el motor. Al
terminar, Cosimo informa del número de cartas para las que se generó audio,
cuántos archivos de audio eran nuevos, cuántos se regeneraron porque cambió el
texto de la carta, la voz o el motor, cuántos archivos no registrados se
regeneraron para iniciar un manifiesto ausente, cuántos archivos existentes se
añadieron al manifiesto y cuántos archivos se omitieron.

Esta política de regeneración está pensada para audio producido por
`voice.exe`. Si grabaste o editaste manualmente un archivo cuyo nombre coincide
con un lado de una carta seleccionada, una edición posterior del mazo o un
cambio de voz o motor puede hacer que `Herramientas -> Generar audio`
sobrescriba esa grabación. Usa primero `--dry-run` si tienes dudas, y conserva
tu propia copia de las grabaciones antes de generar audio. 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, y para regenerar archivos
cuando alguno de ellos ha cambiado. Los archivos de audio existentes sin
entrada en el manifiesto se regeneran si no hay ningún manifiesto; si ya existe
un manifiesto, se dejan intactos en la ejecución actual pero se añaden al
manifiesto para que se puedan detectar cambios futuros. Usa `--overwrite` si
quieres actualizar todos los archivos seleccionados inmediatamente. `--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.

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 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 mazo y de la base de datos de
repaso no contienen audio junto al mazo; restaura el audio desde tu propia
copia del directorio de audio.

`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.

El soporte para estos paquetes comprimidos es preliminar. Cosimo puede
escribirlos, pero todavía no tiene una orden de restauración dentro de la
aplicación. Para restaurar uno manualmente, cierra Cosimo, abre el archivo zip
con la herramienta de archivos comprimidos de tu sistema operativo y extrae su
contenido en el directorio `decks` de Cosimo, permitiendo sobrescribir archivos
solo si realmente quieres reemplazar el mazo actual. Restaurar un paquete puede
causar pérdida de datos si sobrescribe un archivo `.cosimo-deck` más reciente,
un directorio auxiliar de audio, `audio-manifest.tsv` o una base de datos de
repaso `.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.

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.

Para ayuda paso a paso sobre recuperación, consulta
[Solución de problemas](troubleshooting-es.md).

## 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 de repaso 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

Configura el mínimo de cartas por sesión en `Herramientas -> Opciones`. El
diálogo de opciones también puede configurar sonidos de disponibilidad de
repasos, audio de repaso, tonos guía, audio de corrección/revisión de examen,
la regla de recuerdo usada por la calibración del panel de aprendizaje, copias
del mazo y de la base de datos de repaso, idioma y minimización al área de
notificación.

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.

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.

Cosimo admite actualmente inglés, español y gallego. Cambia el idioma en
`Herramientas -> Opciones`. 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.

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.
