# Guía de usuario de Cosimo

Cosimo axúdache a estudar pares de pregunta e resposta con repetición espazada. Está deseñado para usarse con teclado e lector de pantalla.

## Inicio rápido

Cosimo é unha aplicación portable. Para instalalo, descomprime o ficheiro zip da versión publicada no cartafol desde o que queiras executar Cosimo e despois inicia `cosimo.exe` desde ese cartafol. Para actualizar, pecha Cosimo, descomprime o novo zip sobre o cartafol existente de Cosimo e permite que se sobrescriban os ficheiros da aplicación. Os paquetes publicados non deberían sobrescribir datos de usuario como `cosimo.ini`, mazos persoais, bases de datos de repaso, informes, directorios de audio xunto ao mazo ou copias de seguridade.

Cando Cosimo se inicia, abre o último mazo usado. Nunha instalación nova, normalmente é `decks/deck.cosimo-deck`, xunto ao executable. Usa `Arquivo -> Abrir mazo` para abrir outro ficheiro `.cosimo-deck`. Se o ficheiro de mazo non existe, Cosimo pregunta se queres crealo.

Para engadir material, usa `Carta -> Engadir carta` para unha soa carta, ou `Carta -> Engadir cartas en bloque` para introducir varias seguidas. Unha carta ten unha pregunta, que é a cuestión ou pista que ves primeiro, e unha resposta, que é a solución coa que te comprobas. Mantén preguntas concretas e evita preguntas duplicadas.

A pantalla inicial mostra un resumo, unha lista de preguntas de cartas e unha barra de estado. A barra de estado indica as cartas totais, as cartas dispoñibles agora, e se hai unha sesión programada pendente ou canto falta aproximadamente para a próxima. A pantalla inicial actualízase aproximadamente unha vez por minuto. Preme `F5` para actualizala manualmente.

Usa `Comezar` para executar a sesión programada. Durante unha sesión normal de estudo, Cosimo mostra primeiro a pregunta. Podes valorar a túa predición:

- `1`: non o sei
- `2`: probablemente non o sei
- `3`: probablemente o sei
- `4`: seguro que o sei

Tamén podes escoller `Mostrar resposta`, ou premer Espazo, para mostrar a resposta sen rexistrar unha predición. Despois de mostrar a resposta, escolle a valoración de recordo:

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

A valoración de recordo é o que Cosimo usa de forma máis directa para programar a carta. Preme `0` durante unha sesión normal de estudo para rematala antes de tempo. Os intentos completados gárdanse igualmente.

Usa `Forzar comezo` para practicar máis cando queiras ignorar a programación. Usa `Estudar marcadas` para cartas que marcases para atención manual. Usa `Comezar exame` para unha proba con respostas escritas a partir dunha mostra aleatoria, e `Comezar cuestionario` para practicar con respostas de opción múltiple. As sesións de exame e cuestionario son só informativas: non cambian a programación de repetición espazada.

Despois de estudar, Cosimo mostra un resumo. Escolle `Gardar informe` para escribir un informe de texto no directorio `reports`, ou `Continuar` para volver á pantalla inicial.

Outras funcións útiles:

- `Estudo -> Panel de aprendizaxe` ou `Ctrl+L` mostra progreso, calibración, carga de traballo e información diagnóstica de todo o mazo.
- `Ferramentas -> Opcións` configura idioma, mínimo de cartas por sesión, copias de seguridade, audio de repaso, notificacións, minimización á área de notificación e calibración do panel.
- `Ferramentas -> Xerar audio` pode crear audio de repaso en WAV cando un mazo ten metadatos de voz.
- `Arquivo -> Exportar mazo completo`, `Arquivo -> Copia de seguridade completa do mazo` e `Arquivo -> Restaurar mazo completo` xestionan paquetes comprimidos do mazo para compartilo, migralo ou facer unha copia manual.
- `Axuda -> Guía de usuario`, `Axuda -> Wiki do proxecto` e `Axuda -> Informar dun erro` abren recursos locais ou do proxecto.

## Organización dos menús

Cosimo agrupa as ordes segundo aquilo sobre o que actúan:

- `Arquivo` serve para abrir mazos, acceder a mazos recentes, exportar, facer copias ou restaurar paquetes comprimidos, e saír.
- `Mazo` contén operacións que afectan ao mazo enteiro, como propiedades, metadatos, reversibilidade en bloque e reparación de preguntas duplicadas.
- `Carta` contén accións e detalles sobre a carta seleccionada ou a carta actual durante unha sesión de estudo.
- `Estudo` serve para iniciar sesións de estudo, estudar cartas marcadas, facer exames e abrir o panel de aprendizaxe.
- `Ferramentas` contén opcións da aplicación, xeración de audio e mantemento da base de datos de repaso.
- `Ver` controla como se ordena a lista inicial.
- `Axuda` abre a guía, ligazóns do proxecto e o diálogo Sobre.

## Como estuda cartas Cosimo

A repetición espazada é un método de estudo baseado en repasar o material a intervalos crecentes. Cando algo é novo, difícil ou se fallou recentemente, debería volver pronto. Cando algo é fácil e se recorda de forma consistente, pode esperar máis. O obxectivo é dedicar máis tempo ao material que precisa atención e menos a repetir o que xa está seguro.

Cosimo rexistra as túas respostas e valoracións, e usa ese historial para decidir que cartas están pendentes.

Cosimo usa algúns termos de forma específica:

- Unha `carta` é un par de pregunta e resposta dentro do mazo.
- Un `elemento de estudo` é unha dirección programable dunha carta. Unha carta normal ten un elemento de estudo; unha carta inversa xerada engade outro con pregunta e resposta intercambiadas.
- Unha `sesión de estudo` é un percorrido desde Comezar, Forzar comezo ou Estudar marcadas ata o resumo.
- Unha `pregunta` é unha presentación dunha pregunta durante unha sesión de estudo.
- Un `intento` é unha resposta almacenada con valoración do recordo e, se se indicou, unha estimación de confianza previa a revelar a resposta.

Cosimo conserva expresións como `base de datos de repaso`, `historial de repaso`, `repaso programado` e `audio de repaso` para partes establecidas da aplicación. Nesas expresións, repaso refírese ao proceso máis amplo de repetición espazada ou ao historial de estudo almacenado, non necesariamente a unha sesión enteira.

Cosimo garda cada intento completado na base de datos de repaso. Para cada carta, consulta o historial de repaso e estima cando debe volver a carta.

En xeral:

- as cartas sen historial de repaso están pendentes inmediatamente
- as cartas falladas ou incorrectas volven antes
- as respostas marcadas como `Difícil` avanzan con máis cautela que as marcadas como `Ben` ou `Fácil`
- as cartas que se recordan con facilidade esperan máis tempo

Cosimo usa un algoritmo de programación FSRS-6. Segue a dificultade e a estabilidade de cada carta. As respostas correctas repetidas fan que a carta sexa máis estable e alongan o intervalo, mentres que as respostas falladas ou incorrectas devolven a carta cara á aprendizaxe. As cartas marcadas como `Repetir` usan pasos curtos automáticos: as cartas novas normalmente usan pasos de aprendizaxe de 1 minuto e 10 minutos, e as cartas en estado de repaso marcadas como `Repetir` usan un paso de reaprendizaxe de 10 minutos. As cartas marcadas como `Repetir` non se repiten automaticamente ao final da sesión actual; Cosimo espera ata que venza o paso de aprendizaxe ou reaprendizaxe programado.

Os catro botóns de recordo teñen as mesmas etiquetas en todos os estados, pero o seu efecto de programación depende de se o elemento de estudo é novo, está en aprendizaxe, en repaso, ou en reaprendizaxe:

- `Repetir` significa que non recordaches a resposta o bastante ben. Nunha carta nova ou en aprendizaxe, mantén a carta en aprendizaxe e reinicia o primeiro paso curto de aprendizaxe. Nunha carta en estado de repaso, é unha recaída: a carta pasa a reaprendizaxe e vence despois do paso curto de reaprendizaxe. Nunha carta que xa está en reaprendizaxe, mantena en reaprendizaxe sen contar outra recaída.
- `Difícil` significa que recordaches a resposta, pero con dificultade. Nunha carta en aprendizaxe ou reaprendizaxe, mantén a carta nese estado de pasos curtos en vez de graduala inmediatamente. Nunha carta en estado de repaso, segue sendo un recordo correcto, pero programa un intervalo máis prudente que `Ben` ou `Fácil`.
- `Ben` significa que recordaches a resposta de forma aceptable. Nunha carta en aprendizaxe, pasa ao seguinte paso de aprendizaxe, ou gradúa a carta ao estado de repaso se os pasos de aprendizaxe se completaron. Nunha carta en reaprendizaxe, devolve a carta ao estado de repaso. Nunha carta en estado de repaso, programa o seguinte intervalo normal.
- `Fácil` significa que recordaches a resposta con facilidade. Nunha carta nova, en aprendizaxe, ou en reaprendizaxe, gradúa directamente a carta ao estado de repaso. Nunha carta en estado de repaso, programa un intervalo máis longo que `Ben`.

Os mazos estudados por primeira vez con versións beta antigas poden conter filas de programación existentes do algoritmo anterior, de estilo FSRS, de Cosimo. Cosimo non reescribe silenciosamente todas esas datas pendentes ao abrir o mazo. Cada carta pasa ao cálculo FSRS-6 actual cando se responde a seguinte vez.

