Perbedaan

diffs adalah alat Plugin opsional dengan panduan sistem bawaan singkat dan Skills pendamping yang mengubah konten perubahan menjadi artefak diff baca-saja untuk agen.

Alat ini menerima salah satu dari:

• teks before dan after
• patch terpadu

Alat ini dapat mengembalikan:

• URL penampil Gateway untuk presentasi kanvas
• path file yang dirender (PNG atau PDF) untuk pengiriman pesan
• kedua output dalam satu panggilan

Saat diaktifkan, Plugin menambahkan panduan penggunaan ringkas ke ruang system-prompt dan juga mengekspos Skills mendetail untuk kasus ketika agen memerlukan instruksi yang lebih lengkap.

Mulai cepat

openclaw plugins install diffs

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

Nonaktifkan panduan sistem bawaan

Jika Anda ingin tetap mengaktifkan alat diffs tetapi menonaktifkan panduan system-prompt bawaannya, atur plugins.entries.diffs.hooks.allowPromptInjection ke false:

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

Ini memblokir hook before_prompt_build milik Plugin diffs sambil tetap menyediakan Plugin, alat, dan Skills pendamping.

Jika Anda ingin menonaktifkan panduan sekaligus alatnya, nonaktifkan Plugin sebagai gantinya.

Alur kerja agen umum

Contoh input

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

Referensi input alat

Semua bidang bersifat opsional kecuali dinyatakan lain.

Penyorotan sintaks

OpenClaw menyertakan penyorotan sintaks untuk bahasa sumber, konfigurasi, dan dokumentasi umum:

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, dan toml.

Alias umum seperti js, ts, bash, md, yml, c++, dockerfile, rb, kt, dan ps1 dinormalisasi ke bahasa default tersebut.

Instal Plugin Diff Viewer Language Pack untuk menyorot bahasa lain:

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

Dengan paket bahasa tersedia, OpenClaw dapat menyorot jauh lebih banyak bahasa. Jika paket tidak diinstal, file di luar daftar default tetap dirender sebagai teks polos yang mudah dibaca. Contohnya meliputi 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, dan file diff.

Lihat Plugin Diffs Language Pack untuk detail dan bahasa Shiki untuk katalog bahasa upstream dan alias Shiki.

Kontrak detail output

Alat ini mengembalikan metadata terstruktur di bawah details.

Ringkasan perilaku mode:

Bagian tidak berubah yang diciutkan

• Viewer dapat menampilkan baris seperti N unmodified lines.
• Kontrol perluas pada baris tersebut bersifat kondisional dan tidak dijamin untuk setiap jenis input.
• Kontrol perluas muncul saat diff yang dirender memiliki data konteks yang dapat diperluas, yang lazim untuk input sebelum dan sesudah.
• Untuk banyak input patch terpadu, isi konteks yang dihilangkan tidak tersedia dalam hunk patch yang diurai, sehingga baris dapat muncul tanpa kontrol perluas. Ini adalah perilaku yang diharapkan.
• expandUnchanged hanya berlaku saat konteks yang dapat diperluas tersedia.

Default Plugin

Tetapkan default di seluruh Plugin dalam ~/.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,          },        },      },    },  },}

Default yang didukung:

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

Parameter alat eksplisit menimpa default ini.

Konfigurasi URL viewer persisten

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

Konfigurasi keamanan

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

Siklus hidup dan penyimpanan artefak

• Artefak disimpan di bawah subfolder temp: $TMPDIR/openclaw-diffs.
• Metadata artefak penampil berisi:
  • ID artefak acak (20 karakter hex)
  • token acak (48 karakter hex)
  • createdAt dan expiresAt
  • path viewer.html yang tersimpan
• TTL artefak default adalah 30 menit jika tidak ditentukan.
• TTL penampil maksimum yang diterima adalah 6 jam.
• Pembersihan berjalan secara oportunistis setelah artefak dibuat.
• Artefak yang kedaluwarsa dihapus.
• Pembersihan fallback menghapus folder usang yang lebih lama dari 24 jam jika metadata tidak ada.

URL penampil dan perilaku jaringan

Rute penampil:

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

Aset penampil:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js saat diff menggunakan bahasa dari Diff Viewer Language Pack

Dokumen penampil menyelesaikan aset tersebut relatif terhadap URL penampil, sehingga prefiks path baseUrl opsional juga dipertahankan untuk kedua permintaan aset.

Perilaku konstruksi URL:

• Jika baseUrl panggilan alat disediakan, nilai itu digunakan setelah validasi ketat.
• Jika tidak, jika viewerBaseUrl Plugin dikonfigurasi, nilai itu digunakan.
• Tanpa salah satu override tersebut, URL penampil default ke loopback 127.0.0.1.
• Jika mode bind Gateway adalah custom dan gateway.customBindHost diatur, host tersebut digunakan.

Aturan baseUrl:

• Harus berupa http:// atau https://.
• Query dan hash ditolak.
• Origin plus path dasar opsional diizinkan.

Model keamanan

Persyaratan browser untuk mode file

mode: "file" dan mode: "both" memerlukan browser yang kompatibel dengan Chromium.

Urutan resolusi:

Teks kegagalan umum:

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

Perbaiki dengan menginstal Chrome, Chromium, Edge, atau Brave, atau mengatur salah satu opsi path executable di atas.

Pemecahan masalah

Panduan operasional

• Pilih mode: "view" untuk peninjauan interaktif lokal di canvas.
• Pilih mode: "file" untuk kanal obrolan keluar yang membutuhkan lampiran.
• Biarkan allowRemoteViewer dinonaktifkan kecuali deployment Anda memerlukan URL penampil jarak jauh.
• Tetapkan ttlSeconds singkat yang eksplisit untuk diff sensitif.
• Hindari mengirim rahasia dalam input diff jika tidak diperlukan.
• Jika kanal Anda mengompresi gambar secara agresif (misalnya Telegram atau WhatsApp), pilih output PDF (fileFormat: "pdf").

Terkait

• Browser
• Plugins
• Ikhtisar alat