Spegel: usando IA para transformar as páginas da Web em uma experiência de navegação de ponta a ponta

O Spegel é um navegador da Web de terminal de código aberto. Ele usa Inteligência Artificial (IA) para converter o conteúdo HTML de páginas da Web em um formato markdown conciso, adequado para navegação em terminais. Os usuários podem personalizar a visualização da navegação, como simplificar o conteúdo ou extrair informações importantes. O Spegel usa uma estrutura leve, litellm, compatível com uma variedade de modelos de linguagem, o uso padrão do Gêmeos 2.5 Flash Lite. É fácil de configurar e tem uma interface amigável para quem prefere operar no terminal. O projeto está hospedado no GitHub, mantido pelo desenvolvedor SimEdw, com uma comunidade ativa e atualizações contínuas.O Spegel foi originalmente projetado para tornar o conteúdo da Web mais legível, reduzir informações redundantes e proporcionar uma experiência de navegação eficiente.

Lista de funções

• Conversão de conteúdo da Web: converta o HTML de páginas da Web complexas em um formato markdown limpo.
• Visualizações personalizadas: suporte a vários modos de visualização definidos pelo usuário por meio de perfis, como a simplificação para o nível infantil (ELI5) ou a extração de ações-chave.
• Suporte a vários modelos de IA: compatível com vários modelos de idiomas nativos ou externos por meio da estrutura litellm.
• Otimização da interface do terminal: renderização de markdown usando a estrutura Textual para proporcionar uma experiência de navegação intuitiva no terminal.
• Configuração dinâmica: oferece suporte à visualização em tempo real e a ajustes de palavras-chave durante a navegação.
• Operação leve: suporta apenas solicitações GET, não depende de JavaScript e é executado com eficiência.
• Suporte à comunidade de código aberto: hospedado no GitHub, os usuários são bem-vindos para contribuir com código e feedback.

Usando a Ajuda

Processo de instalação

O processo de instalação do Spegel é simples e adequado para usuários que estejam familiarizados com operações de linha de comando. Veja a seguir as etapas detalhadas:

1. projeto de clonagem
   Execute o seguinte comando no terminal para clonar o projeto Spegel localmente:

   git clone https://github.com/simedw/spegel.git
   cd spegel
   

2. Instalação de dependências
   Use o pip do Python para instalar as dependências e as ferramentas de linha de comando necessárias:

   pip install -e .
   

   Isso instala o Spegel e suas dependências Python, incluindo o litellm e o Textual.

3. Configuração de variáveis de ambiente
   O Spegel usa o modelo Gemini 2.5 Flash Lite por padrão e requer a definição de uma chave de API. Como criar um .env consulte o arquivo env_example.txtAdicione o seguinte:

   GEMINI_API_KEY=你的API密钥
   

   Você pode obter a chave por meio da Gemini ou de outros provedores de modelos compatíveis.

4. Iniciar Spegel.
   Após a conclusão da instalação, inicie o Spegel com o seguinte comando:

   spegel bbc.com
   

   Isso carregará diretamente a página da Web especificada e exibirá a tela de boas-vindas. Você pode usá-lo se quiser ignorar a tela de boas-vindas e navegar diretamente na página da Web:

   spegel <网页URL>
   

Configuração de exibições personalizadas

O principal recurso do Spegel é o suporte a exibições de navegação definidas pelo usuário. O arquivo de configuração está localizado no diretório ~/.spegel.tomlque pode ser modificado por um editor de texto. Um exemplo do arquivo de configuração padrão é mostrado abaixo:

[settings]
default_view = "terminal"
app_title = "Spegel"
[ai]
default_model = "gpt-4.1-nano"
[[views]]
id = "raw"
name = "Raw View"
hotkey = "1"
order = "1"
prompt = ""
[[views]]
id = "terminal"
name = "Terminal"
hotkey = "2"
order = "2"
prompt = "Transform this webpage into the perfect terminal browsing experience!"

• default_viewVisualização do navegador padrão: defina a visualização do navegador padrão, por exemplo. terminal.
• default_modelModelo de IA: Especifique o modelo de IA a ser usado; o padrão é gpt-4.1-nano ou outros modelos compatíveis.
• visualizaçõesVisualização: Define diferentes modos de visualização. Cada visualização contém uma ID, um nome, uma tecla de atalho e uma palavra de aviso. Por exemploterminal A visualização otimizará a página da Web para o formato de navegação do terminal.
• imediatoOs usuários podem personalizar os prompts para controlar como a IA lida com o conteúdo da Web. Por exemplo, uma configuração de "Simplify web pages to be understood by 5 year olds" (Simplificar páginas da Web para serem compreendidas por crianças de 5 anos) produziria um resultado mais simples.

Depois de modificar o arquivo de configuração, salve e execute novamente o Spegel, e a nova visualização entrará em vigor imediatamente.

Funções principais

