# 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 Opus ou 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.
- `Mazo -> Sincronizar` permite iniciar sesión nun servidor de sincronización
  e subir ou descargar o mazo actual.
- `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, sincronización, 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.
As versións actuais migran esas filas derivadas de programación reproducindo o
historial de repaso almacenado co programador FSRS-6 actual. Isto non elimina o
historial de repaso, pero as datas pendentes e os diagnósticos de recaídas do
panel poden cambiar unha vez cando unha base de datos de repaso antiga se abre
cunha compilación de Cosimo máis recente.

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
mesmo diálogo contén a visibilidade do mazo para sincronización: público, non
listado ou privado. A URL do servidor de sincronización, a sesión de
sincronización e o nome local do dispositivo son axustes da aplicación en
`Ferramentas -> Opcións` e `Mazo -> Sincronizar`, porque identifican esta
instalación de Cosimo e a conta usada, non só un mazo concreto.

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
sen recordar a resposta segundo a regra activa de recordo de calibración;
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 dunha resposta que conta como recordada
segundo a regra activa de recordo de calibración. Coa regra permisiva,
`Difícil`, `Ben` e `Fácil` contan como recordadas; coa regra estrita, só `Ben`
e `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 non
recordaches a resposta segundo a regra de recordo activa. É sinal de exceso de
confianza. `Acertos 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. É sinal de falta de confianza. `Respostas` conta eventos de
resposta almacenados; unha carta pode achegar máis dunha resposta. `Cartas
afectadas` conta cantas cartas teñen polo menos unha resposta dese tipo. Os
recontos recentes entre parénteses usan os últimos 7 días: din `todos
recentes` se todas as respostas ou cartas contadas son recentes, `ningún
recente` se ningunha o é, ou noutro caso dan o número de respostas ou cartas
recentes. `Cartas con exceso de confianza recente significativo` e `Cartas con
falta de confianza recente significativa` usan a regra estrita de patrón
recente usada polos filtros diagnósticos da lista inicial: para o exceso de
confianza abonda co último intento con confianza, ou polo menos 2 dos últimos 5
intentos con confianza; para a falta de confianza deben coincidir polo menos 2
dos últimos 5 intentos con confianza.

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. As duracións de tempo de estudo usan
segundos, minutos, horas, días, semanas e anos; Cosimo non usa meses porque a
súa duración varía. `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 Opus
existentes, e ficheiros WAV antigos, 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 ficheiros
Opus ou WAV a partir de voces de síntese instaladas.

A reprodución de audio de repaso é opcional e admite ficheiros `.opus`, con
retroceso a ficheiros `.wav` antigos co mesmo ID de carta e lado se non existe
ficheiro Opus. 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.

`Ferramentas -> Opcións -> Formato de xeración de audio` controla o formato
usado pola xeración automática. `Opus` é o valor predeterminado e normalmente
ocupa moito menos espazo que WAV. `WAV` segue dispoñible por compatibilidade
ou para usuarios que prefiran audio xerado sen compresión.

`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.
Se os tons guía están activados, a revisión de respostas do cuestionario tamén
reproduce un ton breve ascendente para unha resposta correcta e un ton breve
descendente para unha resposta incorrecta antes de calquera audio automático de
revisión.

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.opus` para o lado de pregunta e
`Indonesian/1.response.opus` para o lado de resposta. Os nomes `.wav` antigos,
como `Indonesian/1.prompt.wav`, seguen reproducíndose se non existe ficheiro
`.opus`. As cartas inversas xeradas reutilizan os ficheiros da carta principal
con pregunta e resposta intercambiadas. A ferramenta de xeración de audio
escribe ficheiros novos no formato seleccionado nese directorio, así que
conserva copias separadas de calquera gravación que creases ti.

`Ferramentas -> Eliminar audio inoperativo do mazo` elimina ficheiros de audio
recoñecidos por Cosimo nese directorio cando non poden usarse: ficheiros para
ID de carta que xa non existen no mazo, e ficheiros de formato menos preferido
ocultos por un formato preferido para o mesmo lado da carta, por exemplo un
`.wav` cando existe o `.opus` correspondente. Tamén elimina as entradas
correspondentes de `audio-manifest.tsv`. A orde ignora outros ficheiros do
directorio, pide confirmación e non pode desfacerse.

As copias automáticas do contido do mazo e da base de datos de repaso non
inclúen ficheiros de audio xunto ao mazo. As exportacións e copias completas
do mazo si inclúen o directorio auxiliar. Se gravas ou editas o teu propio
audio, asegúrate de usar copias completas do mazo ou fai copia do directorio
de audio pola túa conta. A xeración actual conserva os ficheiros `.opus` e
`.wav` existentes sen seguimento en lugar de sobrescribilos, pero o directorio
de audio segue fóra do sistema de copias automáticas do contido do mazo e da
base de datos.

Os paquetes de Windows tamén inclúen `voice.exe`, unha ferramenta auxiliar para
xerar eses ficheiros de audio 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/`:

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

Por defecto, `voice.exe` escribe ficheiros Opus. Usa `--format wav` se queres
saída WAV.

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`. Se xa existe
un ficheiro `.opus` ou `.wav` antigo sen seguimento para un lado concreto,
`voice.exe` déixao intacto. Ao rematar, Cosimo informa do número de cartas
para as que se xerou audio, cantos ficheiros novos se crearon, cantos
ficheiros xestionados se rexeneraron ou converteron, cantos ficheiros sen
seguimento se conservaron, e cantos ficheiros xa rexistrados se omitiron. Se o informe
menciona ficheiros rexenerados forzosamente por sobrescritura explícita,
refírese a unha ruta de sobrescritura de liña de ordes antiga ou futura, non á
xeración ordinaria desde a interface.

