Quando você precisar mostrar edições como um diff real, prefira a ferramenta diffs em vez de escrever um resumo manual.
A ferramenta diffs aceita texto before + after ou uma string de patch unificada.
Verifique details.changed: entrada before/after idêntica retorna false sem criar um artefato; resultados renderizados retornam true.
Use mode=view quando quiser um visualizador interativo hospedado em gateway. Após a ferramenta retornar, apresente details.viewerUrl com uma ferramenta de apresentação de superfície disponível.
Se a implantação usar um proxy confiável de loopback (por exemplo, Tailscale Serve com gateway.trustedProxies incluindo 127.0.0.1), solicitações brutas de visualizador de loopback podem ser rejeitadas sem cabeçalhos de IP de cliente encaminhados. Nessa topologia, prefira mode=file / mode=both, ou use um viewerBaseUrl configurado / proxy explícito / baseUrl público quando precisar de uma URL de visualizador compartilhável.
Use mode=file quando precisar de um artefato de arquivo renderizado. Defina fileFormat=png (padrão) ou fileFormat=pdf. O resultado da ferramenta inclui details.filePath.
Para arquivos grandes ou de alta fidelidade, use fileQuality (standard|hq|print) e, opcionalmente, sobrescreva fileScale/fileMaxWidth.
Quando precisar entregar o arquivo renderizado a um usuário ou canal, não confie no renderizador bruto do resultado da ferramenta. Em vez disso, use uma ferramenta de envio de arquivos disponível para enviar details.filePath como anexo.
Use mode=both quando quiser tanto a URL do visualizador de gateway quanto o artefato renderizado.
Se o usuário tiver configurado padrões do plugin diffs, prefira omitir mode, theme, layout e opções de apresentação relacionadas, a menos que você precise sobrescrevê-los para este diff específico.
Inclua path para texto before/after quando souber o nome do arquivo.