Categorias

Extrator de Registro de Alterações

Analisa e extrai dados estruturados de registros de alterações e notas de versão em vários formatos

Recursos

Extrai e analisa informações de versão de vários formatos de registro de alterações:

  • Keep a Changelog: Formato padrão com cabeçalhos de versão e alterações categorizadas
  • Conventional Commits: Estilo de mensagem de commit Git com tipo e escopo
  • GitHub Releases: Notas de versão com listas de recursos e correções de bugs
  • Detecção automática: Identifica automaticamente o formato utilizado

Extração

Extrai dados completos de versão:

  • Números de versão: Versionamento semântico (ex: 1.0.0, 2.1.3-beta)
  • Datas de lançamento: Quando cada versão foi lançada
  • Categorias de alterações: Adicionado, Alterado, Deprecado, Removido, Corrigido, Segurança
  • Descrições de alterações: Texto completo de cada entrada de alteração
  • Escopo e breaking changes: Metadados adicionais de commits convencionais

Análise

Fornece estatísticas detalhadas:

  • Número total de versões
  • Primeira e última versão
  • Alterações por categoria por versão
  • Detecção de alterações não lançadas
  • Contagem total de alterações em todas as versões

Exportação

Exporta dados JSON estruturados adequados para:

  • Documentação de API
  • Geração de notas de versão
  • Ferramentas de comparação de versões
  • Guias de migração

Incluir texto completo para cada entrada de alteração

Fatos principais

Categoria
Development
Tipos de entrada
textarea, select, checkbox
Tipo de saída
json
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Extrator de Registro de Alterações é uma ferramenta eficiente para analisar e converter notas de versão e logs de commits em dados JSON estruturados, facilitando a automação de documentação e o rastreamento de histórico de software.

Quando usar

  • Ao precisar converter logs de commits brutos em relatórios de versão legíveis.
  • Para padronizar dados de diferentes formatos, como Keep a Changelog ou GitHub Releases.
  • Ao realizar auditorias de histórico de desenvolvimento para gerar estatísticas de progresso.

Como funciona

  • Cole o conteúdo do seu registro de alterações ou notas de versão na área de entrada.
  • Selecione o formato de origem ou utilize a detecção automática para identificar a estrutura.
  • Escolha se deseja incluir as descrições completas das alterações no resultado.
  • Clique para processar e obtenha um JSON estruturado com versões, categorias e metadados.

Casos de uso

Geração automática de páginas de 'O que há de novo' em portais de documentação.
Criação de dashboards internos para monitorar a frequência e o tipo de atualizações de software.
Migração de histórico de versões entre diferentes plataformas de gerenciamento de projetos.

Exemplos

1. Padronização de Release Notes

Desenvolvedor de Software
Contexto
O desenvolvedor mantém um arquivo CHANGELOG.md manualmente e precisa alimentar um sistema de documentação que exige JSON.
Problema
Converter o texto não estruturado do Markdown em um formato que o sistema de documentação possa ler.
Como usar
Colar o conteúdo do CHANGELOG.md e selecionar 'Keep a Changelog' no seletor de formato.
Resultado
Um arquivo JSON contendo cada versão, data e lista de alterações categorizadas, pronto para ser consumido pela API do portal.

2. Análise de Commits Convencionais

Gerente de Engenharia
Contexto
A equipe utiliza Conventional Commits e o gerente deseja saber quantas correções de bugs foram feitas no último mês.
Problema
Extrair métricas de um histórico de commits extenso sem contar manualmente.
Como usar
Exportar o log de commits, colar na ferramenta e processar com a opção de incluir descrições.
Resultado
Dados estruturados que permitem filtrar facilmente todos os commits do tipo 'fix' e calcular o volume total de correções.

Testar com amostras

text

Hubs relacionados

FAQ

Quais formatos de registro de alterações são suportados?

A ferramenta suporta Keep a Changelog, Conventional Commits e GitHub Releases, além de possuir um modo de detecção automática.

O que acontece se o formato não for reconhecido?

A detecção automática tentará identificar padrões comuns, mas você pode forçar um formato específico no menu de opções para melhorar a precisão.

Posso extrair apenas os números de versão?

Sim, o JSON resultante contém todos os dados extraídos, permitindo que você filtre apenas as versões ou categorias que desejar.

A ferramenta funciona com commits do Git?

Sim, ela é otimizada para analisar mensagens de commit no padrão Conventional Commits.

O resultado pode ser usado em outros sistemas?

Sim, o formato JSON estruturado é ideal para integração com APIs, geradores de sites estáticos e ferramentas de análise de dados.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/changelog-extractor

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
changelogInput textarea Sim -
formatHint select Não -
includeDescriptions checkbox Não Incluir texto completo para cada entrada de alteração

Formato de resposta

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Dados JSON: Dados JSON

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-changelog-extractor": {
      "name": "changelog-extractor",
      "description": "Analisa e extrai dados estruturados de registros de alterações e notas de versão em vários formatos",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=changelog-extractor",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]