Esta política conservadora está pensada para evitar substituír gravacións do
usuario. 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. O audio rexistrado no manifesto considérase
xestionado por Cosimo e pode rexenerarse ou converterse ao formato de saída
seleccionado. Os ficheiros `.opus` e `.wav` existentes sen seguimento
considéranse gravacións do usuario e déixanse intactos; nese caso Cosimo non
crea un ficheiro novo para ese lado da carta, porque podería ocultar o audio
do usuario. `--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 contido 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 contido do mazo
e da base de datos de repaso non conteñen audio xunto ao mazo. As copias
completas do mazo si conteñen o directorio auxiliar; se non tes unha, 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.

`Mazo -> Sincronizar` usa a mesma maquinaria de paquetes, pero almacena a
instantánea no servidor de sincronización configurado en
`Ferramentas -> Opcións`. Os servidores locais de desenvolvemento poden usar
URL `http://`; os servidores despregados deberían usar `https://`. Usa
`Mazo -> Sincronizar -> Iniciar sesión` para iniciar sesión no servidor cunha
conta compatible con Mastodon. Cosimo abre a URL de autorización no navegador,
pide o código de autorización e garda localmente a identidade de sincronización
e o token portador de sincronización de Cosimo. Polo tanto, trata o ficheiro
local de configuración como privado.

O inicio de sesión compatible con Mastodon é deliberadamente limitado. A
instancia fediversa só pide autorizar o ámbito `read:accounts`, suficiente para
que o servidor de sincronización confirme que conta iniciou sesión. Non permite
ler mensaxes privadas, publicar estados, seguir contas nin actuar como ti. O
cliente de escritorio de Cosimo nunca recibe o teu contrasinal fediverso nin o
token de acceso fediverso. Ve a URL da instancia, o código de autorización que
pegas, a identidade de sincronización verificada que devolve o servidor e o
token portador de Cosimo que usará nas seguintes peticións de sincronización.
O servidor de sincronización recibe o código de autorización pegado, recibe
brevemente un token de acceso fediverso da instancia, úsao para chamar a
`verify_credentials`, e despois revoga ese token fediverso temporal antes de
emitir un token portador de Cosimo. O servidor conserva a identidade de conta
verificada, as credenciais da aplicación OAuth para a instancia, os paquetes de
mazo que subas e un verificador con hash do token portador de Cosimo; non garda
o teu contrasinal fediverso nin o token de acceso fediverso. A instancia
fediversa ve os metadatos da aplicación OAuth Cosimo Sync, a URL de sitio web
da aplicación rexistrada polo servidor de sincronización e o intercambio breve
de autenticación; non ve o teu token portador de Cosimo nin os teus mazos.

`Mazo -> Sincronizar -> Pechar sesión` borra a identidade de sincronización e
o token portador de Cosimo gardados nesta instalación de Cosimo e pídelle ao
servidor que revogue o token portador de Cosimo cando o servidor está
dispoñible; non elimina mazos remotos nin rexistros locais de revisión.

`Estado de sincronización` mostra o UUID do mazo, visibilidade, URL do
servidor, identidade propietaria, nome local do dispositivo e o último estado
coñecido de revisión e hashes. Tamén comproba o servidor configurado e indica
se hai unha copia remota do UUID do mazo actual, a súa revisión, visibilidade,
identidade propietaria, se ten historial de estudo e o último dispositivo que
fixo unha subida. Tamén mostra a información de cota que anuncia o servidor de
sincronización. Sen iniciar sesión, isto limítase a límites xerais, como o
máximo de mazos por propietario ou límites de almacenamento. Con sesión
iniciada, tamén mostra o teu número actual de mazos e tamaño de paquetes
almacenados fronte a eses límites. `Mazos remotos` enumera os mazos atopados
no servidor configurado. `Subir con historial de estudo` sobe o mazo, o
directorio auxiliar e a base de datos de repaso. `Descargar con historial de estudo`
restaura a instantánea para o mesmo UUID de mazo e conta iniciada, escribindo
unha copia
completa comprimida antes de substituír ficheiros de mazo existentes. Subir e
descargar pode tardar se o mazo contén audio, polo que Cosimo mostra un
diálogo de progreso mentres a transferencia e a restauración se executan fóra
do fío principal da interface. Isto é sincronización por instantáneas, non
mestura: se dous equipos cambian o mesmo mazo de maneira independente, Cosimo
detecta conflitos de revisión no canto de combinar os cambios. Se un equipo
recentemente configurado indica un conflito ao subir porque o mazo remoto xa
ten unha revisión, descarga primeiro o mazo sincronizado; iso rexistra a
revisión remota localmente e permite comprobar as subidas posteriores contra o
estado remoto actual.

Cada mazo sincronizado tamén ten un UUID. Se o servidor xa ten ese UUID baixo
outra conta autenticada, Cosimo rexeita a subida no canto de apropiarse do mazo
remoto. Se isto ocorre porque descargaches un mazo público ou non listado
doutra persoa e queres manter a túa propia copia sincronizada, usa `Mazo ->
Editar metadatos do mazo -> Facer copia independente` e garda. Cosimo asigna
un novo UUID de mazo, restablece a visibilidade a privado, conserva as cartas,
o audio e o historial de estudo local, e esquece o estado local de
sincronización do UUID anterior.

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](troubleshooting.md).

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