Diferencias

diffs es una herramienta opcional de Plugin con una guía breve integrada del sistema y una Skill complementaria que convierte el contenido de cambios en un artefacto diff de solo lectura para agentes.

Acepta cualquiera de estos:

• texto before y after
• un patch unificado

Puede devolver:

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

Cuando está habilitado, el Plugin antepone una guía de uso concisa en el espacio del prompt del sistema y también expone una Skill detallada para casos en los que el agente necesita instrucciones más completas.

Inicio rápido

openclaw plugins install diffs

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

Deshabilitar la guía integrada del sistema

Si quieres mantener habilitada la herramienta diffs pero deshabilitar su guía integrada del prompt del sistema, establece plugins.entries.diffs.hooks.allowPromptInjection en false:

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

Esto bloquea el hook before_prompt_build del Plugin diffs, mientras mantiene disponibles el Plugin, la herramienta y la Skill complementaria.

Si quieres deshabilitar tanto la guía como la herramienta, deshabilita el Plugin en su lugar.

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

Todos los campos son opcionales salvo que se indique lo contrario.

Resaltado de sintaxis

OpenClaw incluye resaltado de sintaxis para lenguajes comunes de código fuente, configuración y documentación:

javascript, typescript, tsx, jsx, json, markdown, yaml, css, html, sh, python, go, rust, java, c, cpp, csharp, php, sql, docker, ruby, swift, kotlin, r, dart, lua, powershell, xml y toml.

Los alias comunes como js, ts, bash, md, yml, c++, dockerfile, rb, kt y ps1 se normalizan a esos lenguajes predeterminados.

Instala el plugin Diff Viewer Language Pack para resaltar otros lenguajes:

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

Con el paquete de lenguajes disponible, OpenClaw puede resaltar muchos más lenguajes. Si el paquete no está instalado, los archivos fuera de la lista predeterminada siguen mostrándose como texto sin formato legible. Algunos ejemplos incluyen Astro, Vue, Svelte, MDX, GraphQL, Terraform/HCL, Nix, Clojure, Elixir, Haskell, OCaml, Scala, Zig, Solidity, Verilog/VHDL, Fortran, MATLAB, LaTeX, Mermaid, Sass/Less/SCSS, Nginx, Apache, CSV, dotenv, INI y archivos diff.

Consulta el plugin Diffs Language Pack para obtener detalles y lenguajes de Shiki para ver el catálogo upstream de lenguajes y alias de Shiki.

Contrato de detalles de salida

La herramienta devuelve metadatos estructurados en details.

Resumen del comportamiento de los modos:

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 habitual para entradas de antes y después.
• Para muchas entradas de parches unificados, los cuerpos de contexto omitidos no están disponibles en los hunks del parche analizado, por lo que la fila puede aparecer sin controles de expansión. Este es el comportamiento esperado.
• expandUnchanged se aplica solo cuando existe contexto expandible.

Valores predeterminados del Plugin

Define valores predeterminados para todo el Plugin en ~/.openclaw/openclaw.json:

{  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,          },        },      },    },  },}

Valores predeterminados admitidos:

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

Los parámetros explícitos de la herramienta sobrescriben estos valores predeterminados.

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

URL del visor y comportamiento de red

Ruta del visor:

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

Recursos del visor:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js cuando el diff usa un idioma del paquete de idiomas del visor de diffs

El documento del visor resuelve esos recursos en relación con la URL del visor, por lo que también se conserva un prefijo de ruta baseUrl opcional para ambas solicitudes de recursos.

Comportamiento de construcción de URL:

• Si se proporciona baseUrl en la llamada a herramienta, se usa después de una validación estricta.
• De lo contrario, si está configurado viewerBaseUrl del plugin, se usa.
• Sin ninguna de esas 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á configurado, se usa ese host.

Reglas de baseUrl:

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

Modelo de seguridad

Requisitos del navegador para el modo de archivo

mode: "file" y mode: "both" necesitan un navegador compatible con Chromium.

Orden de resolución:

Texto de fallo común:

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

Corrígelo instalando Chrome, Chromium, Edge o Brave, o configurando una de las opciones de ruta de ejecutable anteriores.

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 a menos que tu implementación requiera URL de visor remotas.
• Configura 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