Diferencias

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• texto before y after
• un patch unificado

• una URL de visor del Gateway para presentación en canvas
• una ruta de archivo renderizado (PNG o PDF) para entrega por mensaje
• ambas salidas en una sola llamada

​

Inicio rápido

openclaw plugins install diffs

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

​

Deshabilitar la guía de sistema integrada

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

​

Flujo de trabajo típico del agente

​

Ejemplos 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"
}

​

Referencia de entrada de la herramienta

​

Contrato de detalles de salida

​

Secciones sin cambios contraídas

• El visor puede mostrar filas como N unmodified lines.
• Los controles de expansión en esas filas son condicionales y no están garantizados para cada tipo de entrada.
• Los controles de expansión aparecen cuando el diff renderizado tiene datos de contexto expandibles, lo cual es típico para entradas de antes y después.
• Para muchas entradas de patch unificado, los cuerpos de contexto omitidos no están disponibles en los hunks del patch analizado, por lo que la fila puede aparecer sin controles de expansión. Este es el comportamiento esperado.
• expandUnchanged solo se aplica cuando existe contexto expandible.

​

Valores predeterminados del 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

​

Configuración persistente de URL del visor

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

​

Configuración de seguridad

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

​

Ciclo de vida y almacenamiento de artefactos

• Los artefactos se almacenan en la subcarpeta temporal: $TMPDIR/openclaw-diffs.
• Los metadatos de artefacto del visor contienen:
  • ID de artefacto aleatorio (20 caracteres hexadecimales)
  • token aleatorio (48 caracteres hexadecimales)
  • createdAt y expiresAt
  • ruta viewer.html almacenada
• El TTL predeterminado del artefacto es de 30 minutos cuando no se especifica.
• El TTL máximo aceptado del visor es de 6 horas.
• La limpieza se ejecuta de forma oportunista después de la creación del artefacto.
• Los artefactos vencidos se eliminan.
• La limpieza de respaldo elimina carpetas obsoletas de más de 24 horas cuando faltan metadatos.

​

URL del visor y comportamiento de red

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

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js

• Si se proporciona baseUrl en la llamada de herramienta, se usa después de una validación estricta.
• De lo contrario, si viewerBaseUrl del plugin está configurado, se usa.
• Sin ninguna de las dos sobrescrituras, la URL del visor usa de forma predeterminada el loopback 127.0.0.1.
• Si el modo de enlace del Gateway es custom y gateway.customBindHost está establecido, se usa ese host.

• Debe ser http:// o https://.
• Se rechazan consulta y hash.
• Se permite el origen más una ruta base opcional.

​

Modelo de seguridad

​

Requisitos del navegador para el modo de archivo

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

​

Solución de problemas

​

Guía operativa

• Prefiere mode: "view" para revisiones interactivas locales en canvas.
• Prefiere mode: "file" para canales de chat salientes que necesitan un adjunto.
• Mantén allowRemoteViewer deshabilitado salvo que tu despliegue requiera URL de visor remoto.
• Establece ttlSeconds cortos explícitos para diffs sensibles.
• Evita enviar secretos en la entrada de diff cuando no sea necesario.
• Si tu canal comprime imágenes de forma agresiva (por ejemplo Telegram o WhatsApp), prefiere la salida PDF (fileFormat: "pdf").

​

Relacionado

• Navegador
• Plugins
• Resumen de herramientas