En termos de programación, unha recaída é máis específica que calquera resposta `Repetir`. Significa que unha carta que xa chegara ao estado de repaso se marcou como `Repetir` e pasou a reaprendizaxe. `Repetir` cando unha carta é nova, está en aprendizaxe, ou xa está en reaprendizaxe rexístrase como resposta, pero non engade outra recaída programada.

O intervalo exacto é automático. Non precisas xestionar datas manualmente. Para cartas ordinarias en estado de repaso, Cosimo pode variar lixeiramente e de forma determinista os intervalos máis longos. Isto evita que as cartas volvan agruparse sempre na mesma data futura. Os pasos curtos de aprendizaxe e reaprendizaxe non se varían.

O mínimo de cartas por sesión controla cantas cartas intenta incluír Cosimo cando premes `Comezar`. Por exemplo:

- se o mínimo é `0`, Cosimo inclúe só cartas pendentes
- se o mínimo é `10` e só hai 6 cartas pendentes, Cosimo engade 4 cartas adicionais ao azar
- se hai 20 cartas pendentes e o mínimo é `10`, Cosimo inclúe as 20 cartas pendentes

O mínimo non é un máximo. As cartas pendentes non se ocultan só porque haxa máis que o mínimo.

Cando empeza unha sesión, as cartas pendentes en aprendizaxe e reaprendizaxe aparecen antes que as cartas normais de repaso. Despois veñen as cartas novas. Dentro dos grupos de aprendizaxe/reaprendizaxe e repaso, aparecen primeiro as cartas que levan máis tempo pendentes. As cartas coa mesma data pendente, ou con datas pendentes separadas por aproximadamente unha hora ou menos, ordénanse ao azar dentro dese grupo. As cartas novas tamén se ordenan ao azar, para que as cartas engadidas por grupos temáticos non se repasen na orde do mazo.

As cartas útiles son concretas e non ambiguas. Unha pregunta debería pedir unha soa cousa, e a resposta esperada debería ser o bastante breve como para poder xulgala de forma consistente. Evita preguntas duplicadas: unha pregunta debería identificar unha soa carta. As respostas duplicadas están ben, pero as cartas inversas xeradas esixen coidado adicional porque unha resposta duplicada se convertería nunha pregunta inversa duplicada.

## Cartas e mazos

Un mazo é un ficheiro que contén cartas. Os ficheiros de mazo de Cosimo usan a extensión `.cosimo-deck`.

Podes editar cartas dentro de Cosimo ou editar directamente o ficheiro do mazo nun editor de texto. O ficheiro do mazo garda preguntas, respostas, metadatos do mazo e marcas de cartas, como o estado non reversible. O historial de repaso e as valoracións gárdanse por separado.

Os ficheiros de mazo tamén conteñen un pequeno marcador numerado ao final de cada carta, como `=1=`. Deixa ese número no seu sitio cando edites á man. Permite que Cosimo conserve o historial de repaso da carta aínda que cambies o texto da pregunta ou da resposta. Se engades cartas novas á man, remata cada carta nova con `===` no canto de inventar un marcador numerado. Cosimo escollerá un ID seguro e sen usar a próxima vez que abra o mazo. Usa `=i=` no canto de `===` para unha carta engadida á man que non deba ser reversible. Cosimo tamén pode escribir `next_card_id` nos metadatos do mazo; déixao no seu sitio, porque evita que as cartas novas reutilicen IDs antigos despois dunha limpeza. Cando Cosimo abre un mazo antigo, garda unha copia de seguridade do orixinal segundo a configuración de copias do mazo e actualiza o ficheiro ao formato actual.

Usa `Mazo -> Propiedades do mazo` para ver a versión do formato do mazo e os campos opcionais de metadatos, como título, autor, descrición, URL, voces escollidas e se a xeración automática de audio está desactivada. Usa `Mazo -> Editar metadatos do mazo` para editar eses campos de metadatos.

O mazo predeterminado é `decks/deck.cosimo-deck`, xunto ao executable de Cosimo. En instalacións portables de Windows, garda os teus mazos no cartafol `decks` xunto á aplicación. Se falta o mazo predeterminado, Cosimo crea un baleiro. Podes abrir outro mazo desde `Arquivo -> Abrir mazo`. Se escolles un ficheiro de mazo que non existe, Cosimo pregunta se queres crear alí un mazo baleiro.

Cando Cosimo se pecha, recorda o último mazo aberto e volve abrilo a próxima vez. Tamén conserva ata oito mazos abertos recentemente en `Arquivo -> Mazos recentes`, omitindo o mazo actual. Se só hai outro mazo recente, Cosimo móstrao directamente no menú `Arquivo`, sen colocalo nun submenú. Garda esta e outras opcións da aplicación en `cosimo.ini`, xunto ao executable. Cosimo tamén recorda o filtro e o modo de ordenación da lista inicial. Se atopa ficheiros antigos `cosimo-settings.txt` ou `cosimo-last-open-deck.txt`, mígraos a `cosimo.ini` e elimina os ficheiros antigos.

### Engadir e editar cartas

Usa `Carta -> Engadir carta` para engadir unha carta. O editor ten campos de pregunta e resposta. Tamén ten unha caixa `Marcar como non reversible`. Déixaa sen marcar para unha carta normal; márcaa cando a carta non deba usarse nunca para xerar unha carta inversa.

Para introducir varias cartas seguidas, usa `Carta -> Engadir cartas en bloque`. Escribe a pregunta e a resposta, e preme `Ctrl+Enter` desde calquera dos dous campos para engadir a carta e volver ao campo de pregunta. Ao premer Tab desde o campo de resposta tamén se engade a carta e vólvese ao campo de pregunta cando ambos campos conteñen texto. Preme Escape para pechar o diálogo de entrada en bloque. A entrada en bloque non mostra a caixa de carta non reversible, para manter breve o fluxo de entrada repetida.

Usa `Carta -> Editar carta seleccionada` para editar a carta seleccionada desde a lista inicial. Despois de revelar unha carta durante unha sesión de estudo, esta orde cambia a `Carta -> Editar carta actual`. Tamén podes escoller `Editar carta` ou premer `e` nese momento. Cosimo abre o mesmo editor que se usa no resto da aplicación, garda o texto da carta e volve ao paso de valoración posterior á resposta. A decisión de programación tómase só despois de escoller a valoración de recordo.

Usa `Delete` ou `Carta -> Eliminar carta seleccionada` para eliminar a carta seleccionada do mazo. Eliminar unha carta principal tamén elimina a súa carta inversa xerada da lista de preguntas, porque a carta inversa deriva da carta principal. Os datos de repaso da carta inversa permanecen na base de datos, pero só volven ser útiles se restauras unha copia de seguridade do mazo que conteña a carta principal orixinal.

Usa `Alt+Enter`, `Carta -> Detalles da carta` ou o menú contextual da lista de preguntas para mostrar detalles e estatísticas da carta seleccionada.

### Preguntas e respostas duplicadas

Evita preguntas duplicadas. Unha pregunta debería identificar unha soa carta. Cosimo rexeita as accións normais de engadir e editar que crearían unha pregunta duplicada. Se editas un mazo á man e introduces preguntas duplicadas, Cosimo abre o mazo cun aviso. Usa o filtro `Preguntas duplicadas` para atopalas, ou usa `Mazo -> Resolver enunciados duplicados` para escoller a resposta que se conservará para cada pregunta duplicada; as outras cartas con esa pregunta elimínanse do mazo, e os seus datos de repaso quedan inactivos salvo que se limpe a base de datos de repaso. Durante a resolución de duplicados, `Saltar enunciado` deixa a pregunta duplicada actual sen cambios e continúa con preguntas duplicadas posteriores. `Cancelar resolución` detén o proceso por completo. As preguntas xa resoltas permanecen cambiadas.

As respostas duplicadas si están permitidas. A miúdo son útiles cando distintas preguntas comparten a mesma resposta. A restrición só afecta ás cartas inversas xeradas: de cada grupo de cartas coa mesma resposta, como máximo unha carta pode ter unha carta inversa xerada activa. Se houbese máis dunha, as cartas inversas xeradas terían a mesma pregunta e xa non estaría claro que carta orixinal se está preguntando. Cosimo impide crear ou editar cartas inversas cando iso produciría esa ambigüidade. Marca unha carta como non reversible se a súa resposta compartida non debería usarse nunca como pregunta inversa.

### Cartas reversibles e non reversibles

Usa `Carta -> Engadir carta inversa`, ou preme `Ctrl+R` cando a lista de preguntas teña o foco, para engadir unha carta inversa xerada. Unha carta inversa pregunta pola resposta orixinal e espera a pregunta orixinal. As cartas inversas teñen o seu propio estado de programación e historial de repasos. Cosimo impide facer reversible unha carta cando outra carta coa mesma resposta xa ten unha carta inversa xerada activa, porque a pregunta inversa sería ambigua. As cartas inversas márcanse con `(inversa)` na lista de preguntas e poden atoparse co filtro `Cartas inversas`. Eliminar unha carta inversa elimina só a dirección inversa xerada; non elimina a carta principal. Os datos de repaso da carta inversa permanecen na base de datos e volven usarse se fas reversible de novo a carta principal. Cando unha carta inversa xerada está seleccionada, o menú de cartas e o menú contextual ofrecen eliminar esa dirección inversa, non marcar a carta principal como non reversible.

