Różnice

diffs to opcjonalne dołączone narzędzie Pluginu, które przekształca tekst przed zmianą i po zmianie lub ujednoliconą łatkę w artefakt różnic tylko do odczytu. Dodaje również na początku promptu systemowego krótkie wskazówki dla agenta i zawiera powiązaną umiejętność z pełniejszymi instrukcjami.

Dane wejściowe: tekst before + after albo ujednolicony patch (wzajemnie wykluczające się).

Dane wyjściowe: adres URL przeglądarki Gateway do prezentacji na kanwie, ścieżka do wyrenderowanego pliku PNG/PDF na potrzeby dostarczenia w wiadomości albo oba te elementy.

Szybki start

openclaw plugins install diffs

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

Wyłączanie wbudowanych wskazówek systemowych

Aby zachować narzędzie, ale usunąć wskazówki dodawane na początku promptu systemowego, ustaw plugins.entries.diffs.hooks.allowPromptInjection na false:

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

Blokuje to hook before_prompt_build Pluginu, pozostawiając dostępne narzędzie i umiejętność. Aby wyłączyć zarówno wskazówki, jak i narzędzie, wyłącz Plugin.

Dokumentacja danych wejściowych narzędzia

Wszystkie pola są opcjonalne, o ile nie zaznaczono inaczej.

Podświetlanie składni

Wbudowane języki:

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 oraz toml.

Popularne aliasy (js, ts, bash, md, yml, c++, dockerfile, rb, kt, ps1 itd.) są normalizowane do tych języków.

Aby uzyskać więcej języków (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, diff i inne), zainstaluj Plugin Diff Viewer Language Pack:

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

Bez tego pakietu nieobsługiwane języki nadal są renderowane jako czytelny zwykły tekst. Zobacz Plugin Diffs Language Pack i języki Shiki, aby zapoznać się z katalogiem projektu nadrzędnego.

Kontrakt szczegółów danych wyjściowych

Wszystkie pomyślne wyniki zawierają changed: identyczne dane wejściowe przed zmianą i po zmianie zwracają false bez tworzenia artefaktu; wyrenderowane wyniki zwracają true.

Zwinięte niezmienione sekcje

Przeglądarka wyświetla wiersze takie jak N unmodified lines. Elementy sterujące rozwijaniem pojawiają się tylko wtedy, gdy wyrenderowana różnica zawiera możliwe do rozwinięcia dane kontekstowe (typowo dla danych wejściowych przed zmianą/po zmianie). W wielu ujednoliconych łatkach treść kontekstu jest pomijana w fragmentach, więc wiersz może pojawić się bez elementu sterującego rozwijaniem — jest to oczekiwane zachowanie, a nie błąd. expandUnchanged ma zastosowanie tylko wtedy, gdy istnieje możliwy do rozwinięcia kontekst.

Nawigacja między wieloma plikami

Łatki obejmujące więcej niż jeden plik rozpoczynają się kartą podsumowania zmienionych plików: łączną liczbą +N / -N, liczbami dla poszczególnych plików, oznaczeniami plików dodanych/usuniętych/ze zmienioną nazwą oraz linkami kotwiczącymi prowadzącymi do każdego pliku. Wyrenderowane pliki PNG/PDF zachowują liczby w nagłówkach poszczególnych plików, ale pomijają interaktywne przełączniki widoku, ponieważ w pliku statycznym nie działają.

Domyślne ustawienia Pluginu

Ustaw domyślne wartości dla całego Pluginu w ~/.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,          },        },      },    },  },}

Obsługiwane klucze defaults: fontFamily, fontSize, lineSpacing, layout, showLineNumbers, diffIndicators, wordWrap, background, theme, fileFormat, fileQuality, fileScale, fileMaxWidth, mode, ttlSeconds. Jawne parametry wywołania narzędzia zastępują te wartości.

Konfiguracja trwałego adresu URL przeglądarki

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

Konfiguracja zabezpieczeń

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

Cykl życia i przechowywanie artefaktów

• Artefakty znajdują się w $TMPDIR/openclaw-diffs.
• Metadane przeglądarki przechowują losowy 20-znakowy identyfikator artefaktu w zapisie szesnastkowym, losowy 48-znakowy token w zapisie szesnastkowym, createdAt/expiresAt oraz zapisaną ścieżkę viewer.html.
• Domyślny czas TTL artefaktu: 30 minut. Maksymalny akceptowany czas TTL: 6 godzin.
• Czyszczenie jest uruchamiane oportunistycznie po każdym wywołaniu tworzącym artefakt; wygasłe artefakty są usuwane.
• Rezerwowe przeszukiwanie usuwa nieaktualne foldery starsze niż 24 godziny, gdy brakuje metadanych.

Adres URL przeglądarki i działanie sieci

Trasa przeglądarki: /plugins/diffs/view/{artifactId}/{token}

Zasoby przeglądarki:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js (tylko gdy diff używa języka pakietu językowego)

Dokument przeglądarki rozwiązuje te zasoby względem adresu URL przeglądarki, dlatego opcjonalny prefiks ścieżki baseUrl jest również stosowany do żądań zasobów.

Kolejność rozwiązywania adresu URL: baseUrl wywołania narzędzia (po ścisłej walidacji) -> viewerBaseUrl pluginu -> domyślna wartość loopback 127.0.0.1. Jeśli tryb powiązania Gateway to custom i ustawiono gateway.customBindHost, ten host jest używany zamiast loopback.

Reguły baseUrl: musi mieć wartość http:// lub https://; zapytanie i skrót są odrzucane; dozwolone jest źródło z opcjonalną ścieżką bazową.

Model zabezpieczeń

Wymagania przeglądarki dla trybu plikowego

mode: "file" i mode: "both" wymagają przeglądarki zgodnej z Chromium.

Kolejność rozwiązywania:

Typowy tekst błędu: Diff PNG/PDF rendering requires a Chromium-compatible browser.... Aby rozwiązać problem, należy zainstalować Chrome, Chromium, Edge lub Brave albo ustawić jedną z powyższych opcji ścieżki do pliku wykonywalnego.

Rozwiązywanie problemów

Wskazówki operacyjne

• W przypadku lokalnych, interaktywnych przeglądów w obszarze roboczym preferowane jest mode: "view".
• W przypadku wychodzących kanałów czatu wymagających załącznika preferowane jest mode: "file".
• Opcja allowRemoteViewer powinna pozostać wyłączona, chyba że wdrożenie wymaga zdalnych adresów URL przeglądarki.
• Dla poufnych diffów należy ustawić jawnie krótki ttlSeconds.
• Należy unikać wysyłania sekretów w danych wejściowych diffa, gdy nie jest to wymagane.
• Jeśli kanał agresywnie kompresuje obrazy (na przykład Telegram lub WhatsApp), preferowane są dane wyjściowe PDF (fileFormat: "pdf").

Powiązane materiały

• Przeglądarka
• Pluginy
• Przegląd narzędzi