Introdução geral
O OneLine é uma ferramenta de geração de linha do tempo de eventos quentes de código aberto hospedada no GitHub e desenvolvida pelo usuário chengtx809. Ele usa palavras-chave inseridas pelo usuário para gerar rapidamente uma linha do tempo de eventos, mostrando a hora do evento, o título, a descrição e as pessoas relacionadas. A função de análise de IA fornece uma interpretação detalhada do histórico, do processo e do impacto do evento. O projeto foi desenvolvido com Next.js e React, suporta a implantação do Docker e é adequado para usuários interessados em notícias, história ou eventos importantes.
Lista de funções
- Geração de palavras-chave: gere uma linha do tempo de eventos relevantes com base em palavras-chave inseridas pelo usuário.
- Detalhes do evento: exibe a hora, o título, a descrição e as pessoas envolvidas no evento.
- Filtragem de tempo: suporta a filtragem de eventos por intervalo de tempo, facilitando a concentração em um período específico.
- Análise de IA: fornece análises aprofundadas do contexto, do curso e do impacto dos eventos.
- Marcação da fonte: rotular a fonte de informações sobre um incidente para garantir que o conteúdo seja confiável.
- Configuração de front-end: suporte para que os usuários configurem pontos de extremidade, modelos e chaves da API de IA.
- Proteção por senha: opcionalmente, defina uma senha de acesso para evitar o uso indevido da configuração da API.
Usando a Ajuda
O OneLine é uma ferramenta baseada na Web com código-fonte e métodos de implementação disponíveis em um repositório do GitHub. Abaixo está um guia detalhado de uso e implementação para ajudar os usuários a começar rapidamente.
Visite o site de demonstração
A OneLine oferece um site de demonstração on-line para que os usuários experimentem os recursos:
- Abra seu navegador e acesse
https://oneline.chengtx.me/
. - Digite palavras-chave (por exemplo, "surto" ou "avanço tecnológico") na caixa de entrada da página.
- Clique no botão Generate (Gerar) para visualizar a linha do tempo gerada com a hora, o título e a descrição do evento.
- Use a função de filtro de tempo para selecionar um ano ou mês específico para restringir os eventos.
- Clique no botão AI Analyse para obter uma interpretação do contexto, do processo e do impacto do evento.
- Verifique a fonte do incidente para confirmar a credibilidade das informações.
Implantação local OneLine
Se quiser executar o OneLine localmente ou em um servidor, você pode obter o código-fonte e implantá-lo por meio do repositório do GitHub. Aqui estão as etapas detalhadas:
1. acesso ao código-fonte
- entrevistas
https://github.com/chengtx809/OneLine
. - Clique no ícone verde
Code
botão, selecioneDownload ZIP
Faça o download do código-fonte ou copie o endereço do repositório:git clone https://github.com/chengtx809/OneLine.git
- Descompacte o arquivo ou acesse a pasta clonada e prepare-se para configurar o ambiente.
2. ambiente de configuração
O OneLine requer suporte à API de IA externa (por exemplo, Google Gemini ou OpenAI). A configuração é dividida em configuração de front-end e configuração de variável de ambiente.
Configuração de front-end:
- Depois de iniciar o OneLine, abra a página da Web e clique no botão "API Settings" (Configurações da API) no canto superior direito.
- Digite as seguintes informações:
- Pontos de extremidade da APIComo
https://api.example.com/v1/chat/completions
. - Nome do modeloComo
gemini-2.0-pro-exp-search
. - Chave da APIObtenha-o de seu provedor de API.
- Pontos de extremidade da APIComo
- Se houver uma senha de acesso definida, digite a senha correta para modificar a configuração.
- Salve as configurações e teste a funcionalidade.
Configuração da variável de ambiente (recomendada para implantação):
- No diretório raiz do projeto, localize o arquivo
.env.example
copie o arquivo e renomeie-o.env.local
. - compilador
.env.local
Preencha o seguinte:NEXT_PUBLIC_API_ENDPOINT=https://api.example.com/v1/chat/completions NEXT_PUBLIC_API_MODEL=gemini-2.0-pro-exp-search NEXT_PUBLIC_API_KEY=your_api_key_here NEXT_PUBLIC_ALLOW_USER_CONFIG=true NEXT_PUBLIC_ACCESS_PASSWORD=your_access_password_here
- Notas de configuração:
NEXT_PUBLIC_API_ENDPOINT
Endereço da API de IA: O endereço da API de IA.NEXT_PUBLIC_API_MODEL
Nome do modelo de IA usado.NEXT_PUBLIC_API_KEY
Sua chave de API.NEXT_PUBLIC_ALLOW_USER_CONFIG
: Definido comofalse
As alterações de configuração podem ser desativadas no front-end.NEXT_PUBLIC_ACCESS_PASSWORD
Senha opcional para proteger as configurações da API.
- Salve arquivos para garantir que informações confidenciais não sejam vazadas.
3. implantação com o Docker
O OneLine é compatível com a implantação do Docker, graças ao colaborador justincnn pela imagem. Passo a passo:
- Certifique-se de que o Docker esteja instalado (consulte
https://docs.docker.com/get-docker/
). - Execute o seguinte comando para extrair a imagem:
docker pull justincnn/oneline
- Execute o contêiner e mapeie a porta (padrão 3000):
docker run -p 3000:3000 justincnn/oneline
- Abra seu navegador e acesse
http://localhost:3000
Se você for membro da equipe do OneLine, acesse a página do OneLine. - Se for necessária uma configuração persistente, defina o
.env.local
é montado no contêiner:docker run -p 3000:3000 -v /path/to/.env.local:/app/.env.local justincnn/oneline
4. implantação manual (não Docker)
- Certifique-se de que o Node.js esteja instalado (recomenda-se a versão 16 ou superior).
- Vá para o diretório do projeto e instale as dependências:
npm install
- Inicie o servidor de desenvolvimento:
npm run dev
- entrevistas
http://localhost:3000
A API pode ser configurada e usada.
Uso das funções principais
Veja a seguir como operar as principais funções do OneLine:
Gerar linha do tempo
- Digite uma palavra-chave, como "desenvolvimento de inteligência artificial", na página inicial.
- Clique no botão "Generate" (Gerar), aguarde alguns segundos e a linha do tempo será exibida.
- A linha do tempo é classificada em ordem cronológica, mostrando títulos de eventos, datas, descrições e pessoas relacionadas.
- Passe o mouse sobre o evento para ver os detalhes.
Triagem de tempo
- Localize a barra de filtro na parte superior da linha do tempo e selecione o ano (por exemplo, 2020-2025) ou o mês.
- Clique no botão "Apply" (Aplicar) e a linha do tempo será atualizada com os eventos no intervalo filtrado.
- Se você precisar redefinir, clique em "Clear Filter" (Limpar filtro).
Análise de IA
- Selecione um evento na linha do tempo e clique no botão "AI Analysis" (Análise de IA).
- O sistema chama as APIs de IA configuradas para gerar análises de contexto, processo e impacto do evento.
- Os resultados das análises são exibidos abaixo do evento e contêm descrições textuais que podem abordar causas, efeitos e tendências.
Inspeção de fontes
- Há uma tag de fonte ao lado de cada evento; clique nela para ver o link ou a fonte original.
- Se a fonte não for confiável, envie um problema no GitHub para sugerir melhorias.
Participação em contribuições comunitárias
O OneLine é um projeto de código aberto e as contribuições dos usuários são bem-vindas:
- Para acessar o repositório do GitHub, clique em
Issues
Veja os problemas ou envie um novo problema. - Faça um fork do repositório, altere o código e envie uma solicitação pull, por exemplo, para otimizar a interface do usuário da linha do tempo ou adicionar suporte a um novo idioma.
- Execute testes antes de fazer o commit:
npm run test
- Descreva as alterações no Pull Request e aguarde a revisão.
Perguntas frequentes
- Falha na configuração da APIVerifique se o endpoint, o modelo e a chave da API estão corretos ou verifique a conexão de rede.
- Linha do tempo não exibidaPalavras-chave: Certifique-se de que as palavras-chave sejam específicas (por exemplo, "evento de ciência e tecnologia de 2023") e evite ser excessivamente amplo.
- Erro de inicialização do DockerDocker: verifique se o Docker está em execução e se a porta está ocupada.
- A IA analisa conteúdo imprecisoSubstitua o modelo de IA por um mais potente ou dê feedback sobre os problemas no GitHub.
Com essas etapas, os usuários podem implementar e usar facilmente o OneLine para gerar rapidamente linhas do tempo de eventos quentes e obter análises de IA.
cenário do aplicativo
- Coleta de comunicados à imprensa
Os jornalistas usam o OneLine para inserir palavras-chave para eventos e gerar uma linha do tempo para organizar rapidamente as notícias e ajudar na redação da matéria. - pesquisa histórica
Os alunos ou pesquisadores inserem eventos históricos e obtêm linhas do tempo e análises de IA para entender o contexto e o impacto do evento. - Rastreamento a quente
O público insere tópicos atuais, visualiza o desenvolvimento de eventos, filtra os principais momentos e se mantém a par dos últimos acontecimentos. - ensino e aprendizagem
Os professores usam o OneLine para gerar uma linha do tempo de eventos a ser usada como material de sala de aula para ajudar os alunos a entender eventos complexos.
QA
- Quais APIs de IA são compatíveis com o OneLine?
Suporte para Google Gemini, OpenAI, etc., dependendo dos pontos de extremidade e modelos configurados pelo usuário. - É necessário ter experiência em programação?
Não, o uso do site de demonstração requer apenas a inserção de palavras-chave; a implementação requer conhecimento básico de linha de comando. - De onde vêm os dados da linha do tempo?
Os dados são gerados por IA a partir de informações disponíveis publicamente com base em palavras-chave, com a fonte rotulada ao lado do evento. - Ele pode ser usado off-line?
A rede é necessária para chamar as APIs de IA, algumas funções podem ficar off-line após a implantação local, mas a análise de IA depende da rede. - Como faço para proteger minhas chaves de API?
Use a configuração de variáveis de ambiente para evitar a exposição de chaves no front-end e defina senhas de acesso para maior proteção.