Diffs

• texto before e after
• um patch unificado

• uma URL do visualizador do Gateway para apresentação em canvas
• um caminho de arquivo renderizado (PNG ou PDF) para entrega por mensagem
• ambas as saídas em uma única chamada

​

Início rápido

openclaw plugins install diffs

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
      },
    },
  },
}

​

Desabilitar a orientação de sistema integrada

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        hooks: {
          allowPromptInjection: false,
        },
      },
    },
  },
}

​

Fluxo de trabalho típico do agente

​

Exemplos de entrada

{
  "before": "# Hello\n\nOne",
  "after": "# Hello\n\nTwo",
  "path": "docs/example.md",
  "mode": "view"
}

{
  "patch": "diff --git a/src/example.ts b/src/example.ts\n--- a/src/example.ts\n+++ b/src/example.ts\n@@ -1 +1 @@\n-const x = 1;\n+const x = 2;\n",
  "mode": "both"
}

​

Referência de entrada da ferramenta

​

Realce de sintaxe

openclaw plugins install clawhub:@openclaw/diffs-language-pack

​

Contrato de detalhes de saída

​

Seções inalteradas recolhidas

• O visualizador pode mostrar linhas como N unmodified lines.
• Os controles de expansão nessas linhas são condicionais e não são garantidos para todo tipo de entrada.
• Os controles de expansão aparecem quando o diff renderizado tem dados de contexto expansíveis, o que é típico para entradas antes e depois.
• Para muitas entradas de patch unificado, os corpos de contexto omitidos não estão disponíveis nos hunks do patch analisado, então a linha pode aparecer sem controles de expansão. Esse é o comportamento esperado.
• expandUnchanged se aplica apenas quando existe contexto expansível.

​

Padrões do Plugin

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        config: {
          defaults: {
            fontFamily: "Fira Code",
            fontSize: 15,
            lineSpacing: 1.6,
            layout: "unified",
            showLineNumbers: true,
            diffIndicators: "bars",
            wordWrap: true,
            background: true,
            theme: "dark",
            fileFormat: "png",
            fileQuality: "standard",
            fileScale: 2,
            fileMaxWidth: 960,
            mode: "both",
            ttlSeconds: 21600,
          },
        },
      },
    },
  },
}

• fontFamily
• fontSize
• lineSpacing
• layout
• showLineNumbers
• diffIndicators
• wordWrap
• background
• theme
• fileFormat
• fileQuality
• fileScale
• fileMaxWidth
• mode
• ttlSeconds

​

Configuração persistente de URL do visualizador

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        config: {
          viewerBaseUrl: "https://gateway.example.com/openclaw",
        },
      },
    },
  },
}

​

Configuração de segurança

{
  plugins: {
    entries: {
      diffs: {
        enabled: true,
        config: {
          security: {
            allowRemoteViewer: false,
          },
        },
      },
    },
  },
}

​

Ciclo de vida e armazenamento de artefatos

• Os artefatos são armazenados na subpasta temporária: $TMPDIR/openclaw-diffs.
• Os metadados do artefato do visualizador contêm:
  • ID aleatório do artefato (20 caracteres hexadecimais)
  • token aleatório (48 caracteres hexadecimais)
  • createdAt e expiresAt
  • caminho armazenado de viewer.html
• O TTL padrão do artefato é de 30 minutos quando não especificado.
• O TTL máximo aceito do visualizador é de 6 horas.
• A limpeza é executada oportunisticamente após a criação do artefato.
• Artefatos expirados são excluídos.
• A limpeza de fallback remove pastas obsoletas com mais de 24 horas quando os metadados estão ausentes.

​

URL do visualizador e comportamento de rede

• /plugins/diffs/view/{artifactId}/{token}

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js quando o diff usa uma linguagem do Diff Viewer Language Pack

• Se baseUrl da chamada de ferramenta for fornecido, ele será usado após validação rigorosa.
• Caso contrário, se viewerBaseUrl do Plugin estiver configurado, ele será usado.
• Sem nenhuma das substituições, a URL do visualizador usa por padrão o loopback 127.0.0.1.
• Se o modo de vinculação do Gateway for custom e gateway.customBindHost estiver definido, esse host será usado.

• Deve ser http:// ou https://.
• Query e hash são rejeitados.
• Origem mais caminho base opcional são permitidos.

​

Modelo de segurança

​

Requisitos de navegador para o modo de arquivo

• Diff PNG/PDF rendering requires a Chromium-compatible browser...

​

Solução de problemas

​

Orientação operacional

• Prefira mode: "view" para revisões interativas locais no canvas.
• Prefira mode: "file" para canais de chat de saída que precisam de um anexo.
• Mantenha allowRemoteViewer desabilitado, a menos que sua implantação exija URLs remotas do visualizador.
• Defina ttlSeconds curto explícito para diffs sensíveis.
• Evite enviar segredos na entrada de diff quando não for necessário.
• Se seu canal comprime imagens de forma agressiva (por exemplo, Telegram ou WhatsApp), prefira saída em PDF (fileFormat: "pdf").

​

Relacionado

• Navegador
• Plugins
• Visão geral das ferramentas