Różnice

diffs to opcjonalne narzędzie Plugin z krótkimi wbudowanymi wskazówkami systemowymi i towarzyszącym Skill, które przekształca treść zmian w artefakt diff tylko do odczytu dla agentów.

Akceptuje jedno z poniższych:

• tekst before i after
• ujednolicony patch

Może zwrócić:

• URL przeglądarki Gateway do prezentacji canvas
• ścieżkę wyrenderowanego pliku (PNG lub PDF) do dostarczenia w wiadomości
• oba wyniki w jednym wywołaniu

Po włączeniu Plugin dodaje zwięzłe wskazówki użycia do przestrzeni promptu systemowego oraz udostępnia szczegółowy Skill na przypadki, gdy agent potrzebuje pełniejszych instrukcji.

Szybki start

openclaw plugins install diffs

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

Wyłącz wbudowane wskazówki systemowe

Jeśli chcesz zachować włączone narzędzie diffs, ale wyłączyć jego wbudowane wskazówki promptu systemowego, ustaw plugins.entries.diffs.hooks.allowPromptInjection na false:

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

Blokuje to hook before_prompt_build Plugin diffs, zachowując dostępność Plugin, narzędzia i towarzyszącego Skill.

Jeśli chcesz wyłączyć zarówno wskazówki, jak i narzędzie, wyłącz zamiast tego Plugin.

Typowy przepływ pracy agenta

Przykłady danych wejściowych

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

Dokumentacja danych wejściowych narzędzia

Wszystkie pola są opcjonalne, chyba że zaznaczono inaczej.

Podświetlanie składni

OpenClaw obejmuje podświetlanie składni dla popularnych języków kodu źródłowego, konfiguracji i dokumentacji:

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

Popularne aliasy, takie jak js, ts, bash, md, yml, c++, dockerfile, rb, kt i ps1, są normalizowane do tych domyślnych języków.

Zainstaluj Plugin Diff Viewer Language Pack, aby podświetlać inne języki:

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

Gdy pakiet językowy jest dostępny, OpenClaw może podświetlać znacznie więcej języków. Jeśli pakiet nie jest zainstalowany, pliki spoza domyślnej listy nadal są renderowane jako czytelny zwykły tekst. Przykłady obejmują pliki 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 oraz pliki diff.

Szczegóły znajdziesz w Pluginie Diffs Language Pack, a nadrzędny katalog języków i aliasów Shiki w językach Shiki.

Kontrakt szczegółów wyjścia

Narzędzie zwraca ustrukturyzowane metadane w details.

Podsumowanie zachowania trybów:

Zwinięte niezmienione sekcje

• Przeglądarka może pokazywać wiersze takie jak N unmodified lines.
• Kontrolki rozwijania w tych wierszach są warunkowe i nie są gwarantowane dla każdego rodzaju wejścia.
• Kontrolki rozwijania pojawiają się, gdy wyrenderowany diff zawiera dane kontekstu możliwe do rozwinięcia, co jest typowe dla wejścia przed i po.
• Dla wielu wejść w formacie unified patch pominięte treści kontekstu nie są dostępne w przeanalizowanych hunkach patcha, więc wiersz może pojawić się bez kontrolek rozwijania. To oczekiwane zachowanie.
• expandUnchanged ma zastosowanie tylko wtedy, gdy istnieje kontekst możliwy do rozwinięcia.

Domyślne ustawienia Pluginu

Ustaw domyślne ustawienia 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 ustawienia domyślne:

• fontFamily
• fontSize
• lineSpacing
• layout
• showLineNumbers
• diffIndicators
• wordWrap
• background
• theme
• fileFormat
• fileQuality
• fileScale
• fileMaxWidth
• mode
• ttlSeconds

Jawne parametry narzędzia zastępują te ustawienia domyślne.

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 są przechowywane w tymczasowym podfolderze: $TMPDIR/openclaw-diffs.
• Metadane artefaktu przeglądarki zawierają:
  • losowy identyfikator artefaktu (20 znaków szesnastkowych)
  • losowy token (48 znaków szesnastkowych)
  • createdAt i expiresAt
  • zapisaną ścieżkę viewer.html
• Domyślny TTL artefaktu wynosi 30 minut, gdy nie podano innej wartości.
• Maksymalny akceptowany TTL przeglądarki wynosi 6 godzin.
• Czyszczenie uruchamia się oportunistycznie po utworzeniu artefaktu.
• Wygasłe artefakty są usuwane.
• Czyszczenie awaryjne usuwa nieaktualne foldery starsze niż 24 godziny, gdy brakuje metadanych.

Adres URL przeglądarki i zachowanie sieciowe

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 gdy diff używa języka z Diff Viewer Language Pack

Dokument przeglądarki rozwiązuje te zasoby względem adresu URL przeglądarki, więc opcjonalny prefiks ścieżki baseUrl jest zachowywany także dla obu żądań zasobów.

Zachowanie konstruowania adresu URL:

• Jeśli podano baseUrl wywołania narzędzia, jest używany po ścisłej walidacji.
• W przeciwnym razie, jeśli skonfigurowano viewerBaseUrl pluginu, jest on używany.
• Bez żadnego z tych nadpisań adres URL przeglądarki domyślnie używa loopback 127.0.0.1.
• Jeśli tryb wiązania Gateway to custom i ustawiono gateway.customBindHost, używany jest ten host.

Reguły baseUrl:

• Musi być http:// albo https://.
• Query i hash są odrzucane.
• Dozwolone jest origin plus opcjonalna ścieżka bazowa.

Model bezpieczeństwa

Wymagania przeglądarki dla trybu pliku

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

Napraw przez zainstalowanie Chrome, Chromium, Edge albo Brave, albo ustawienie jednej z powyższych opcji ścieżki wykonywalnej.

Rozwiązywanie problemów

Wskazówki operacyjne

• Preferuj mode: "view" do lokalnych interaktywnych przeglądów w canvas.
• Preferuj mode: "file" dla wychodzących kanałów czatu, które potrzebują załącznika.
• Pozostaw allowRemoteViewer wyłączone, chyba że Twoje wdrożenie wymaga zdalnych adresów URL przeglądarki.
• Ustaw jawny krótki ttlSeconds dla wrażliwych diffów.
• Unikaj wysyłania sekretów w danych wejściowych diffu, gdy nie jest to wymagane.
• Jeśli Twój kanał agresywnie kompresuje obrazy (na przykład Telegram lub WhatsApp), preferuj wyjście PDF (fileFormat: "pdf").

Powiązane

• Przeglądarka
• Pluginy
• Omówienie narzędzi