Usa `Carta -> Marcar carta seleccionada como non reversible` cando unha carta non deba ter dirección inversa xerada. Isto escribe unha marca no ficheiro do mazo, elimina calquera carta inversa xerada activa desa carta principal e impide que `Facer cartas aptas reversibles` a volva engadir máis adiante. Usa `Carta -> Retirar marca de carta non reversible` para quitar esa marca. A carta volve ser apta para inversión manual ou en bloque, sempre que a súa resposta non estea xa usada por outra carta inversa xerada activa. As cartas non reversibles aparecen con `(non reversible)` na lista de preguntas, poden atoparse co filtro `Cartas non reversibles`, e mostran a marca non reversible na liña de estado de detalles da carta. Cando unha carta non reversible está seleccionada, os menús ofrecen retirar a marca de carta non reversible, non crear unha carta inversa directamente.

Usa `Mazo -> Facer cartas aptas reversibles` para marcar como reversibles nunha soa operación todas as cartas que poidan selo. Cosimo pide confirmación e indica cantas cartas poden cambiarse. Exclúense as cartas que xa son reversibles, as cartas marcadas como non reversibles e as cartas cuxo grupo de respostas xa ten unha carta inversa xerada activa. Se as copias da base de datos de repaso están activadas, esta operación actualiza a copia retida antes de escribir e a confirmación avisa de que esa copia retida se sobrescribirá.

Usa `Mazo -> Desfacer última reversión en bloque` para eliminar só as cartas inversas creadas pola última reversión en bloque. Consérvanse as cartas inversas creadas manualmente e os lotes anteriores. As cartas principais e o historial de repaso inverso permanecen na base de datos.

### Suspender, adiar e marcar cartas

Usa `Carta -> Suspender carta seleccionada`, o menú contextual da lista de preguntas, ou `Ctrl+S` cando a lista de preguntas teña o foco, para conservar a carta no mazo pero impedir que apareza en sesións normais ou forzadas. A lista de preguntas marca as cartas suspendidas con `(suspendida)`. As cartas suspendidas poden atoparse co filtro `Cartas suspendidas` e reactivarse desde o mesmo menú, menú contextual ou atallo. As cartas suspendidas tamén se ignoran cando a barra de estado indica se hai un repaso pendente agora ou cando será o próximo repaso.

Usa `Carta -> Adiar carta seleccionada ata mañá`, ou o menú contextual da lista de preguntas, para pospoñer temporalmente a carta seleccionada sen cambiar a súa programación almacenada. Unha carta adiada permanece no mazo e volve automaticamente cando caduca o adiamento. Mentres está adiada, aparece con `(adiada)`, móstrase no filtro `Cartas adiadas` e queda excluída de sesións programadas, sesións forzadas, recontos da pantalla inicial e cálculos de pendentes na barra de estado. Usa `Carta -> Quitar adiamento da carta seleccionada`, ou o menú contextual, para facela dispoñible de novo inmediatamente.

Durante unha sesión de estudo, antes de mostrar a resposta, usa `Ctrl+D` ou o botón `Adiar carta ata mañá` para pospoñer a carta actual e continuar. O adiamento non está dispoñible despois de mostrar a resposta. Se todas as cartas da sesión se adían antes de rexistrar ningunha resposta, Cosimo mostra un aviso indicando que non se estudou ningunha carta.

Usa `Carta -> Marcar carta seleccionada`, o menú contextual da lista de preguntas, ou `Ctrl+F` cando a lista de preguntas teña o foco para marcar ou desmarcar a carta seleccionada. Durante unha sesión de estudo, `Ctrl+F` marca ou desmarca a carta actual. A pantalla de estudo tamén ten un botón para marcar ou desmarcar en ambas fases, despois dos botóns de valoración correspondentes. Marcar serve para seguimento manual: úsao cando unha carta poida necesitar edición, resulte confusa ou ambigua, teña unha resposta dubidosa ou requira atención despois da sesión. Marcar unha carta non afecta á programación nin a se a carta aparece no estudo normal. As cartas marcadas aparecen con `(marcada)` na lista de preguntas e poden atoparse co filtro `Cartas marcadas`.

## Pantalla inicial

Cando Cosimo se inicia, ábrese na pantalla inicial. Esta pantalla mostra:

- cantas cartas hai no mazo
- cantas cartas están programadas agora
- o mínimo de cartas por sesión
- o ficheiro de base de datos de repaso
- unha lista de preguntas de cartas

Se o mínimo de cartas por sesión fai que Cosimo engada cartas adicionais que aínda non están pendentes, o reconto de programadas tamén mostra entre parénteses cantas están pendentes. Por exemplo, `Programadas agora: 10 (6 pendentes)` significa que a sesión incluiría 6 cartas pendentes e 4 cartas adicionais para chegar ao mínimo.

A barra de estado da xanela principal dá un resumo breve: cartas totais, cartas pendentes agora, e se hai un repaso pendente agora ou canto falta aproximadamente para o próximo repaso programado. As duracións redondéanse cara arriba a unidades cómodas para síntese de voz, como `2 días`, `4 semanas` ou `3 meses`. Durante unha sesión, a barra de estado cambia ao contexto da sesión, como sesión de estudo programada, sesión de estudo non programada, exame ou cuestionario, co progreso actual.

Mentres a pantalla inicial está aberta, Cosimo actualiza o resumo, os filtros da lista e a barra de estado aproximadamente unha vez por minuto. Unha carta que pase a estar pendente mentres a aplicación está aberta quedará dispoñible para `Comezar` sen pechar e volver abrir o mazo.

Teclas útiles na pantalla inicial:

- `Alt-M`: comezar a sesión programada
- `Alt-F`: forzar o comezo con todas as cartas non suspendidas nin adiadas
- `Alt-X`: comezar unha sesión de exame cunha mostra aleatoria de cartas activas
- `Alt-Z`: comezar unha sesión de cuestionario cunha mostra aleatoria de cartas activas
- `Alt-L`: ir ao filtro de texto da lista de preguntas
- `F5`: actualizar o resumo, os filtros de lista e a barra de estado
- `Ctrl+L`: mostrar o panel de aprendizaxe
- `Alt-S`: saír
- `Alt+Enter`: mostrar detalles e estatísticas da carta seleccionada
- `Delete`: eliminar a carta seleccionada da lista de preguntas
- `Ctrl+S`: suspender ou reactivar a carta seleccionada
- `Ctrl+F`: marcar ou desmarcar a carta seleccionada
- `Ctrl+D`: adiar a carta seleccionada ata mañá, ou quitar o seu adiamento
- `Ctrl+R`: facer reversible a carta seleccionada, ou eliminar a carta inversa xerada

Usa `Ver -> Orde do mazo`, `Ver -> Próximo repaso programado`, `Ver -> Último repaso`, `Ver -> Texto da pregunta`, `Ver -> Texto da resposta` ou `Ver -> Recordo estimado` para escoller como se ordena a lista de preguntas. Usa `Ver -> Ascendente` ou `Ver -> Descendente` para escoller a dirección. Os elementos marcados do menú Ver mostran o criterio e a dirección actuais. Cando escolles outro criterio de ordenación, Cosimo restablece a dirección ao valor por defecto dese criterio. Último repaso usa descendente por defecto, poñendo primeiro as cartas estudadas máis recentemente e deixando as cartas novas ao final; último repaso ascendente pon primeiro as cartas estudadas hai máis tempo e tamén deixa as cartas novas ao final. Recordo estimado usa a mesma estimación de programación que o panel de aprendizaxe; recordo estimado ascendente pon primeiro as cartas que se estiman menos probables de lembrar e deixa ao final as cartas sen estimación, como as novas.

O filtro de texto reduce a lista buscando na pregunta ou na resposta. O cadro combinado de filtro controla que tipo de cartas se mostran, incluídas cartas marcadas, preguntas duplicadas, respostas duplicadas, cartas non reversibles, cartas adiadas, cartas problemáticas, problemas de asimetría, fallos con confianza alta e acertos con confianza baixa. Os seus recontos seguen o filtro de texto actual. O filtro de respostas duplicadas é especialmente útil antes de facer cartas reversibles.

O menú Cartas tamén pode actuar sobre as cartas que se mostran actualmente na lista inicial. Usa `Marcar todas as cartas visibles` ou `Desmarcar todas as cartas visibles` para marcar todo un conxunto filtrado para revisión manual, por exemplo todas as cartas problemáticas antes de escoller `Estudar marcadas`. `Suspender todas as cartas visibles` e `Quitar suspensión de todas as cartas visibles` funcionan do mesmo xeito. Cosimo pide confirmación e indica cantas cartas visibles cambiarán realmente; as cartas que xa estean no estado pedido déixanse sen cambios.

O filtro `Cartas problemáticas` mostra elementos de estudo activos que parecen inusualmente difíciles no mazo actual. Espera ata que un elemento teña polo menos 4 intentos, e usa o comportamento de repaso en vez de simplemente a idade da carta. Unha carta pode aparecer aí se polo menos 2 dos seus últimos 5 intentos foron `Repetir`, se a súa taxa vitalicia de `Repetir` está no 20% máis alto do mazo e é polo menos 25%, se os seus lapsos programados por intento están no 20% máis alto do mazo e son polo menos 20%, ou se a súa dificultade de programación está no 20% máis alto do mazo e é polo menos 8 na escala de dificultade FSRS de 1 a 10. As cartas suspendidas e actualmente adiadas non se mostran aí.

