Assistente de aprendizado de idiomas por imersão

O illa-helper é um plug-in de navegador de código aberto projetado para ajudar os usuários a aprender um idioma estrangeiro por meio de uma experiência imersiva. Ele fornece traduções em tempo real, guias de pronúncia e análise de vocabulário durante a navegação na Web. O plug-in é compatível com os navegadores Chrome e Firefox e é baseado na estrutura Vue 3, que é clara e fácil de estender. Os usuários podem personalizar as configurações, como ajustar o modelo de tradução ou a chave da API. O illa-helper é especialmente adequado para alunos que desejam aprimorar naturalmente suas habilidades linguísticas durante a navegação diária. O projeto está hospedado no GitHub e os desenvolvedores podem contribuir e otimizar os recursos.

Lista de funções

• Tradução em tempo real: traduzir o texto de um idioma estrangeiro em uma página da Web para um idioma com o qual o usuário esteja familiarizado.
• Assistência à pronúncia: fornece a pronúncia de palavras ou frases por meio do Youdao TTS e da Web Speech API.
• Análise de vocabulário: exibe os símbolos fonéticos, as definições e os exemplos de frases das palavras e oferece suporte a uma interface interativa.
• Configurações personalizadas: suporta chaves de API configuráveis pelo usuário, modelos de tradução e parâmetros de temperatura.
• Suporte a vários navegadores: compatível com o Chrome e o Firefox, adaptando-se a diferentes recursos do navegador.
• Interface Hoverbox: fornece hoverboxes intuitivos que exibem informações de tradução e pronúncia.
• Armazenamento off-line: salva as configurações do usuário e garante que as experiências personalizadas sejam sincronizadas entre os dispositivos.

Usando a Ajuda

Processo de instalação

1. Faça o download do código-fonte do plug-in
   entrevistas https://github.com/xiao-zaiyi/illa-helperClique no botão "Code" (Código) e selecione "Download ZIP" (Baixar ZIP) para baixar o código-fonte ou use o comando Git para clonar o repositório:

   git clone https://github.com/xiao-zaiyi/illa-helper.git
   

2. Instalação de dependências
   Depois de extrair os arquivos, vá para o diretório do projeto e execute o seguinte comando para instalar as dependências necessárias:

   npm install
   

   Certifique-se de que o Node.js e o npm estejam instalados.

3. Configuração de variáveis de ambiente
   No diretório raiz do projeto, crie o arquivo .env adicione chaves e configurações de API, por exemplo:

   VITE_WXT_DEFAULT_API_KEY="sk-your-real-api-key"
   VITE_WXT_DEFAULT_API_ENDPOINT="https://xxxxx/api/v1/chat/completions"
   VITE_WXT_DEFAULT_MODEL="gpt-4"
   VITE_WXT_DEFAULT_TEMPERATURE="0.2"
   

   Essas configurações são usadas para se conectar aos serviços de tradução e pronúncia. Atenção:.env A documentação foi adicionada .gitignoreA chave está protegida.

4. Criação de plug-ins
   Execute o comando de compilação com base no navegador de destino:
   • Cromado/Edge:

     npm run build:chrome
     

   • Firefox:

     npm run build:firefox
     

   Quando a compilação estiver concluída, o arquivo de saída estará localizado em .output/chrome-mv3(Chrome) ou .output/firefox-mv2(Firefox).

5. Carregando plug-ins
   • CromadoAbra seu navegador e vá para chrome://extensions/Se quiser ativar o "Developer Mode", clique em "Load Extensions" e selecione "Load Extensions". .output/chrome-mv3 Pasta.
   • Firefox: Acesso about:debugging#/runtime/this-firefoxClique em "Load Temporary Add-ons" (Carregar complementos temporários) e escolha .output/firefox-mv2 pasta. O plug-in será carregado automaticamente.

Uso

Após a instalação, o illa-helper será executado em seu navegador. Abaixo está o procedimento detalhado para as principais funções:

tradução em tempo real

