Différences

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.

• du texte before et after
• un patch unifié

• une URL de visualiseur Gateway pour une présentation sur canvas
• un chemin de fichier rendu (PNG ou PDF) pour l’envoi par message
• les deux sorties dans un seul appel

​

Démarrage rapide

openclaw plugins install diffs

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

​

Désactiver les consignes système intégrées

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

​

Flux de travail typique de l’agent

​

Exemples d’entrée

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

​

Référence des entrées de l’outil

​

Contrat des détails de sortie

​

Sections inchangées repliées

• Le visualiseur peut afficher des lignes comme N unmodified lines.
• Les contrôles de développement sur ces lignes sont conditionnels et ne sont pas garantis pour chaque type d’entrée.
• Les contrôles de développement apparaissent lorsque le diff rendu contient des données de contexte développables, ce qui est typique pour une entrée avant et après.
• Pour de nombreuses entrées de patch unifié, les corps de contexte omis ne sont pas disponibles dans les hunks du patch analysé, donc la ligne peut apparaître sans contrôles de développement. Il s’agit du comportement attendu.
• expandUnchanged ne s’applique que lorsqu’un contexte développable existe.

​

Valeurs par défaut du 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

​

Configuration d’URL de visualiseur persistante

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

​

Configuration de sécurité

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

​

Cycle de vie et stockage des artefacts

• Les artefacts sont stockés dans le sous-dossier temporaire : $TMPDIR/openclaw-diffs.
• Les métadonnées d’artefact du visualiseur contiennent :
  • un ID d’artefact aléatoire (20 caractères hexadécimaux)
  • un jeton aléatoire (48 caractères hexadécimaux)
  • createdAt et expiresAt
  • le chemin viewer.html stocké
• La TTL d’artefact par défaut est de 30 minutes lorsqu’elle n’est pas spécifiée.
• La TTL maximale acceptée pour le visualiseur est de 6 heures.
• Le nettoyage s’exécute de manière opportuniste après la création de l’artefact.
• Les artefacts expirés sont supprimés.
• Le nettoyage de repli supprime les dossiers obsolètes de plus de 24 heures lorsque les métadonnées sont absentes.

​

URL du visualiseur et comportement réseau

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

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

• Si baseUrl de l’appel d’outil est fourni, il est utilisé après validation stricte.
• Sinon, si viewerBaseUrl du plugin est configuré, il est utilisé.
• Sans aucun remplacement, l’URL du visualiseur utilise par défaut le loopback 127.0.0.1.
• Si le mode de liaison du Gateway est custom et que gateway.customBindHost est défini, cet hôte est utilisé.

• Doit être http:// ou https://.
• La requête et le fragment sont rejetés.
• L’origine plus un chemin de base facultatif est autorisée.

​

Modèle de sécurité

​

Exigences de navigateur pour le mode fichier

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

​

Dépannage

​

Conseils opérationnels

• Préférez mode: "view" pour les revues interactives locales dans le canevas.
• Préférez mode: "file" pour les canaux de discussion sortants qui nécessitent une pièce jointe.
• Gardez allowRemoteViewer désactivé sauf si votre déploiement nécessite des URL de visualiseur distantes.
• Définissez des ttlSeconds courts explicites pour les diffs sensibles.
• Évitez d’envoyer des secrets dans l’entrée de diff lorsque ce n’est pas nécessaire.
• Si votre canal compresse fortement les images (par exemple Telegram ou WhatsApp), préférez la sortie PDF (fileFormat: "pdf").

​

Connexe

• Navigateur
• Plugins
• Vue d’ensemble des outils