// dokumentacja openclaw

Narzedzie diffs w OpenClaw — wizualizacja zmian

Wprowadzenie

Narzedzie diffs to opcjonalna wtyczka, ktora konwertuje zmiany na artefakty diff w trybie tylko do odczytu. Przetwarza zarowno pary tekstu "przed/po", jak i ujednolicone patche, generujac adresy URL przegladarki lub wyrenderowane pliki.

Glowna funkcjonalnosc

Narzedzie akceptuje dwa typy wejscia:

  • Tekst przed i po — oryginalny i zaktualizowany tekst
  • Ujednolicony patch — format unified diff

Opcje wyjscia obejmuja:

  • URL przegladarki Gateway do prezentacji na canvas
  • Wyrenderowany plik (PNG lub PDF) do dostarczenia w wiadomosci
  • Obie opcje jednoczesnie

Szybki start

  1. Wlacz wtyczke w konfiguracji
  2. Wywolaj z mode: "view" dla workflow canvas
  3. Wywolaj z mode: "file" dla zalaczenikow czatowych
  4. Wywolaj z mode: "both" gdy potrzebujesz obu wyjsc

Konfiguracja

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

Parametry wejsciowe

Wymagane (jedna z opcji)

  • before + after — oryginalny i zaktualizowany tekst
  • patch — tekst ujednoliconego diffa

Opcjonalne

  • path — wyswietlana nazwa pliku
  • lang — wskazowka jezykowa dla podswietlania skladni
  • title — nadpisanie tytulu przegladarki
  • mode — view, file lub both
  • theme — light lub dark
  • layout — unified lub split
  • fileFormat — png lub pdf
  • fileQuality — standard, hq lub print
  • ttlSeconds — czas zycia artefaktu (domyslnie 1800, max 21600)

Limity rozmiaru

  • Tekst before/after: 512 KiB kazdy
  • Patch: maksymalnie 2 MiB
  • Sciezka: 2048 bajtow
  • Zlozonosc patcha: max 128 plikow, 120 000 lacznych linii

Przechowywanie artefaktow

  • Lokalizacja: $TMPDIR/openclaw-diffs
  • Domyslny TTL: 30 minut
  • Maksymalny TTL: 6 godzin
  • Automatyczne czyszczenie wygaslych artefaktow

Bezpieczenstwo przegladarki

  • Domyslnie nasluchuje tylko na loopback (127.0.0.1)
  • Tokenizowane sciezki ze scisla walidacja
  • Content Security Policy zapobiega polaczeniom zewnetrznym
  • Zdalny dostep wylaczony, chyba ze jawnie wlaczony
  • Do renderowania plikow wymagana jest przegladarka Chromium
Wróc do dokumentacji