O filtro `Problemas de asimetría` é para cartas reversibles. Cando ambas direccións teñen polo menos 4 intentos e unha dirección é substancialmente máis débil, o filtro mostra o elemento de estudo máis débil. Cosimo compara unha taxa de recordo estrita lixeiramente suavizada, onde só `Ben` e `Fácil` contan como recordadas, e considera substancial unha diferenza de 30 puntos porcentuais ou máis. Isto é útil cando, por exemplo, ver unha palabra indonesia e recordar o galego é fácil, pero producir a palabra indonesia desde o galego segue sendo pouco fiable.

Os filtros `Fallos con confianza alta` e `Acertos con confianza baixa` usan intentos recentes con valoración de confianza. `Fallos con confianza alta` mostra elementos de estudo activos onde escolliches recentemente `Probablemente o sei` ou `Seguro que o sei`, pero despois respondiches `Repetir`; abonda co último intento con confianza, ou polo menos 2 dos últimos 5 intentos con confianza. `Acertos con confianza baixa` mostra elementos de estudo activos onde polo menos 2 dos últimos 5 intentos con confianza foron `Non o sei` ou `Probablemente non o sei` seguidos de `Ben` ou `Fácil`. As cartas suspendidas e actualmente adiadas non se mostran en ningún dos dous filtros.

O diálogo de detalles de carta mostra a pregunta, a resposta, o ID de carta, o estado actual da carta, o número de intentos, o último intento, o estado de programación, a dispoñibilidade, o recordo estimado agora, o recordo recente, o resumo de recaídas e o historial de intentos da carta seleccionada. O estado de carta combina nunha soa liña marcas visibles como suspendida, marcada, adiada, inversa, ten inversa e non reversible. A dispoñibilidade explica se unha carta é nova, está programada para máis tarde, está lista para un repaso programado ordinario ou espera un paso de aprendizaxe ou reaprendizaxe. Cando hai unha hora programada, a liña de dispoñibilidade inclúe tanto o tempo relativo como a data e hora UTC exacta.

As cartas inversas xeradas mostran o ID de carta da carta principal, porque editar a carta principal no mazo tamén cambia a súa dirección inversa xerada. Os campos de data do resumo, como último intento e última actualización de programación, móstranse primeiro como duración relativa completa, por exemplo `1 día, 1 hora, 1 minuto, 1 segundo`, seguida da data e hora UTC exacta entre parénteses. As datas pasadas usan a mesma duración relativa completa seguida de `atrás`. A lista de historial de intentos do final usa só datas e horas UTC exactas.

## Sesións de estudo

Hai tres ordes normais de sesión de estudo:

`Comezar` usa a programación. Repasa primeiro as cartas pendentes. Se hai menos cartas pendentes que o mínimo de cartas por sesión configurado, Cosimo engade cartas adicionais ao azar desde o resto do mazo.

`Forzar comezo` ignora a programación. Pon todas as cartas non suspendidas nin adiadas en orde aleatoria. Úsao cando queiras estudar aínda que non haxa cartas pendentes, ou cando queiras unha sesión de práctica máis longa.

`Estudar marcadas` inicia unha sesión non programada só con cartas marcadas. Esta sesión inclúe cartas marcadas estean programadas ou non, pero exclúe as cartas suspendidas ou adiadas. A orde é aleatoria, e a sesión non quita as marcas; quita as marcas manualmente cando esas cartas xa non requiran seguimento. O botón está desactivado cando non hai cartas marcadas dispoñibles para estudar.

Cando se mostra unha pregunta, podes valorar que probabilidade cres que tes de saber a resposta:

- `1`: non o sei
- `2`: probablemente non o sei
- `3`: probablemente o sei
- `4`: seguro que o sei

Esta é a túa predición antes de ver a resposta.

Tamén podes escoller `Mostrar resposta`, ou premer Espazo, para mostrar a resposta sen rexistrar unha predición. Isto gárdase como `Sen responder` no resumo da sesión.

Despois de valorar a túa predición, ou de mostrar directamente a resposta, Cosimo mostra a resposta. Entón valora o que ocorreu realmente:

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

Esta valoración é o que Cosimo usa de forma máis directa para programar a carta. A mesma valoración de recordo pode ter un efecto de programación distinto segundo se a carta aínda está nun paso curto de aprendizaxe ou xa chegou ao estado de repaso ordinario; consulta `Como estuda Cosimo as cartas` para máis detalles.

Se atopas un erro despois de mostrar a resposta, escolle `Editar carta`, usa `Carta -> Editar carta actual`, ou preme `e`. Cosimo abre o mesmo editor que se usa no resto da aplicación, garda o texto da carta e volve ao paso de valoración posterior á resposta. A decisión de programación tómase só despois de escoller a valoración de recordo.

Ao final dunha sesión de estudo, Cosimo mostra un resumo desa sesión:

- cantas cartas se estudaron
- tempo total e tempo por carta
- recontos e porcentaxes das valoracións de predición, incluídas as respostas mostradas sen predición
- recontos e porcentaxes das valoracións de recordo

Se unha sesión antiga, ou un modo de estudo futuro, contén preguntas repetidas para o mesmo elemento de estudo, Cosimo mostra a distinción máis detallada entre cartas únicas, preguntas respondidas, tempo por pregunta e tempo por carta única. Os modos de estudo actuais normais non repiten as cartas valoradas como `Repetir` na mesma sesión. Unha carta e a súa dirección inversa xerada contan como cartas estudadas distintas.

As cartas adiadas antes de mostrar a resposta non contan como preguntas respondidas no resumo da sesión.

Escolle `Gardar informe` para escribir unha copia de texto do resumo dunha sesión normal no directorio `reports`, xunto ao executable. Cosimo crea o directorio se fai falta. Os nomes de informe normais usan o nome do ficheiro do mazo sen a súa extensión e a hora UTC en que rematou a sesión, por exemplo `Indonesian-2026-05-03-06-04.txt`. Se xa existe un informe con ese nome, Cosimo engade un sufixo numérico en vez de sobrescribilo. O texto do informe inclúe a ruta completa do mazo.

Escolle `Continuar` para volver á pantalla inicial.

## Exames e cuestionarios

`Comezar exame` toma unha mostra do mazo activo en vez de usar a programación. As cartas suspendidas e adiadas exclúense. Cosimo pídeche que escollas un número de preguntas ou unha porcentaxe de cartas activas, e despois selecciona e ordena as cartas ao azar para reducir as pistas producidas pola orde do mazo.

Se o mazo ten cartas inversas xeradas, a configuración do exame inclúe unha opción de dirección de estudo: só normal, só inversa ou ambas. Se o mazo non ten cartas inversas xeradas, esta opción queda oculta e o exame usa a dirección normal.

Durante un exame, Cosimo mostra cada pregunta e pídeche que escribas a resposta. Non mostra a corrección mentres o exame está en curso. As respostas exactas contan como correctas automaticamente. Ao final, para cada resposta que non foi unha coincidencia exacta, Cosimo mostra a pregunta, a túa resposta e a resposta esperada, e pregunta se a resposta debe contar como correcta.

Se a caixa `Exacto` está marcada ao comezar o exame, as respostas non exactas non se corrixen manualmente. Contan como incorrectas, e Cosimo mostra cada unha para revisión coa pregunta, a túa resposta e a resposta esperada. Escolle `Seguinte` ou preme `Alt-N` para seguir revisando respostas inexactas, ou escolle `Resumo` para ir directamente ao resumo do exame.

Se a caixa `Exame cronometrado` está marcada, introduce un número enteiro de minutos para o exame. O tempo restante móstrase na barra de estado. Cosimo reproduce un ton moi breve en cada límite do 10% do tempo. Cando se esgota o tempo, calquera texto que estea no campo de resposta envíase, reprodúcense catro tons curtos, e Cosimo mostra un aviso de tempo esgotado co número de respostas enviadas. O aviso empeza coa mensaxe enfocada; usa Tab ata `Seguinte` para continuar á corrección, á revisión de respostas ou ao resumo.

Cando un exame que non se esgotou por tempo remata con polo menos unha resposta enviada, Cosimo reproduce dous tons longos e mostra un aviso de `Exame rematado` antes da corrección, da revisión de respostas ou do resumo. Isto dá ás persoas que dependen do audio do exame un límite claro entre responder preguntas e comprobar respostas.

Durante unha sesión de exame, escolle `Rematar exame` para parar despois das respostas enviadas ata ese momento. Se non se enviou ningunha resposta, Cosimo mostra un aviso.

As sesións de exame mostran un resumo de exame separado. Informa de preguntas seleccionadas, respostas enviadas, respostas correctas e porcentaxe correcta, coincidencias exactas, respostas non exactas aceptadas, respostas incorrectas, tempo total, tempo por pregunta, se o exame rematou antes de tempo e se se esgotou o tempo dun exame cronometrado. Os resumos de exame non cambian a base de datos de repaso. Escolle `Gardar informe` para escribir unha copia de texto do resumo de exame no directorio `reports`. Os nomes de informe de exame engaden `-exam`, por exemplo `Indonesian-exam-2026-05-03-06-04.txt`.

