Verschillen

• before- en after-tekst
• een unified patch

• een Gateway-viewer-URL voor canvaspresentatie
• een gerenderd bestandspad (PNG of PDF) voor berichtbezorging
• beide outputs in één aanroep

​

Snelstart

openclaw plugins install diffs

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

​

Ingebouwde systeeminstructies uitschakelen

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

​

Typische agentworkflow

​

Invoervoorbeelden

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

​

Referentie voor toolinvoer

​

Syntaxismarkering

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

​

Contract voor uitvoerdetails

​

Samengevouwen ongewijzigde secties

• De viewer kan rijen tonen zoals N unmodified lines.
• Uitklapknoppen op die rijen zijn voorwaardelijk en niet gegarandeerd voor elk inputtype.
• Uitklapknoppen verschijnen wanneer de gerenderde diff uitbreidbare contextgegevens heeft, wat typisch is voor invoer voor en na.
• Voor veel unified patch-invoer zijn weggelaten contextgedeelten niet beschikbaar in de geparsete patch-hunks, dus de rij kan zonder uitklapknoppen verschijnen. Dit is verwacht gedrag.
• expandUnchanged is alleen van toepassing wanneer uitbreidbare context bestaat.

​

Plugin-standaardwaarden

{
  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

​

Configuratie voor permanente viewer-URL

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

​

Beveiligingsconfiguratie

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

​

Artifact-levenscyclus en opslag

• Artefacten worden opgeslagen onder de tijdelijke submap: $TMPDIR/openclaw-diffs.
• Metadata van viewer-artefacten bevat:
  • willekeurige artefact-ID (20 hex-tekens)
  • willekeurig token (48 hex-tekens)
  • createdAt en expiresAt
  • opgeslagen pad naar viewer.html
• De standaard-TTL voor artefacten is 30 minuten wanneer deze niet is opgegeven.
• De maximaal geaccepteerde viewer-TTL is 6 uur.
• Opschoning wordt opportunistisch uitgevoerd na het maken van artefacten.
• Verlopen artefacten worden verwijderd.
• Fallback-opschoning verwijdert verouderde mappen ouder dan 24 uur wanneer metadata ontbreekt.

​

Viewer-URL en netwerkgedrag

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

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js wanneer de diff een taal uit het Diff Viewer Language Pack gebruikt

• Als tool-aanroep baseUrl is opgegeven, wordt deze gebruikt na strikte validatie.
• Anders, als Plugin viewerBaseUrl is geconfigureerd, wordt deze gebruikt.
• Zonder een van beide overrides gebruikt de viewer-URL standaard loopback 127.0.0.1.
• Als de Gateway-bindmodus custom is en gateway.customBindHost is ingesteld, wordt die host gebruikt.

• Moet http:// of https:// zijn.
• Query en hash worden geweigerd.
• Origin plus optioneel basispad is toegestaan.

​

Beveiligingsmodel

​

Browservereisten voor bestandsmodus

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

​

Probleemoplossing

​

Operationele richtlijnen

• Geef de voorkeur aan mode: "view" voor lokale interactieve reviews in canvas.
• Geef de voorkeur aan mode: "file" voor uitgaande chatkanalen die een bijlage nodig hebben.
• Laat allowRemoteViewer uitgeschakeld tenzij je deployment externe viewer-URL’s vereist.
• Stel expliciete korte ttlSeconds in voor gevoelige diffs.
• Vermijd het verzenden van geheimen in diff-invoer wanneer dit niet vereist is.
• Als je kanaal afbeeldingen agressief comprimeert (bijvoorbeeld Telegram of WhatsApp), geef dan de voorkeur aan PDF-uitvoer (fileFormat: "pdf").

​

Gerelateerd

• Browser
• Plugins
• Tools-overzicht