LaudoBot — Extensão para VS Code

A LaudoBot é uma assistente de IA que ajuda engenheiros e profissionais técnicos a escrever, organizar e revisar laudos e relatórios técnicos diretamente no VS Code, em uma conversa de chat na barra lateral.

Você pede alterações em português, e a LaudoBot lê os arquivos do seu projeto e aplica as edições na hora — sempre mostrando um diff de cada alteração, que você pode reverter com um clique a qualquer momento.

Procurando a documentação de desenvolvimento da extensão (build, deploy das Edge Functions, arquitetura)? Veja o README-TECH.md.

Como começar

1. Instale a extensão LaudoBot pela Marketplace do VS Code.
2. Abra o ícone da LaudoBot na barra de atividades para abrir o chat na barra lateral.
3. Faça login com sua conta LaudoBot (e-mail e senha).
4. Ainda não tem uma conta? Na tela de login, clique em "Criar uma conta" para abrir a página de cadastro do LaudoBot no navegador.

É necessário ter uma assinatura ativa do LaudoBot para usar o chat.

Conversando com a LaudoBot

Abra a pasta do seu projeto/laudo no VS Code e converse normalmente, por exemplo:

• "Liste os arquivos do projeto"
• "Adicione uma seção de conclusão ao laudo"
• "Corrija a numeração dos itens da seção 3"

Cada alteração feita pela LaudoBot em um arquivo aparece como um card com o diff (o que foi adicionado/removido). Se não gostar do resultado, clique em "Reverter" para desfazer só aquela alteração (também é possível desfazer com Ctrl+Z).

O botão 🕘 no topo do chat mostra o histórico de conversas — você pode voltar a uma conversa anterior, começar uma nova (+) ou sair (⎋).

Estrutura do projeto (config/ e imagens-laudo/)

Cada projeto/laudo usa duas pastas na raiz:

config/
├── minha-empresa.md            # dados da sua empresa/responsável técnico
├── padroes-exportacao-word.md  # padrões de formatação da exportação em Word
├── capa.<ext>                   # (opcional) capa usada na exportação em Word
└── folha-timbrada.<ext>         # (opcional) papel timbrado da exportação em Word

imagens-laudo/                   # fotos usadas nos laudos

<ext> pode ser PNG, JPEG, GIF ou BMP.

Assistente de configuração inicial

Ao começar uma conversa em um workspace vazio, a LaudoBot pergunta se você quer criar essa estrutura padrão automaticamente — basta confirmar. As imagens de exemplo de capa e folha timbrada podem depois ser substituídas pelas da sua própria empresa (mesmo nome de arquivo, qualquer extensão de imagem suportada).

Começando a partir de um laudo modelo (.docx)

Já tem um laudo em Word que costuma usar como modelo? Você pode pedir à LaudoBot para usá-lo como ponto de partida. Ela vai:

• Extrair a estrutura (títulos, parágrafos, negrito/itálico) para um arquivo laudo-modelo.md.
• Extrair as imagens do conteúdo (com legendas, quando detectadas).
• Detectar a formatação usada (fonte, tamanho, espaçamento, margens) e propor aplicá-la nas próximas exportações.
• Identificar e salvar automaticamente a capa e o papel timbrado do modelo, se existirem.

⚠️ laudo-modelo.md serve só de referência de estrutura — dados específicos do caso anterior (nomes, endereços, diagnóstico) não são copiados automaticamente para o laudo novo; só a estrutura e trechos genéricos (metodologia, normas, disclaimers) são reaproveitados direto.

A LaudoBot escreve o laudo novo em laudo.md (ou no arquivo que você já estiver editando).

Limitações: a extração é "melhor esforço" — tabelas, listas, múltiplas colunas, notas de rodapé, gráficos/equações e imagens vetoriais (EMF/WMF) não são extraídos.

Legendas automáticas de fotos

Para laudos com muitas fotos, a LaudoBot pode sugerir uma legenda curta para cada imagem, descrevendo o que ela mostra em relação a um possível problema técnico (trinca, infiltração, corrosão, etc.).

Se as fotos estiverem organizadas em subpastas de imagens-laudo/ por local (prática comum em vistorias), por exemplo:

imagens-laudo/
├── quarto 1/foto1.jpg
└── quarto 2/foto1.jpg

a legenda já vem no formato "<local> - <descrição do problema>", por exemplo: "quarto 1 - trinca na parede, na vertical, partindo do teto".

A legenda é uma sugestão — a LaudoBot revisa a terminologia técnica antes de inserir no laudo, e você pode pedir ajustes. Formatos suportados: PNG, JPEG e GIF.

Exportando o laudo para Word

Quando o laudo estiver pronto (ou em qualquer momento), peça para "exportar o laudo em Word". A LaudoBot gera um .docx formatado, com:

• Títulos (#, ##, ###) convertidos em Título 1/2/3, negrito e itálico preservados.
• Imagens inseridas nos pontos marcados no laudo, com legenda numerada ("Figura N – ...").
• Capa e papel timbrado aplicados automaticamente, se você tiver os arquivos config/capa.<ext> e config/folha-timbrada.<ext> (para melhor resultado, use imagens com proporção próxima de uma folha A4).
• Um Sumário automático no início do documento, se o laudo tiver pelo menos um título. Ao abrir no Word, clique com o botão direito sobre o sumário e escolha "Atualizar campo" (ou F9) para os números de página aparecerem.

A formatação (fonte, tamanho, espaçamento, margens, largura das imagens) usa padrões adequados para laudos técnicos e é guardada em config/padroes-exportacao-word.md — edite esse arquivo a qualquer momento para mudar o padrão das próximas exportações.

Clicar no resultado da exportação no chat abre o .docx gerado no aplicativo padrão do seu sistema.