`Comezar cuestionario` tamén é non programado e só informativo. Está pensado para practicar recoñecemento con opcións múltiples, por exemplo para preparar probas externas con preguntas de tipo cuestionario. Cosimo toma unha mostra aleatoria de cartas activas e exclúe as cartas suspendidas e adiadas. Salvo que o tamaño solicitado do cuestionario o faga imposible, evita poñer as dúas direccións da mesma carta reversible nun mesmo cuestionario, para que unha pregunta non dea pistas sobre a dirección contraria.

Se o mazo ten cartas inversas xeradas, a configuración do cuestionario inclúe unha opción de dirección de estudo: só normal, só inversa ou ambas. Se o mazo non ten cartas inversas xeradas, esta opción queda oculta e o cuestionario usa a dirección normal.

Durante un cuestionario, Cosimo mostra a pregunta e unha lista de respostas posibles. Escolle unha resposta e envíaa. A corrección non se mostra ata o final. Despois do cuestionario, Cosimo mostra cada resposta enviada coa pregunta e a resposta escollida. Se a resposta escollida era incorrecta, tamén mostra a resposta correcta. Escolle `Seguinte` ou preme `Alt-N` para avanzar pola revisión de respostas, ou escolle `Resumo` para ir directamente ao resumo de cuestionario. O modo cuestionario non rexistra intentos, non cambia a programación das cartas e non engade respostas falladas ao final da mesma sesión. Necesita polo menos catro opcións de resposta distintas na dirección de estudo actual, de modo que as preguntas directas toman as opcións das respostas e as preguntas invertidas tómanas dos enunciados. Os enunciados de cartas marcadas como non reversibles non se usan como opcións para preguntas invertidas.

As sesións de cuestionario mostran un resumo de cuestionario con preguntas seleccionadas, respostas enviadas, respostas correctas e incorrectas, porcentaxe correcta, tempo total, tempo por pregunta e se o cuestionario rematou antes de tempo. Os resumos de cuestionario non cambian a base de datos de repaso. Escolle `Gardar informe` para escribir unha copia de texto do resumo de cuestionario no directorio `reports`. Os nomes de informe de cuestionario engaden `-quiz`, por exemplo `Indonesian-quiz-2026-05-03-06-04.txt`.

## Panel de aprendizaxe

Usa `Estudo -> Panel de aprendizaxe`, ou preme `Ctrl+L`, para mostrar un resumo de aprendizaxe de todo o mazo. O panel está dividido en seccións de só lectura separadas para que poidas tabular entre resumo, distribución, carga de traballo, diagnósticos e actividade en vez de ler un só campo longo. Informa de varios tipos de datos:

- recontos de cartas por estado de programación: novas, en aprendizaxe, en repaso e en reaprendizaxe
- recontos de cartas dispoñibles, e cantas desas xa están programadas e pendentes agora, ignorando as cartas suspendidas e adiadas
- estimacións de recordo do modelo para cartas activas con datos de programación
- distribución do recordo estimado, incluíndo mediana, media das cartas máis febles e bandas de recordo
- previsión de carga para as próximas 24 horas, 3 días, 7 días e 30 días, con tempo estimado de estudo cando hai datos de tempo rexistrados, ademais de afirmacións prudentes no resumo sobre a forma e a presión da carga
- calibración de confianza a partir das túas predicións previas á resposta e as túas valoracións posteriores do recordo
- tendencia de recordo, recontos de recaídas e afirmacións conservadoras de tendencia recente cando hai datos suficientes
- diagnósticos como cartas en risco, recaídas repetidas, fallos con alta confianza e retención de aprendizaxe recente
- actividade de estudo, incluíndo días con respostas, respostas almacenadas, respostas en sesións rexistradas, recontos de elementos repetidos cando as sesións antigas os conteñen, tempo empregado en sesións completadas, tempo de estudo rexistrado recente e tempo medio de estudo por día de estudo activo cando existen datos de tempo
- información sobre primeira detección de cartas do mazo, que axuda a comparar o material introducido recentemente coas cartas que chegaron ao estado de repaso

A sección de recordo é unha estimación do modelo de programación de Cosimo, non un resultado medido directamente. Para cada carta activa con datos de programación que non estea suspendida nin adiada, Cosimo usa a hora do último repaso, a estabilidade almacenada e o intervalo programado real para estimar a probabilidade de que recordes a carta agora. As cartas novas sen datos de programación, as cartas suspendidas e as cartas adiadas nese momento non se inclúen nesta estimación. As cartas en aprendizaxe e reaprendizaxe usan o seu intervalo curto programado como punto efectivo do 90%, de modo que unha carta pendente tras un paso curto por fallo non pareza máis segura do que é.

`Dispoñibles agora` conta as cartas activas non suspendidas nin adiadas que se poden estudar inmediatamente. Isto inclúe cartas novas, que Cosimo pode poñer nunha sesión de estudo inmediatamente, e cartas con datos de programación existentes cuxa hora de repaso xa chegou. `Destas, xa programadas e pendentes agora` é un subconxunto de `Dispoñibles agora`: só conta cartas dispoñibles con datos de programación existentes. Usa o mesmo límite temporal que `Dispoñibles agora`, así que unha carta pendente no instante exacto en que se xerou o panel queda incluída. O panel pon `Dispoñibles agora` primeiro porque é a cifra operativa: cantas cartas se poden estudar agora.

`Recordo medio estimado` é a media desas estimacións por carta. O panel tamén mostra a mediana e as cartas estimadas máis febles para que unha media non oculte un grupo pequeno de material débil. A media das cartas máis febles é a media do recordo estimado do 10% inferior de cartas activas con estimación, redondeado cara arriba para incluír polo menos unha carta. `Probablemente sabidas` conta as cartas estimadas cun recordo do 90% ou máis. `Maiormente estables` é 70-89%, `Fráxiles` é 50-69%, e `Moi baixo` é menos do 50%. `Cartas en risco` conta xuntas as bandas fráxil e moi baixa. Estes números úsanse mellor para triaxe e tendencias, non como promesa de que responderás correctamente exactamente esa porcentaxe de cartas na próxima sesión.

A previsión de carga mostra cantas cartas activas están programadas agora e dentro das próximas 24 horas, 3 días, 7 días e 30 días. Estes recontos son acumulativos: unha carta dispoñible agora tamén se inclúe nos horizontes posteriores. As cartas suspendidas e adiadas exclúense. Cando Cosimo ten tempos de sesión rexistrados, a previsión tamén estima o tempo de estudo a partir do tempo medio actual por carta única estudada. É só unha estimación: reflicte intentos repetidos de sesións rexistradas anteriores, pero non pode saber cantos pasos de aprendizaxe ou reaprendizaxe vencerán durante unha sesión futura.

A sección Resumo describe a forma da carga dos próximos 7 días só cando se prevén polo menos 5 cartas. Se polo menos a metade da carga de 7 días vence en 24 horas, Cosimo di que a maior parte vence en 24 horas. Se polo menos tres cuartas partes vencen en 3 días, Cosimo di que a maior parte vence en 3 días. En caso contrario, Cosimo di que a carga está repartida ao longo da semana. Cando existen datos de tempo dos últimos 7 días, o Resumo tamén compara a carga estimada de 7 días co teu tempo de estudo rexistrado nos últimos 7 días. Se a diferenza é inferior a 5 minutos e ao 20% do tempo rexistrado recente, Cosimo describe a estimación como parecida ao tempo de estudo recente; en caso contrario descríbea como maior ou menor e mostra ambas as duracións.

A sección de calibración trata a túa predición antes de ver a resposta como un intervalo obxectivo de se recordarás a resposta, non como unha porcentaxe exacta. `Non o sei` significa un obxectivo de recordo de 0-5%, `Probablemente non o sei` 5-32%, `Probablemente o sei` 68-95%, e `Seguro que o sei` 95-100%. O intervalo central déixase sen cubrir deliberadamente; mostra a resposta sen valorar confianza se non queres facer unha predición. A regra de recordo configúrase en `Ferramentas -> Opcións`. A regra permisiva conta `Difícil`, `Ben` e `Fácil` como recordadas, mentres que `Repetir` conta como non recordada. A regra estrita conta só `Ben` e `Fácil` como recordadas. O panel mostra a regra activa antes das cifras de calibración. O intervalo obxectivo de recordo é a media dos intervalos obxectivo das valoracións de confianza respondidas. A taxa de recordo observada é o que ocorreu realmente coa regra de recordo actual. A calibración está dentro do obxectivo se o recordo observado cae dentro do intervalo obxectivo, hai falta de confianza se o recordo observado queda por riba do intervalo, e exceso de confianza se queda por baixo. As liñas por confianza mostran a mesma comparación para cada valoración de confianza. As cartas mostradas sen predición cóntanse por separado.

Na sección de diagnósticos, `Fallos con alta confianza` significa que escolliches `Probablemente o sei` ou `Seguro que o sei` e despois respondiches `Repetir`. `Éxitos con baixa confianza` significa que escolliches `Non o sei` ou `Probablemente non o sei` e despois recordaches a resposta segundo a regra de recordo activa.