1. Navegar na web
   importação spegel <URL> A página pode ser carregada. Exemplo:

   spegel https://simedw.com
   

   O Spegel processa o conteúdo da Web por meio de IA, converte-o para o formato markdown e o renderiza no terminal.

2. Alternar visualização
   Durante a navegação, você pode usar teclas de atalho (por exemplo 1e2) para alternar entre diferentes visualizações. Por exemplo.terminal visualização otimizada para o layout do conteúdo.recipe A visualização é dedicada a extrair os ingredientes e as etapas de uma receita. Os atalhos são definidos no arquivo de configuração.
3. Ajuste dinâmico de dicas
   Os usuários podem alterar os prompts em tempo real enquanto navegam. Por exemplo, se você inserir o novo prompt "Extrair ações-chave de uma página da Web" e salvá-lo, o Spegel processará novamente a página da Web atual para destacar as etapas de ação.
4. Manuseio de grandes páginas da Web
   Para páginas com muito conteúdo, o Spegel processa o HTML em partes para garantir a integridade. Os desenvolvedores corrigiram o problema de truncamento de páginas grandes nas versões anteriores, para que os usuários possam navegar em páginas complexas com confiança.

Operação da função em destaque

• Extração de receitas
  A Spegel oferece um serviço especializado de recipe adequado para acesso rápido às informações da receita. Por exemplo, ao navegar em um site de receitas, o Spegel extrai as principais informações no seguinte formato:

  # Ingredients
  * 1 tbsp salt
  * 400 g beef
  # Steps
  1. Preheat the oven to 200°C.
  2. Wash and chop the carrots.
  

  Para usar esse recurso, certifique-se de que o arquivo de configuração tenha ativado a opção recipe Ver (enabled = true) e, em seguida, alternar para essa visualização com uma tecla de atalho.

• Experiência em otimização de terminais
  O Spegel usa a estrutura Textual para renderizar o markdown com uma interface clara que suporta rolagem e interação. Os usuários podem navegar pelo conteúdo com as setas para cima e para baixo, pressionar q Sair.
• Suporte a vários modelos
  Com o litellm, o Spegel oferece suporte a uma ampla variedade de modelos de IA. Os usuários podem alterar o default_modelou especificar outros modelos (por exemplo, GPT-4) por meio de variáveis de ambiente. Isso proporciona ao usuário a flexibilidade de selecionar um modelo mais avançado, conforme necessário.

advertência

• Certifique-se de que sua conexão com a Internet esteja estável, pois o Spegel requer solicitações GET para o conteúdo da Web.
• Se o markdown for renderizado com erros de formatação, verifique se a visualização correta está ativada ou se o conteúdo da página está totalmente carregado.
• Para páginas da Web dinâmicas que exigem JavaScript, o Spegel não oferece suporte no momento e recomenda a escolha de páginas da Web com conteúdo estático.

cenário do aplicativo

1. Extraia rapidamente o conteúdo principal de uma página da Web
   Os usuários precisam extrair informações importantes de páginas da Web extensas, como receitas, resumos de notícias ou tutoriais passo a passo, e as exibições personalizáveis do Spegel simplificam rapidamente o conteúdo complexo em um formato markdown fácil de ler.
2. Navegação na Web para usuários finais
   Programadores ou usuários que preferem operações de linha de comando querem navegar na Web em um terminal sem precisar abrir um navegador de interface gráfica.
3. Processamento de conteúdo personalizado
   Os usuários querem personalizar a apresentação das páginas da Web de acordo com suas necessidades, por exemplo, simplificando a documentação técnica em algo que os iniciantes possam entender ou otimizando um site de compras para obter informações importantes sobre o produto.
4. Aprendizado e depuração de dicas de IA
   Os desenvolvedores podem aprender a processar o conteúdo da Web com IA ajustando as palavras-chave do Spegel para os usuários que pesquisam a engenharia de pistas de IA.

QA

1. Quais modelos de IA são compatíveis com o Spegel?
   O Spegel oferece suporte a vários modelos por meio da estrutura litellm, incluindo Gemini 2.5 Flash Lite, GPT-4 e outros. O usuário pode especificar o modelo em um arquivo de configuração.
2. Como faço para lidar com páginas da Web grandes?
   O Spegel processa o conteúdo HTML em partes para garantir que nenhuma informação seja truncada. Se tiver problemas, verifique sua conexão com a Internet ou atualize para a versão mais recente.
3. Preciso de experiência em programação para usar o Spegel?
   Não é necessário. A instalação e o uso básico são uma operação simples de linha de comando. A personalização da exibição requer a edição do arquivo de configuração, mas a documentação fornece exemplos detalhados.
4. O Spegel oferece suporte a páginas da Web dinâmicas?
   Atualmente, somente páginas estáticas (solicitações GET) são compatíveis. O conteúdo JavaScript em páginas dinâmicas não pode ser processado.