Differenze

• testo before e after
• una patch unificata

• un URL del visualizzatore Gateway per la presentazione su canvas
• un percorso di file renderizzato (PNG o PDF) per la consegna dei messaggi
• entrambi gli output in una sola chiamata

​

Avvio rapido

openclaw plugins install diffs

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

​

Disabilitare la guida di sistema integrata

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

​

Flusso di lavoro tipico dell’agente

​

Esempi di input

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

​

Riferimento dell’input dello strumento

​

Evidenziazione della sintassi

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

​

Contratto dei dettagli di output

​

Sezioni invariate compresse

• Il visualizzatore può mostrare righe come N unmodified lines.
• I controlli di espansione su tali righe sono condizionali e non garantiti per ogni tipo di input.
• I controlli di espansione vengono visualizzati quando il diff renderizzato contiene dati di contesto espandibili, cosa tipica per input prima e dopo.
• Per molti input patch unificati, i corpi del contesto omessi non sono disponibili negli hunk della patch analizzata, quindi la riga può comparire senza controlli di espansione. Questo è il comportamento previsto.
• expandUnchanged si applica solo quando esiste un contesto espandibile.

​

Valori predefiniti 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

​

Configurazione URL persistente del visualizzatore

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

​

Configurazione di sicurezza

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

​

Ciclo di vita e archiviazione degli artefatti

• Gli artefatti sono archiviati nella sottocartella temporanea: $TMPDIR/openclaw-diffs.
• I metadati dell’artefatto del visualizzatore contengono:
  • ID artefatto casuale (20 caratteri esadecimali)
  • token casuale (48 caratteri esadecimali)
  • createdAt ed expiresAt
  • percorso viewer.html archiviato
• La TTL predefinita dell’artefatto è di 30 minuti quando non specificata.
• La TTL massima accettata per il visualizzatore è di 6 ore.
• La pulizia viene eseguita in modo opportunistico dopo la creazione dell’artefatto.
• Gli artefatti scaduti vengono eliminati.
• La pulizia di fallback rimuove le cartelle obsolete più vecchie di 24 ore quando mancano i metadati.

​

URL del visualizzatore e comportamento di rete

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

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js quando il diff usa una lingua del Diff Viewer Language Pack

• Se viene fornito baseUrl della tool-call, viene usato dopo una validazione rigorosa.
• Altrimenti, se è configurato viewerBaseUrl del Plugin, viene usato.
• Senza nessuna delle due sostituzioni, l’URL del visualizzatore usa per impostazione predefinita il loopback 127.0.0.1.
• Se la modalità di bind del Gateway è custom e gateway.customBindHost è impostato, viene usato quell’host.

• Deve essere http:// o https://.
• Query e hash vengono rifiutati.
• Sono consentiti origin più percorso base facoltativo.

​

Modello di sicurezza

​

Requisiti del browser per la modalità file

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

​

Risoluzione dei problemi

​

Indicazioni operative

• Preferisci mode: "view" per revisioni interattive locali nel canvas.
• Preferisci mode: "file" per canali chat in uscita che richiedono un allegato.
• Mantieni allowRemoteViewer disabilitato salvo che il tuo deployment richieda URL del visualizzatore remoti.
• Imposta ttlSeconds brevi espliciti per diff sensibili.
• Evita di inviare segreti nell’input del diff quando non necessario.
• Se il tuo canale comprime le immagini in modo aggressivo (ad esempio Telegram o WhatsApp), preferisci l’output PDF (fileFormat: "pdf").

​

Correlati

• Browser
• Plugin
• Panoramica degli strumenti