Guia de uso do Docki

O Docki é um app de repetição espaçada: cada baralho tem um Document (o Documento, ou seja, a lição) e Flashcards (cartões) para memorizá-la. A IA redige cartões e questionários a partir do Documento, e o agendador FSRS traz cada cartão de volta pouco antes de você esquecê-lo. Este guia percorre todas as partes do app. Os nomes em negrito são os dos botões e menus do app, que aparecem em inglês.

Nesta página
  1. Primeiros passos
  2. Baralhos e pastas
  3. Documentos
  4. Cartões
  5. Baralhos de vocabulário
  6. Estudar
  7. Questionários
  8. Explorar e buscar
  9. Importar, backup e sincronização
  10. Estatísticas
  11. Configurações
  12. Atalhos e gestos
  13. Relatar um problema
  14. Solução de problemas

Primeiros passos

  1. Crie uma conta com seu e-mail e uma senha (de pelo menos 8 caracteres). Seus baralhos ficam salvos nesta conta, então você pode entrar de qualquer navegador ou dispositivo.
  2. Siga a lista Getting Started: contas novas veem em Today uma lista interativa com os passos essenciais (escolher um modelo inicial, ler notas de exemplo, revisar seus 5 primeiros cartões). Ela acompanha seu progresso e pode ser ocultada ou reaberta a qualquer momento em Settings.
  3. Crie um baralho: na barra lateral, escolha New Deck (uma conta nova começa com um baralho vazio, com uma tela inicial para escrever Markdown, enviar um arquivo PDF ou Word, ou adicionar um modelo inicial). Um baralho guarda os dois tipos de cartão: Knowledge (pergunta e resposta) e Word (uma palavra ou expressão de um idioma), cada um em sua própria aba da tela Flashcards. Ou Importe um baralho do Anki que você já tenha.
  4. Adicione algo para aprender: escreva ou cole a lição no Document do baralho e deixe a IA gerar cartões, ou escreva os cartões você mesmo.
  5. Revise um pouco todo dia: abra Today e pressione Start Review (ou Space).

Para se orientar

  • Barra lateral — Decks Tree: suas pastas e baralhos. Ao lado de cada um há três números: os cartões New (novos), em Learning (aprendizado) e Due (a revisar) hoje. O botão Pin alterna entre Pinned (fixa, empurra o conteúdo da página) e Floating (flutuante, fecha sozinha quando você clica fora).
  • Barra superior: Decks (Today), Browse, Stats, Sync, além de Create Card, a lista de atalhos, Settings e o menu da sua conta.
  • Today: o que está para revisar nos seus baralhos, seus baralhos recentes e abas para os baralhos Knowledge e Vocab.
  • No celular: as seções ficam em uma linha sob o cabeçalho, e Today lista sua Decks Tree, os baralhos Recent e as Tags. Todo o resto funciona igual.

Baralhos e pastas

  • Deck e Folder ficam no fim da barra lateral. As pastas podem conter baralhos e subpastas; arraste um baralho ou pasta para movê-lo.
  • Clique com o botão direito em um baralho ou pasta (ou use o botão ⋯) para Study now, Rename, Duplicate, Deck settings…, criar novos baralhos dentro de uma pasta e Delete. Clique duas vezes em um nome (ou pressione F2) para renomeá-lo.
  • Abrir uma pasta mostra os baralhos dela e permite estudar todos de uma vez.
  • Um baralho tem duas abas: Document e Flashcards. Study inicia uma revisão só desse baralho.

Excluir um baralho remove o Documento, os cartões e o histórico de revisões dele. Exporte um backup antes (veja Importar, backup e sincronização) se talvez queira recuperá-lo.

Documentos

