Sobre o projeto

## Visão geral GRE 镇考 3000 é um aplicativo web progressivo (PWA) de aprendizado de vocabulário GRE puramente front-end, projetado para candidatos que se preparam para o GRE. Ele inclui o banco de palavras completo de "GRE 镇考 3000 词（乱序版）" (3.275 entradas, com definições em chinês, transcrição fonética e frases de exemplo em inglês) e utiliza a curva de esquecimento de Ebbinghaus para programar os intervalos de revisão, ajudando os usuários a memorizar palavras com eficiência. ## Funcionalidades principais - **Novas palavras diárias**: por padrão, 100 novas palavras por dia, ajustável nas configurações (50–150, em incrementos de 10). As novas palavras são selecionadas das palavras ainda não estudadas, seguindo a ordem da lista embaralhada. - **Revisão espaçada de Ebbinghaus**: cada cartão possui 8 estágios (0–7), com intervalos de 8 minutos a 15 dias, ajustados dinamicamente pelo fator de facilidade conforme o desempenho do usuário (valor inicial 2,5; acerto +0,1; erro −0,2). O tempo real de espera = intervalo base × (facilidade / 2,5). - **Formato de revisão**: exibe a palavra em inglês e o usuário escolhe a definição correta em chinês entre 4 opções (1 correta + 3 distratoras). - **Disponível offline**: o banco de palavras é empacotado com o aplicativo. Após o primeiro acesso, o Service Worker armazena em cache o shell do app e os dados do banco de palavras, permitindo estudar mesmo sem conexão. - **Instalável como PWA**: suporta adição à tela inicial do celular (iOS Safari / Android Chrome), executando em janela independente. - **Aplicativo desktop**: fornece pacote de instalação para macOS (empacotado com Electron); também é possível compilar localmente uma versão para Linux. - **Atalhos de teclado**: na página de novas palavras, Espaço/Enter expande a definição; 1/2/3 marcam respectivamente não conheço / vago / conheço. Na página de revisão, 1–4 selecionam a resposta; Espaço/Enter avança para a próxima pergunta. ## Interface e navegação Quatro entradas na parte inferior: - **Hoje**: painel de progresso, mostrando o status de estudo do dia, dias consecutivos de prática etc. - **Estudar**: página de aprendizado de novas palavras, com a palavra em cima e a definição recolhida por padrão; clique no cartão ou pressione Espaço para expandir. Abaixo, três botões: não conheço, vago, conheço. - **Revisar**: página de revisão, com a palavra em cima e quatro opções dispostas verticalmente. - **Banco de palavras**: filtra por não estudadas, em revisão e dominadas; a definição só aparece ao abrir a palavra. Palavras que entram no estágio de 7 dias são marcadas como dominadas. ## Implementação técnica - **Framework front-end**: construído com Vite, usando React (ou framework semelhante; não especificado explicitamente, mas compatível com práticas modernas de front-end). - **Suporte a PWA**: gera o Web App Manifest e o Service Worker por meio do vite-plugin-pwa (Workbox), implementando cache offline e instalabilidade. - **Armazenamento de dados**: todo o progresso de estudo é salvo no localStorage do navegador (chave gre3000.vocab.v1), sem depender de servidor backend. - **Análise do banco de palavras**: o banco original vem do PDF de "GRE 镇考 3000 词（乱序版）". Um script Python (pymupdf) analisa as tabelas, remove marcas d'água, une palavras quebradas entre linhas, remove duplicatas e gera o arquivo JSON. ## Como usar ### Uso online Acesse diretamente https://gre-3000-vocab.vercel.app para começar a estudar. Recomenda-se adicionar à tela inicial do celular para a melhor experiência. ### Execução local ```bash git clone https://github.com/jayden-dong411/gre-3000-vocab.git cd gre-3000-vocab npm install npm run dev ``` O servidor de desenvolvimento roda por padrão em http://127.0.0.1:43173. ### Build de produção ```bash npm run build npm run preview ``` Os artefatos de build ficam no diretório dist/ e podem ser implantados em qualquer hospedagem estática. ### Aplicativo desktop Baixe o pacote de instalação para macOS em GitHub Releases, ou execute localmente `npm run desktop` para abrir a janela diretamente; use `npm run pack:mac` / `npm run pack:linux` para empacotar e distribuir. ## Observações - Trocar de dispositivo não sincroniza o progresso de estudo (porque os dados são armazenados localmente no navegador). - A instalação na tela inicial do celular requer HTTPS (exceto em localhost). - O pacote de instalação do macOS não é notarizado pela Apple; na primeira abertura, o sistema pode bloqueá-lo. Execute o comando `xattr -cr` no terminal para liberar. ## Resumo GRE 镇考 3000 é uma ferramenta completa e bem projetada para aprendizado de vocabulário GRE, aproveitando ao máximo a capacidade offline e a instalabilidade do PWA, além de oferecer suporte a aplicativo desktop. Seu algoritmo de revisão de Ebbinghaus considera o desempenho do usuário, sendo mais flexível do que intervalos fixos. A origem do banco de palavras é clara e o processo de análise é transparente. É adequado para candidatos que precisam memorizar sistematicamente o vocabulário do GRE.