A sección de tendencia do recordo conta respostas almacenadas de cartas do mazo actual. `Recordo global` usa a regra ordinaria do panel: `Difícil`, `Ben` e `Fácil` contan como recordadas, mentres que `Repetir` conta como non recordada. As liñas de valoración mostran primeiro porcentaxes, seguidas de recontos entre parénteses. A xanela recente compara os últimos 7 días cos 7 días anteriores; Cosimo só fai unha afirmación cualitativa de tendencia cando ambas xanelas conteñen polo menos 5 respostas. Un cambio de 5 puntos porcentuais ou máis descríbese como mellora ou empeoramento; diferenzas menores descríbense como amplamente estables. As tendencias de taxa de `Repetir` en cartas inversas usan as mesmas xanelas de 7 días, o mínimo de 5 respostas e o limiar de 5 puntos, pero unha taxa de `Repetir` descendente é mellor e unha ascendente é peor. As liñas de recaídas veñen do estado de programación actual das cartas activas e axudan a identificar se o mazo contén material que volve repetidamente á reaprendizaxe desde o estado de repaso. Estas recaídas programadas só contan `Repetir` en cartas que xa chegaran ao estado de repaso; as taxas ordinarias de `Repetir` móstranse por separado. As afirmacións de retención sobre aprendizaxe recente contan cartas aprendidas recentemente que non tiveron despois unha resposta `Repetir`. Cosimo necesita polo menos 5 cartas aprendidas recentemente antes de describir a retención recente; 90% ou máis retidas é `ben retidas`, 70-89% é `maiormente retidas`, e menos de 70% móstrase como recaídas de seguimento.

Cando existen datos temporizados de sesión, a sección Resumo inclúe o tempo medio de estudo por día de estudo activo para que esta métrica principal estea visible sen tabular ata a sección completa de actividade.

Cosimo rexistra a primeira vez que a base de datos de repaso ve cada carta física do mazo. Isto non é necesariamente a data real de creación da carta: en mazos existentes, as cartas actuais rexistraranse cando esta función as vexa por primeira vez. Por iso o panel descríbeo como cartas detectadas por primeira vez por esta base de datos de repaso. Cando a base de datos xa teña observacións anteriores, o Resumo pode mostrar unha liña de `Fluxo do mazo` para os últimos 7 días: cantas cartas do mazo foron detectadas por primeira vez e cantas cartas en dirección estándar chegaron ao estado de repaso. É información descritiva. A súa finalidade é axudarche a xulgar o crecemento do mazo e o ritmo de aprendizaxe sen que Cosimo che diga se debes engadir máis ou menos cartas.

A sección de actividade de estudo baséase en intentos rexistrados e resumos de sesións. `Respostas almacenadas` conta respostas individuais almacenadas. `Días con respostas` conta días UTC con polo menos unha resposta rexistrada. Os recontos de sesións, respostas e tempo etiquetados como sesións rexistradas veñen de resumos de sesións completadas. `Días de estudo temporizados` conta días UTC con polo menos un resumo de sesión completada e é a base do tempo medio de estudo por día de estudo activo. O tempo de estudo recente rexistrado e as preguntas recentes rexistradas comparan os últimos 7 días cos 7 días anteriores. Isto describe actividade de estudo real rexistrada en sesións completadas; non é unha previsión histórica de cantas cartas estaban programadas. O Resumo describe o tempo de estudo recente como maior, menor ou parecido ao dos 7 días anteriores cando existen datos de sesións con tempo; as diferenzas inferiores a 5 minutos e ao 20% da xanela anterior trátanse como parecidas. Se hai datos antigos anteriores aos resumos de sesións, o panel mostra `Respostas antigas sen tempo de sesión` para non confundir o total de respostas almacenadas co total menor de sesións con tempo. Esa liña ocúltase cando o valor é cero. A mesma sección tamén informa de cantas cartas físicas do mazo detectou por primeira vez esta base de datos de repaso, os recontos de primeira detección dos últimos 7 días, os 7 días anteriores e as observacións anteriores cando hai historial suficiente, e as cartas activas estándar do mazo que aínda non se estudaron.

Usa o botón `Gardar informe` do panel para gardar o informe completo do panel no directorio `reports`. O texto gardado usa cabeceiras de sección de estilo Markdown e inclúe todas as seccións do panel, aínda que o diálogo as mostre en campos separados. O nome do informe usa o nome do mazo e a hora UTC na que se abriu o panel, e o informe inclúe as rutas completas do mazo e da base de datos de repaso. Usa `Copiar ao portapapeis` para copiar ao portapapeis o mesmo texto completo do informe.

Se o mazo ten cartas inversas xeradas, o panel engade unha comparación entre cartas estándar e inversas, porque unha dirección pode ser moito máis fácil que a outra. Se as dúas medias de recordo estimado difiren en menos de 5 puntos porcentuais, Cosimo describe as direccións como similares.

## Audio

O soporte de audio ten dúas partes separadas. A reprodución usa ficheiros WAV existentes mentres estudas, previsualizas cartas ou revisas respostas de exame. A xeración automática usa `voice.exe`, desde a liña de ordes ou mediante `Ferramentas -> Xerar audio`, para crear eses WAV a partir de voces de síntese instaladas.

A reprodución de audio de repaso é opcional e polo momento só admite ficheiros WAV. Configúraa en `Ferramentas -> Opcións -> Audio durante o estudo`:

- `Sen audio`: Cosimo ignora o audio das cartas.
- `Manual`: se a pregunta ou resposta actual ten audio, Cosimo indica que hai audio dispoñible e mostra un botón `Reproducir/deter audio`.
- `Automático`: Cosimo reproduce o audio da pregunta cando aparece unha pregunta e o audio da resposta cando aparece unha resposta durante o repaso ordinario. O mesmo botón pode deter ou volver reproducir o audio actual.

A opción separada `Tons guía para o audio automático` engade sinais de orientación breves cando o audio automático está activado: un ton curto antes do audio da pregunta, dous tons curtos antes do audio da resposta e un arpexio de tres notas cando aparece o resumo do repaso. A opción está desactivada por defecto.

`Ctrl+P` activa a mesma acción de reproducir/deter cando o audio de repaso está dispoñible. Na lista inicial de cartas, `Ctrl+P` ou o botón `Reproducir/deter audio` previsualiza a carta seleccionada reproducindo o audio da pregunta e despois o audio da resposta. Pasar á carta seguinte, mostrar a resposta, rematar a sesión ou pechar a xanela detén inmediatamente calquera audio de carta que se estea reproducindo. En modo exame, o audio da pregunta está dispoñible mentres respondes a pregunta.

`Ferramentas -> Opcións -> Reproducir audio automaticamente durante a corrección e revisión de exame` controla o que acontece despois de enviar unha resposta de exame, cando Cosimo mostra un diálogo de corrección ou revisión. `Sen audio automático` deixa esa fase en silencio salvo que pidas audio manualmente. `Pregunta`, `Resposta` e `Ambas` reproducen automaticamente a pregunta, a resposta esperada, ou a pregunta seguida da resposta esperada. Nos diálogos de corrección e revisión, `Ctrl+P` sempre reproduce a pregunta seguida da resposta esperada cando eses ficheiros de audio existen, mesmo se o audio automático de corrección/revisión de exame está desactivado.

`Ferramentas -> Opcións -> Reproducir audio automaticamente durante cuestionarios` controla o audio dos cuestionarios. `Sen audio automático` deixa os cuestionarios en silencio salvo que reproduzas audio manualmente durante a revisión de respostas. `Pregunta` reproduce o audio da pregunta cando aparece cada pregunta de cuestionario. `Opcións` reproduce o audio dunha opción de resposta cando esa opción se selecciona, e deteno cando a lista de opcións perde o foco ou cambia a selección. `Ambas` combina eses comportamentos. Durante a revisión de respostas do cuestionario, o mesmo axuste controla a reprodución automática da pregunta e da resposta correcta; `Ctrl+P` reproduce a pregunta seguida da resposta correcta cando eses ficheiros de audio existen.

Os ficheiros de audio viven no directorio co mesmo nome base xunto ao mazo. Para a carta `1` de `Indonesian.cosimo-deck`, usa `Indonesian/1.prompt.wav` para o lado de pregunta e `Indonesian/1.response.wav` para o lado de resposta. As cartas inversas xeradas reutilizan os ficheiros da carta principal con pregunta e resposta intercambiadas. A ferramenta de xeración de audio pode escribir e sobrescribir ficheiros nese directorio, así que conserva copias separadas de calquera gravación que creases ti.

As copias automáticas do mazo e da base de datos de repaso non inclúen ficheiros de audio xunto ao mazo. Se gravas ou editas os teus propios WAV, fai copia do directorio de audio antes de usar `Ferramentas -> Xerar audio` ou `voice --overwrite`.

Os paquetes de Windows tamén inclúen `voice.exe`, unha ferramenta auxiliar para xerar eses WAV a partir de voces OneCore ou SAPI instaladas. Execútaa desde un símbolo do sistema. Por exemplo, se `voice.exe` está xunto a `cosimo.exe`, esta orde le `decks/Indonesian.cosimo-deck` e escribe ficheiros de audio en `decks/Indonesian/`:

    voice Indonesian --prompt-voice "Nome de voz indonesia" --response-voice "Nome de voz galega"