O Documento é a lição por trás de um baralho. Os cartões e os questionários são gerados a partir dele, e cada cartão gerado lembra de qual seção veio.

  • Abas do Documento e navegação fixa: organize as lições em várias abas de Markdown ou PDF. Ao rolar notas longas ou ao editar, a barra de abas e as ferramentas ficam fixas no topo para você nunca perder o lugar.
  • Edit (E) abre o editor. Ele entende Markdown: títulos, negrito, listas, tabelas, código, links, imagens e diagramas Mermaid. Salve com Ctrl+S.
  • Selecione qualquer texto para abrir um menu: Explain in detail, Give illustrative examples ou Simplify (a IA responde ao lado do texto; arraste o cabeçalho para movê-la e o canto inferior direito para redimensioná-la), Ask AI about this… (sua própria pergunta sobre o trecho), Create new Flashcard (Ctrl+N / ⌘N onde o navegador permitir), Generate quiz (um questionário curto só sobre aquela parte), Read aloud e Copy excerpt. O mesmo menu aparece no texto de um cartão durante a revisão.
  • Add to Document: tanto nas janelas de IA da seleção quanto no chat do Ask AI, clique em Add to Document para inserir a explicação direto nas suas notas como um destaque formatado, com o trecho citado e o contexto.
  • Ask AI abre um chat sobre o Documento. As perguntas seguintes mantêm o contexto da conversa, e uma resposta de Explain / Simplify / Example pode continuar ali com Ask follow-up. Toque no microfone para falar sua pergunta: ela vira texto que você pode conferir antes de enviar. Cada resposta pode ser copiada, adicionada ao documento ou transformada em um Flashcard. A conversa fica guardada neste navegador; New chat recomeça do zero.
  • Export: exporte qualquer aba do Documento para Markdown (.md), Word (.doc), PDF (.pdf) ou um backup completo do baralho, Deck backup (.json), com layout limpo e formatação preservada.
  • Edit with AI aparece ao lado do texto que você seleciona no editor do Documento (no celular, acima do teclado) e o reescreve: transformá-lo em diagrama ou tabela, fazer tópicos, reescrever com mais clareza, acrescentar um exemplo, corrigir a ortografia — ou descrever a sua própria mudança. Você vê o resultado antes que ele substitua qualquer coisa.
  • Beautify (no editor) deixa a página inteira mais fácil de ler: primeiro arruma o Markdown (sintaxe dos títulos, linhas em branco e marcadores de lista), depois acrescenta quebras de parágrafo onde a ideia muda, coloca em negrito os termos-chave e põe termos estrangeiros ou técnicos e exemplos em itálico. Você escolhe quais das três coisas fazer e quanta ênfase (Light, Balanced ou Rich). Suas palavras nunca mudam — o app recusa qualquer resposta que as altere — e código, tabelas e imagens são deixados como estão. A pré-visualização mostra o resultado na hora; Undo (ou Ctrl+Z) traz a página antiga de volta.
  • Analyze mostra Knowledge Coverage: os conceitos do Documento e quais deles ainda não têm cartão. Generate Missing Flashcards preenche as lacunas.