1. Abra qualquer página da Web e selecione o texto a ser traduzido.
2. O plug-in detecta automaticamente o conteúdo do idioma estrangeiro e exibe os resultados da tradução em uma caixa de foco.
3. Os usuários podem clicar no botão "Copiar" na caixa de foco para salvar a tradução na área de transferência.
4. Se quiser alterar o idioma da tradução, vá para a página de opções do plug-in (clique com o botão direito do mouse no ícone do plug-in e selecione "Opções") e defina o idioma de destino.

Auxílio à pronúncia

1. Selecione a palavra ou frase e a caixa de foco exibirá o botão de pronúncia (🔊).
2. Clique no botão Pronunciation (Pronúncia) e o plug-in reproduzirá o áudio por meio do Youdao TTS ou da Web Speech API.
3. O usuário pode ajustar a velocidade de articulação ou o tipo de voz (a ser configurado na página Options (Opções)).

análise lexical

1. A caixa de foco exibe os símbolos fonéticos, as definições e as frases de exemplo do texto selecionado.
2. Clique no botão "More" (Mais) para ver informações detalhadas do dicionário (por exemplo, propriedades da palavra, sinônimos).
3. Se você precisar salvar o vocabulário, clique em "Add to Dictionary" (Adicionar ao dicionário) e o plug-in armazenará o vocabulário localmente.

Configurações personalizadas

1. Abra a página de opções do plug-in e modifique a chave de API ou o modelo de tradução (padrão) gpt-4).
2. adaptar VITE_WXT_DEFAULT_TEMPERATURE (0,0-1,0), que controla a criatividade da tradução (valores mais baixos são mais precisos, valores mais altos são mais flexíveis).
3. Quando as configurações estiverem concluídas, clique em "Save" (Salvar) e o plug-in sincronizará automaticamente a configuração.

advertência

• Garanta uma conexão estável com a Internet para que as funções de tradução e pronúncia funcionem corretamente.
• Os usuários do Firefox devem observar que o plug-in requer um ID específico para sua funcionalidade de armazenamento no Firefox, que já está no arquivo wxt.config.ts Configuração média:

  browser_specific_settings: {
  gecko: {
  id: 'illa-helper@xiao-zaiyi',
  strict_min_version: '88.0'
  }
  }
  

• Se você estiver enfrentando problemas de conectividade da API, verifique o .env e a configuração do ponto de extremidade no arquivo.

cenário do aplicativo

1. estudo de idiomas estrangeiros
   Estudantes ou autodidatas usam o illa-helper para obter tradução e pronúncia em tempo real, entender rapidamente o conteúdo e aprender novo vocabulário enquanto navegam em sites de idiomas estrangeiros.
2. pesquisa acadêmica
   Quando os pesquisadores leem literatura em idioma estrangeiro, o plug-in traduz a terminologia e salva as palavras brutas para melhorar a eficiência da leitura.
3. Navegação diária
   Os falantes não nativos usam plug-ins para entender rapidamente o conteúdo em idioma estrangeiro e melhorar o acesso às informações ao navegar nas mídias sociais ou nas notícias.
4. Depuração do desenvolvedor
   Os desenvolvedores podem testar diferentes modelos de tradução ou APIs para otimizar o desempenho do plug-in, modificando o código-fonte ou a configuração.

QA

1. Quais navegadores são compatíveis com o illa-helper?
   Atualmente, o Chrome e o Firefox são compatíveis, com o Chrome Manifest V3 e o Firefox Manifest V2, respectivamente.
2. Preciso pagar para usá-lo?
   O illa-helper é um projeto de código aberto e de uso gratuito. No entanto, você precisa obter a chave da API para o serviço de tradução ou pronúncia, o que pode envolver custos.
3. Como faço para atualizar o plug-in?
   Extraia o código mais recente do GitHub e execute novamente o processo de compilação e carregamento para atualizar.
4. E se a tradução não for precisa?
   Verifique a chave da API e a configuração do modelo, ou tente ajustar o VITE_WXT_DEFAULT_TEMPERATURE Parâmetros.
5. Ele pode ser usado off-line?
   Alguns recursos (por exemplo, armazenamento local) são suportados off-line, mas o acesso à Internet é necessário para a tradução e a pronúncia.