Tamén podes usar `Ferramentas -> Xerar audio` desde Cosimo despois de abrir un mazo. Esta opción só está dispoñible cando o mazo ten metadatos de `Voz da pregunta`, `Voz da resposta`, `Motor de voz da pregunta` e `Motor de voz da resposta`, para que Cosimo non xere audio silenciosamente coa voz predeterminada equivocada do sistema. Se a opción está desactivada, usa `Mazo -> Editar metadatos do mazo` para escoller esas voces e motores, e comproba se o mazo está marcado como mazo de audio manual. Mostra un diálogo de progreso mentres `voice.exe` traballa sobre o mazo actual e escribe a saída da ferramenta nun ficheiro de texto dentro do directorio `reports`. A opción do menú non sobrescribe audio existente salvo que o manifesto indique que cambiou o texto de carta xerado, a voz seleccionada ou o motor seleccionado. Se aínda non existe manifesto, os WAV existentes que coincidan rexenéranse unha vez para que o novo manifesto reflicta o texto actual da carta, a voz seleccionada e o motor seleccionado. Se xa existe un manifesto pero un ficheiro de audio individual non ten entrada, ese ficheiro non se toca e engádese ao manifesto para que poidan detectarse cambios posteriores no texto da carta, na voz ou no motor. Ao rematar, Cosimo informa do número de cartas para as que se xerou audio, cantos ficheiros de audio eran novos, cantos se rexeneraron porque cambiou o texto da carta, a voz ou o motor, cantos ficheiros non rexistrados se rexeneraron para iniciar un manifesto ausente, cantos ficheiros existentes se engadiron ao manifesto e cantos ficheiros se omitiron. Se o informe menciona ficheiros rexenerados forzosamente por sobrescritura explícita, refírese á opción de liña de ordes `--overwrite`, non á rexeneración normal de audio xestionado obsoleto.

Esta política de rexeneración está pensada para audio producido por `voice.exe`. Se gravaches ou editaches manualmente un ficheiro cuxo nome coincide cun lado dunha carta seleccionada, unha edición posterior do mazo ou un cambio de voz ou motor pode facer que `Ferramentas -> Xerar audio` sobrescriba esa gravación. Usa primeiro `--dry-run` se tes dúbidas, e conserva a túa propia copia das gravacións antes de xerar audio. Para un mazo cuxo audio mantés manualmente, activa `Mazo de audio manual (protexer contra a xeración automática de audio)` en `Mazo -> Editar metadatos do mazo`. Isto escribe `audio_generation=disabled` na cabeceira do mazo, desactiva `Ferramentas -> Xerar audio`, e fai que `voice.exe` se negue a xerar audio para ese mazo. Non impide reproducir o audio existente.

Usa `voice --list-voices` para ver as voces instaladas. En aprendizaxe de idiomas, escolle unha voz que corresponda ao idioma de cada lado: se as preguntas están en indonesio e as respostas en galego, usa unha voz en indonesio para as preguntas e unha voz en galego para as respostas. Se ambos lados están no mesmo idioma, `--voice "Nome de voz"` usa a mesma voz para ambos. Usa `--engine onecore` ou `--engine sapi` para listar ou xerar cun motor concreto; `--prompt-engine` e `--response-engine` poden seleccionar motores distintos para os dous lados.

Os metadatos do mazo tamén poden gardar filtros de voz e motores de voz predeterminados. Configura `Voz da pregunta`, `Voz da resposta`, `Motor de voz da pregunta` e `Motor de voz da resposta` en `Mazo -> Editar metadatos do mazo`, ou engade `prompt_voice=`, `response_voice=`, `prompt_voice_engine=` e `response_voice_engine=` á cabeceira do mazo. `voice.exe` usa eses valores predeterminados cando non se indica a opción correspondente na liña de ordes. O mesmo editor pode marcar un mazo como de audio manual, o que engade `audio_generation=disabled`. Cando `voice.exe` está dispoñible xunto a `cosimo.exe`, o editor de metadatos lista as voces instaladas para o motor seleccionado. Os campos de voz seguen sendo editables, así que podes escribir un filtro manualmente se a lista falla ou se queres usar un valor que non aparece nela. O selector de motor pode listar voces OneCore, voces SAPI, ou ambas; cando escolles unha voz da lista, Cosimo garda automaticamente o motor correspondente. Se escribes ou editas un filtro de voz manualmente, escolle `onecore` ou `sapi` antes de gardar para que `voice.exe` saiba que motor usar. As opcións de liña de ordes seguen tendo prioridade sobre os metadatos do mazo, pero non teñen prioridade sobre `audio_generation=disabled`.

A ferramenta escribe un ficheiro `audio-manifest.tsv` no directorio de audio. Usa ese manifesto para omitir o audio cuxo texto de carta, voz seleccionada e motor seleccionado non cambiaron, e para rexenerar ficheiros cando algún deles cambiou. Os ficheiros de audio existentes sen entrada no manifesto rexenéranse se non hai ningún manifesto; se xa existe un manifesto, déixanse intactos na execución actual pero engádense ao manifesto para que se poidan detectar cambios futuros. Usa `--overwrite` se queres actualizar todos os ficheiros seleccionados inmediatamente. `--dry-run` mostra o que se xeraría sen escribir ficheiros.

## Ficheiros, copias de seguridade e mantemento

Fai copia de seguridade tanto do ficheiro do mazo como da súa base de datos de repaso correspondente. O ficheiro do mazo contén as túas cartas, metadatos do mazo e marcas de cartas non reversibles. A base de datos de repaso contén o estado de programación, valoracións e historial de repaso.

Cosimo tamén crea copias automáticas do contido do mazo. Antes de sobrescribir un mazo existente, copia a versión actual no directorio `backups` da aplicación, xunto ao executable. Os ficheiros de copia teñen números crecentes, por exemplo `backups/000001-deck.cosimo-deck`. O ficheiro `backups/index.txt` rexistra cada nome de copia e a ruta do mazo orixinal.

Configura as copias automáticas do mazo en `Ferramentas -> Opcións`:

- `Completas`: conserva todas as copias automáticas do mazo.
- `Só última`: conserva só a copia automática máis recente de cada ruta de mazo orixinal.
- `Ningunha`: non crea copias automáticas do mazo.

Configura as copias da base de datos de repaso en `Ferramentas -> Opcións`:

- `Ao comezar sesión`: actualiza unha copia retida da base de datos de repaso cando comeza unha sesión de estudo.
- `Desactivadas`: non crea nin actualiza copias da base de datos de repaso.

Configura as copias completas automáticas en `Ferramentas -> Opcións`:

- `Diarias`: cando Cosimo arranca ou abre un mazo, escribe unha copia completa comprimida retida se o mazo actual non ten unha copia completa de menos de 24 horas. Esta copia inclúe o ficheiro do mazo, o directorio auxiliar co mesmo nome base e a base de datos de repaso. Só se escribe despois de abrir correctamente o mazo e pasar a comprobación de integridade da base de datos.
- `Desactivadas`: non crea copias completas retidas automaticamente.

Para o mazo predeterminado, copia:

- `decks/deck.cosimo-deck`
- `decks/deck.reviews.sqlite3`, se existe
- `decks/deck/`, se usas audio xunto ao mazo

Para outro mazo, a base de datos de repaso está xunto ao mazo e usa o mesmo nome base. Por exemplo, `galician.cosimo-deck` usa `galician.reviews.sqlite3`; o seu directorio de audio, se existe, usa o mesmo nome base que o mazo.

Pecha Cosimo antes de copiar ou restaurar ficheiros de copia de seguridade. Restaurar só o ficheiro `.cosimo-deck` recupera as cartas, pero déixaas sen o seu historial de repaso anterior. Restaurar ambos ficheiros conserva as cartas e o seu historial de programación.

Cosimo comproba a integridade da base de datos de repaso ao abrir un mazo. Se Cosimo indica que esa comprobación fallou, pecha Cosimo e restaura o ficheiro `.reviews.sqlite3` correspondente desde a túa copia de seguridade.

As copias automáticas do mazo conteñen só o texto do mazo, non o historial de repaso. Para restaurar unha, pecha Cosimo e copia a copia escollida por riba do ficheiro `.cosimo-deck` activo. Para restaurar o historial de programación, restaura o ficheiro `.reviews.sqlite3` correspondente desde a túa propia copia de seguridade ou desde a copia retida da base de datos de repaso de Cosimo. As copias automáticas do mazo e da base de datos de repaso non conteñen audio xunto ao mazo; restaura o audio desde a túa propia copia do directorio de audio.

As copias completas automáticas son distintas: cando están activadas, son paquetes comprimidos retidos que inclúen o mazo, o directorio auxiliar e a base de datos de repaso. Serven como rede de seguridade diaria para o mazo que estás usando, non como substituto das exportacións manuais antes de cambios arriscados.

`Arquivo -> Exportar mazo completo` escribe un paquete comprimido `.zip` co ficheiro `.cosimo-deck` actual e o seu directorio auxiliar co mesmo nome base, incluídos os ficheiros de audio e `audio-manifest.tsv` se existen. Non inclúe a base de datos de repaso. Cosimo propón un nome con data e hora e permíteche escoller onde gardar o paquete. Usa esta exportación cando queiras compartir o contido do mazo sen o teu historial persoal de estudo.

`Arquivo -> Exportar mazo completo con historial` escribe o mesmo paquete máis unha instantánea consistente da base de datos de repaso. Úsao para mover o teu propio contorno de estudo a outro equipo ou para facer unha copia manual completa. O ficheiro contén datos persoais de estudo como programacións, valoracións, historial de repaso, suspensións, marcas e adiamentos.