Títulos (## Conceito) e termos-chave em negrito ajudam a IA e o Knowledge Coverage a encontrar os conceitos do seu Documento.

Cartões

Escrever cartões

  • Create Card (A) abre o editor de cartões: um Front (a pergunta), um Back (a resposta), o baralho e as etiquetas.
  • Os dois lados aceitam formatação, listas, código, imagens, áudio, vídeo e diagramas. Para adicionar uma foto, envie uma, cole ou solte, busque uma ou cole o link de uma imagem.
  • Adicione uma typed answer (resposta digitada) para praticar escrevendo a resposta: na revisão você a digita e vê o que acertou, letra por letra.
  • Source liga o cartão a um trecho do Documento, para você voltar ao contexto enquanto estuda.

Gerar cartões com IA

Na aba Document, escolha Generate Flashcards (ou Generate with AI na aba Flashcards). Selecione o texto antes se quiser usar só aquela parte do Documento. Depois escolha:

  • Um estilo: One card per item, Vocabulary, Q&A, Fill in the blank ou Reverse — ou escreva suas próprias Instructions.
  • O Number of Cards (número de cartões) e a Difficulty (dificuldade: fácil, média, difícil).

Você revisa os rascunhos antes de adicioná-los: edite qualquer cartão, remova os que não quiser e adicione o resto ao baralho.

Se o servidor não tiver chave de IA, os recursos de IA continuam funcionando com regras simples embutidas — úteis para experimentar o app, mas com resultados bem mais básicos. Settings → AI mostra qual você está usando.

Baralhos de vocabulário

Os cartões Word transformam uma lista de palavras em cartões completos: uma foto, o significado, a pronúncia (IPA) com áudio, uma frase de exemplo e sua tradução — tudo preenchido para você e editável depois.

  1. Em Deck settings…, marque This deck is for learning a language e escolha o Language you are learning e o idioma de Meanings and translations (sem isso, as palavras usam inglês → vietnamita).
  2. Escolha Generate Flashcards, digite as palavras uma por linha — ou use Find words in the Document para escolhê-las de um texto — escolha a voz do áudio (cada voz mostra o preço e quantos caracteres vai ler) e gere.
  3. Ative Play the card’s audio when each side shows em Deck settings para ouvir cada palavra quando ela aparecer. Pressione R na revisão para repetir — ou toque no botão de reproduzir de um som — e pressione de novo em poucos segundos para ouvir devagar (aparece uma tartaruga); mais uma vez e volta à velocidade normal.

Encontrou uma palavra nova lendo um Documento ou revisando um cartão? Selecione-a e escolha Add as a word, e o cartão completo da palavra é criado nesse mesmo baralho.

Listas longas de palavras podem levar até um minuto. Qualquer pacote do Anki também pode ser importado como cartões de palavras.

Estudar

Start Review em Today estuda tudo o que está pendente; Study em um baralho ou pasta estuda só aquilo. Cada cartão mostra primeiro a pergunta — tente lembrar a resposta, depois revele-a (Space) e avalie-se com honestidade:

BotãoTeclaQuando usar
Again1Você não lembrou. O cartão volta logo.
Hard2Você lembrou, com esforço de verdade.
Good3Você lembrou normalmente. A escolha habitual.
Easy4Na hora e sem esforço. O cartão espera bem mais.

O agendador FSRS usa suas notas para calcular quanto você sabe cada cartão e quando está prestes a esquecê-lo. Cada botão mostra quando o cartão vai voltar. Alguns minutos por dia bastam; quando não há nada pendente você verá All caught up for today.

Durante a revisão

  • Undo (Ctrl+Z) desfaz a última resposta; E edita o cartão atual; H abre a dica dele. Um cartão Knowledge sem dica própria tem um botão AI hint (ou H): a IA lê a pergunta e a resposta e dá um empurrãozinho sem entregar a resposta; ele usa sua cota de IA.
  • V lê o cartão em voz alta (ou só o texto que você selecionou); ← → passam entre as partes enquanto ele lê.
  • Ask AI (o botão de balão de fala) conversa sobre o cartão atual, digitando ou falando. Antes de você mostrar a resposta, ele dá dicas em vez da resposta; cada cartão guarda a sua própria conversa.
  • No celular, deslize o cartão ou toque duas vezes para responder (veja Atalhos e gestos), e use Focus para mostrar só o cartão e seu progresso.
  • Esc sai da revisão. Seu progresso é salvo após cada cartão.

Questionários

Um questionário confere uma lição inteira de uma vez. Escolha Generate Quiz na aba Document (ou Quiz no texto selecionado), defina o número de perguntas e a dificuldade e responda perguntas de múltipla escolha, verdadeiro/falso, preencher lacunas e resposta curta.

No final, Quiz Complete mostra o que você sabe bem (Strong) e o que Needs Review. Flashcards for weak areas transforma os pontos fracos em cartões para o seu baralho.

Explorar e buscar

  • Search (Ctrl+K ou /) encontra cartões, baralhos e etiquetas de qualquer lugar.
  • Browse (B) lista todos os seus cartões em uma tabela. Filtre com palavras, tag:nome (ou #nome) e deck:nome; use as abas para cartões a revisar, em aprendizado, novos e suspensos; ordene e escolha as colunas.
  • Selecione cartões (X ou Ctrl+clique) para Move to deck…, Suspend / Unsuspend, Reset to new, Duplicate ou Delete vários de uma vez.

Um cartão suspenso (suspended) continua no baralho, mas fica fora das revisões até você tirar a suspensão.

Importar, backup e sincronização

Importar do Anki

Import na barra lateral aceita pacotes do Anki (.apkg, .colpkg) com suas imagens e áudio, mantendo a estrutura de baralhos. Para cada pacote, você escolhe se ele vira cartões de conhecimento ou de palavras. Pacotes grandes continuam sendo importados em segundo plano — o painel no canto mostra o progresso.

Sincronização

Tudo é salvo na sua conta enquanto você trabalha e acompanha você em qualquer dispositivo em que entrar. Sync Now na barra superior envia as alterações pendentes imediatamente.

Backup

Na página Sync, Export JSON baixa uma cópia de todos os seus baralhos, documentos, cartões e histórico de revisões. Import JSON restaura uma cópia assim — ela substitui tudo o que há agora na sua conta. Reset sample data apaga seus dados e restaura os baralhos de exemplo.

Estatísticas

Stats mostra os cartões estudados hoje, sua taxa de Again, o total de revisões, quantos cartões você tem em cada estado, suas revisões dos últimos 14 dias e uma previsão dos cartões a revisar nos próximos 14 dias.

Configurações

Abra Settings com o ícone de engrenagem na barra superior. As alterações valem na hora.

SeçãoO que você pode mudar
AccountVer com qual conta você entrou e sair.
AppearanceO tema (Light, Dark ou o do sistema) e se os gestos de deslizar / tocar duas vezes estão ativos na revisão. Ambos ficam salvos só neste navegador.
AIMostra se a IA está conectada (com Test connection) ou funcionando com as regras embutidas offline.
Read aloudGoogle voice (natural, igual em todos os dispositivos, dentro de uma cota mensal mostrada aqui) ou Browser voice (grátis e ilimitada; a qualidade depende do dispositivo). Em Settings → Text-to-Speech & Voices, escolha uma voz do Google para cada idioma, defina a velocidade de reprodução e a reprodução automática do áudio dos cartões, ou use o padrão do app. Suas escolhas acompanham sua conta. Quando a cota acaba, a voz do navegador assume.
Daily LimitsNew cards/day e Maximum reviews/day, por baralho. Ambos são ilimitados até você digitar um número; esvazie a caixa para voltar a ilimitado.
FSRS SchedulerDesired retention (90% por padrão): quanto mais alto, mais você lembra, mas mais vezes revisa.
Help & FeedbackEnviar comentários, entrar na comunidade do Discord e abrir este guia.

Cada baralho também tem seus próprios Deck settings…: o nome dele e, em um baralho que ensina um idioma, os idiomas e a reprodução automática do áudio.

Atalhos e gestos

Pressione ? no app para ver esta lista a qualquer momento. A lista abaixo é a do próprio app, por isso aparece em inglês.

Global

Ctrl+K / /Search cards, decks, tags
Space / SStudy the current deck, or the open tab (Knowledge / Vocab) on Today and folders
VVoice study (Pro): the same, out loud
AAdd card
DDecks overview
BBrowse all cards
[Show / hide the sidebar
?Show this list

Review

Space / EnterShow answer, then Good
1 2 3 4Again · Hard · Good · Easy
EEdit current card
RReplay the card’s audio
HOpen / close the card’s hint
EnterIn the answer box: check the typed answer
MVoice review (Pro; started with "Study by speaking" or the mic in the header): the question is read aloud, then recording starts by itself; Space or P pauses it while you think (and goes on), M or Enter ends and sends it; AI checks it and suggests a rating
VRead aloud: the selection, or the whole side (skips code and diagrams); while reading, pause / resume
← →While reading aloud: previous / next part (or click a line)
Ctrl+ZUndo last answer
EscStop reading aloud, or leave review

Quiz

1 2 3 4Choose an option
EnterCheck a typed answer, then the next question
Space / →Next question
P / ←Previous question
BFlag the question to come back to
FFocus: just the quiz
EscSave and leave (the quiz goes on where you left off)

Listening (a turn during study)

↑Play the word again
↓Play it slowly
EnterCheck, then take the suggested grade
1 2 3 4Grade it yourself: Again / Hard / Good / Easy
EscLeave the box, then leave the study session

Document

EEdit document
FFocus: just the document (Esc to leave)
Ctrl+SSave document
Ctrl+B / Ctrl+I / Ctrl+KBold · Italic · Link
Select textExplain · Simplify · Example · Quiz · Flashcard

Decks tree & card table

↑ ↓ ← →Move · collapse · expand
Enter / EOpen deck · edit card
F2Rename deck or folder
DelDelete
X / Ctrl+ClickSelect card

Touch (phones)

Swipe ←On the question: show the answer. On the answer: Good
Swipe →On the answer: Again
Double-tap rightOn the question: show the answer. On the answer: Good
Double-tap leftOn the answer: Again
UndoUndo the last answer from the review header or with Ctrl+Z
Select textRead the selection aloud
Tap a lineWhile reading aloud: read from there

Relatar um problema

Encontrou um bug ou tem uma ideia para melhorar o Docki? Conte para nós de dentro do app:

  1. Abra o menu da sua conta (suas iniciais, no canto superior direito) e escolha Send feedback — ou vá em Settings → Help & Feedback.
  2. Escolha Report a bug ou Suggest an idea, dê um título curto e descreva. Para um bug, diga o que você fez, o que aconteceu e o que esperava.
  3. Adicione até 3 capturas de tela: Add um arquivo, ou simplesmente cole uma captura (Ctrl+V) na caixa de diálogo.
  4. Se as duas opções estiverem disponíveis, escolha como enviar em Send via: Email (respondemos para o e-mail da sua conta) ou Discord (publicado no Discord da equipe). Depois pressione Send.

Junto com a sua mensagem recebemos o e-mail da sua conta e a página em que você estava, para reproduzir o problema e responder a você. Você pode enviar até 5 relatos a cada 10 minutos.

Prefere conversar? Join our Discord (no menu da conta, na caixa de comentários e em Settings) para fazer perguntas, acompanhar as novidades e conversar com outros estudantes.

Solução de problemas

A barra lateral diz “Offline”.
O Docki não consegue alcançar o servidor agora. Mantenha a aba aberta: suas alterações são guardadas e enviadas assim que a conexão voltar. Fechar a aba antes de ela dizer Synced de novo pode fazer você perdê-las.
As respostas da IA parecem muito básicas.
O servidor não tem chave de IA, então as regras embutidas estão sendo usadas. Settings → AI mostra o estado atual.
A leitura em voz alta soa robótica ou parou de usar a voz do Google.
Sua cota mensal de voz do Google pode ter acabado (veja Settings → Read aloud) e a voz do navegador assumiu. O Microsoft Edge tem as vozes de navegador mais naturais.
Nada para revisar hoje.
Todos os cartões pendentes foram feitos, ou um limite diário que você definiu foi atingido. Aumente ou remova o limite em Settings → Daily Limits, ou use Study em um baralho para continuar.
Deslizar no celular volta para a página anterior.
Comece o gesto sobre o cartão, não na borda da tela — essa borda é o Voltar do navegador. Os gestos podem ser desativados em Settings → Appearance.
Há outro problema.
Avise-nos com uma captura de tela — isso nos ajuda muito.