`Arquivo -> Copia de seguridade completa do mazo` escribe automaticamente o paquete de mazo e directorio auxiliar no directorio `backups` da aplicación e rexístrao en `backups/deck-bundle-index.txt`. Non inclúe a base de datos de repaso.

A copia completa automática diaria opcional tamén escribe en `backups`, pero usa `backups/automatic-deck-bundle-index.txt` e conserva unha copia retida por ruta de mazo. Inclúe a base de datos de repaso.

`Arquivo -> Restaurar mazo completo` restaura un destes paquetes comprimidos no directorio `decks` de Cosimo. Cosimo comproba primeiro o paquete e mostra o nome do ficheiro de mazo, o número de cartas, o número de ficheiros de audio, o total de ficheiros e se o paquete contén historial de estudo. Se se van sobrescribir ficheiros existentes, Cosimo avisa e escribe unha copia completa comprimida do mazo de destino antes de restaurar. Se se sobrescribirían ficheiros auxiliares pero non existe un mazo de destino que poida copiarse, Cosimo rexeita a restauración no canto de sobrescribilos.

Restaurar un paquete pode causar perda de datos. Pode substituír texto de cartas máis recente, audio auxiliar máis recente, un `audio-manifest.tsv` máis recente ou historial de programación e valoración máis recente na base de datos `.reviews.sqlite3`. Un paquete sen historial de estudo non restaurará programación nin historial de valoracións; un paquete con historial de estudo substituirá ese historial pola instantánea contida no zip. Pecha outros programas que poidan estar usando o mesmo mazo ou base de datos de repaso antes de restaurar.

Usa `Ferramentas -> Limpar base de datos de repaso` para eliminar permanentemente filas inactivas da base de datos de repaso correspondentes a cartas que xa non están no mazo actual e a cartas inversas xeradas inactivas. Consérvanse as cartas activas, as cartas inversas xeradas activas, as programacións actuais, as suspensións actuais e as marcas actuais. As marcas de carta non reversible gárdanse no ficheiro do mazo, non na base de datos de repaso. Se as copias da base de datos de repaso están desactivadas, Cosimo avisa de que a limpeza é irreversible. Se as copias están activadas, Cosimo actualiza a copia retida antes de limpar e avisa de que a copia retida se sobrescribirá. Despois de eliminar as filas inactivas, Cosimo compacta a base de datos para que o ficheiro SQLite poida recuperar espazo non usado.

Usa `Ferramentas -> Recuperar espazo da base de datos` para executar a mesma compactación SQLite sen eliminar datos de repaso inactivos. Isto reescribe o ficheiro da base de datos de repaso e pode tardar nunha base de datos grande. Se as copias da base de datos de repaso están activadas, esta orde non sobrescribe a copia retida; se están desactivadas, Cosimo recórdache que comprobes que tes unha copia se che preocupa.

Usa `Ferramentas -> Opcións -> Eliminar copias antigas` para conservar só a copia automática máis recente de cada ruta de mazo orixinal. Cosimo pide confirmación antes de eliminar ou renumerar ficheiros de copia.

Usa `Ferramentas -> Baleirar directorio de copias` só cando queiras baleirar deliberadamente o directorio `backups` da aplicación. Cosimo avisa antes de facelo porque a orde elimina todos os ficheiros e cartafoles dese directorio, incluídos ficheiros que quizais non fosen xerados nin rexistrados por Cosimo. A orde conserva o directorio `backups`, pero Cosimo non pode recuperar o seu contido despois de eliminalo.

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

## Accesibilidade

Cosimo está deseñado para usarse con teclado e lector de pantalla. A maioría das accións de estudo poden completarse sen abrir menús:

- as teclas numéricas `1` a `4` escollen valoracións de confianza antes da resposta e valoracións de recordo despois da resposta
- a tecla Espazo mostra a resposta sen rexistrar unha valoración de confianza
- `0` remata antes de tempo unha sesión normal de estudo
- `e` edita a carta actual despois de revelar a resposta
- `Ctrl+D` adía a carta actual antes de revelar a resposta
- `Ctrl+F` marca ou desmarca a carta actual
- `Ctrl+P` reproduce ou detén o audio de carta dispoñible

A pantalla inicial tamén ten ordes directas de teclado para accións comúns:

- `Alt-M` comeza a sesión programada
- `Alt-F` forza o comezo con cartas dispoñibles
- `Alt-X` comeza un exame
- `Alt-Z` comeza un cuestionario
- `Ctrl+L` abre o panel de aprendizaxe
- `Alt+Enter` abre detalles da carta seleccionada

O audio de repaso pode usarse manual ou automaticamente. Cando o audio automático durante o estudo está activado, os tons guía opcionais dan sinais sen voz: un ton curto antes do audio da pregunta, dous tons curtos antes do audio da resposta e un arpexio de tres notas cando se mostra o resumo do repaso. Os exames cronometrados tamén usan tons para marcar o progreso do tempo e os esgotamentos de tempo.

O panel de aprendizaxe está dividido en seccións de só lectura separadas para que os usuarios de lector de pantalla poidan tabular entre resumo, distribución, carga de traballo, diagnósticos e actividade en vez de ler un só campo longo. O panel tamén ten botóns `Gardar informe` e `Copiar ao portapapeis` para revisar o informe completo fóra do diálogo.

A barra de estado principal informa do estado do mazo e do tempo de repaso con expresións breves e cómodas para síntese de voz. As datas programadas nos detalles de carta inclúen duracións relativas antes das datas e horas UTC exactas, porque os tempos relativos son máis fáciles de entender con voz.

Problema coñecido: cando entras na lista de preguntas con Tab ou Shift+Tab, algunhas combinacións de lector de pantalla e wxWidgets anuncian o elemento seleccionado dúas veces. Unha vez dentro da lista, a navegación coas frechas debería funcionar normalmente.

## Opcións e idiomas

Configura o mínimo de cartas por sesión en `Ferramentas -> Opcións`. O diálogo de opcións tamén pode configurar sons de dispoñibilidade de repasos, audio de repaso, tons guía, audio de corrección/revisión de exame, a regra de recordo usada pola calibración do panel de aprendizaxe, copias do mazo e da base de datos de repaso, idioma e minimización á área de notificación.

As notificacións sonoras poden configurarse como `Sempre`, `Cando Cosimo estea visible`, `Cando Cosimo estea na área de notificación` ou `Nunca`. Cando a política escollida permite son, Cosimo reproduce un son breve se a actualización temporizada da pantalla inicial detecta que hai repasos dispoñibles, ou que hai máis repasos dispoñibles desde a última actualización automática. Os cambios provocados polo usuario, como engadir ou eliminar cartas, e as actualizacións manuais con `F5` non reproducen este son. Cosimo tamén permanece en silencio mentres hai unha sesión de estudo activa, aínda que pasen a estar pendentes máis cartas durante esa sesión.

Coa minimización á área de notificación activada, usar a acción normal de minimizar a xanela oculta Cosimo na área de notificación en vez de deixalo na barra de tarefas. Activar a icona da área de notificación restaura a xanela, e o menú contextual da icona contén Restaurar e Saír. Pechar Cosimo segue saíndo da aplicación.

Cosimo admite actualmente inglés, español e galego. Cambia o idioma en `Ferramentas -> Opcións`. O idioma escollido gárdase e úsase a próxima vez. Se aínda non se gardou ningún idioma, Cosimo usa español cando a configuración rexional do sistema é española, galego cando é galega, e noutro caso usa inglés. As configuracións rexionais descoñecidas tamén usan inglés.

As traducións mantéñense en ficheiros `.po` de estilo gettext, cunha pequena cantidade de código de conexión para cada idioma novo. Se queres traballar nunha tradución, contacta primeiro con David Picón Álvarez en `@modulux@node.isonomia.net` para coordinar o traballo.

O menú `Axuda` abre a guía local de usuario, a wiki do proxecto e a páxina de novo ticket para informar de erros. Os informes de erros xestiónanse mediante tickets de Fossil no sitio do proxecto.

## Consellos

- Fai preguntas concretas. Unha carta debe preguntar unha soa cousa.
- Evita preguntas duplicadas. Fan ambiguo o mazo; usa o filtro de preguntas duplicadas e `Mazo -> Resolver enunciados duplicados` se unha edición manual as crea.
- Mantén as respostas o bastante curtas como para poder xulgalas de forma consistente.
- As respostas duplicadas están ben, pero só unha carta dun grupo coa mesma resposta pode ter unha carta inversa xerada activa.
- Usa `Forzar comezo` para practicar máis, non como substituto da sesión programada.
- Se unha carta resulta confusa, edítaa antes da seguinte sesión. Se atopas unha errata ou unha resposta incorrecta despois de mostrar a carta, edítaa antes de valorar o recordo.
- Usa `0` cando queiras rematar unha sesión antes de tempo; os teus intentos completados gárdanse igualmente.

## Por que se chama Cosimo?

Cosimo recibe o seu nome en honra de Cosimo Piovasco di Rondò, o protagonista da novela O barón rampante, de Italo Calvino. O Cosimo de Calvino é un notorio polímata e políglota, o que fai que o seu nome encaixe cunha ferramenta de estudo.