Farklar

diffs, değişiklik içeriğini ajanlar için salt okunur bir diff yapıtına dönüştüren kısa yerleşik sistem rehberliği ve eşlik eden bir skill içeren isteğe bağlı bir Plugin aracıdır.

Şunlardan birini kabul eder:

• before ve after metni
• birleşik bir patch

Şunları döndürebilir:

• canvas sunumu için bir Gateway görüntüleyici URL'si
• ileti teslimi için işlenmiş bir dosya yolu (PNG veya PDF)
• tek çağrıda her iki çıktı

Etkinleştirildiğinde Plugin, sistem istemi alanına kısa kullanım rehberliği ekler ve ajanın daha kapsamlı yönergelere ihtiyaç duyduğu durumlar için ayrıntılı bir skill de sunar.

Hızlı başlangıç

openclaw plugins install diffs

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

Yerleşik sistem rehberliğini devre dışı bırakma

diffs aracını etkin tutmak ancak yerleşik sistem istemi rehberliğini devre dışı bırakmak istiyorsanız plugins.entries.diffs.hooks.allowPromptInjection değerini false olarak ayarlayın:

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

Bu, diffs Plugin'inin before_prompt_build hook'unu engellerken Plugin'i, aracı ve eşlik eden skill'i kullanılabilir tutar.

Hem rehberliği hem de aracı devre dışı bırakmak istiyorsanız bunun yerine Plugin'i devre dışı bırakın.

Tipik ajan iş akışı

Girdi örnekleri

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

Araç girdisi başvurusu

Belirtilmediği sürece tüm alanlar isteğe bağlıdır.

Sözdizimi vurgulama

OpenClaw, yaygın kaynak, yapılandırma ve dokümantasyon dilleri için sözdizimi vurgulama içerir:

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

js, ts, bash, md, yml, c++, dockerfile, rb, kt ve ps1 gibi yaygın takma adlar bu varsayılan dillere normalleştirilir.

Diğer dilleri vurgulamak için Diff Viewer Language Pack Plugin'ini yükleyin:

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

Dil paketi kullanılabilir olduğunda OpenClaw çok daha fazla dili vurgulayabilir. Paket yüklü değilse, varsayılan listenin dışındaki dosyalar yine de okunabilir düz metin olarak işlenir. Örnekler arasında 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 ve diff dosyaları bulunur.

Ayrıntılar için Diffs Language Pack Plugin'i ve Shiki'nin üst kaynak dil ve alias kataloğu için Shiki dilleri bölümüne bakın.

Çıktı ayrıntıları sözleşmesi

Araç, yapılandırılmış meta verileri details altında döndürür.

Mod davranışı özeti:

Daraltılmış değiştirilmemiş bölümler

• Görüntüleyici N unmodified lines gibi satırlar gösterebilir.
• Bu satırlardaki genişletme denetimleri koşulludur ve her giriş türü için garanti edilmez.
• Genişletme denetimleri, işlenen diff genişletilebilir bağlam verilerine sahip olduğunda görünür; bu, önceki ve sonraki girişler için tipiktir.
• Birçok unified patch girişinde, atlanan bağlam gövdeleri ayrıştırılmış patch hunk'larında bulunmaz; bu nedenle satır genişletme denetimleri olmadan görünebilir. Bu beklenen davranıştır.
• expandUnchanged yalnızca genişletilebilir bağlam mevcut olduğunda uygulanır.

Plugin varsayılanları

Plugin genelindeki varsayılanları ~/.openclaw/openclaw.json içinde ayarlayın:

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

Desteklenen varsayılanlar:

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

Açık araç parametreleri bu varsayılanları geçersiz kılar.

Kalıcı görüntüleyici URL yapılandırması

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

Güvenlik yapılandırması

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

Artifact yaşam döngüsü ve depolama

• Yapıtlar geçici alt klasör altında saklanır: $TMPDIR/openclaw-diffs.
• Görüntüleyici yapıt meta verileri şunları içerir:
  • rastgele yapıt kimliği (20 onaltılık karakter)
  • rastgele token (48 onaltılık karakter)
  • createdAt ve expiresAt
  • saklanan viewer.html yolu
• Belirtilmediğinde varsayılan yapıt TTL değeri 30 dakikadır.
• Kabul edilen en yüksek görüntüleyici TTL değeri 6 saattir.
• Temizleme, yapıt oluşturulduktan sonra fırsat buldukça çalışır.
• Süresi dolmuş yapıtlar silinir.
• Meta veriler eksik olduğunda yedek temizleme, 24 saatten eski bayat klasörleri kaldırır.

Görüntüleyici URL'si ve ağ davranışı

Görüntüleyici rotası:

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

Görüntüleyici varlıkları:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• diff, Diff Viewer Language Pack içindeki bir dili kullandığında /plugins/diffs-language-pack/assets/viewer.js

Görüntüleyici belgesi bu varlıkları görüntüleyici URL'sine göre çözer; bu nedenle isteğe bağlı baseUrl yol öneki, her iki varlık isteği için de korunur.

URL oluşturma davranışı:

• Araç çağrısı baseUrl sağlanırsa, sıkı doğrulamadan sonra kullanılır.
• Aksi halde Plugin viewerBaseUrl yapılandırılmışsa, o kullanılır.
• Her iki geçersiz kılma da yoksa, görüntüleyici URL'si varsayılan olarak loopback 127.0.0.1 değerini kullanır.
• Gateway bağlama modu custom ise ve gateway.customBindHost ayarlanmışsa, bu ana makine kullanılır.

baseUrl kuralları:

• http:// veya https:// olmalıdır.
• Sorgu ve hash reddedilir.
• Origin ile isteğe bağlı temel yola izin verilir.

Güvenlik modeli

Dosya modu için tarayıcı gereksinimleri

mode: "file" ve mode: "both" Chromium uyumlu bir tarayıcı gerektirir.

Çözüm sırası:

Yaygın hata metni:

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

Chrome, Chromium, Edge veya Brave yükleyerek ya da yukarıdaki yürütülebilir yol seçeneklerinden birini ayarlayarak düzeltin.

Sorun giderme

Operasyonel rehberlik

• Canvas içinde yerel etkileşimli incelemeler için mode: "view" tercih edin.
• Ek gerektiren dışa giden sohbet kanalları için mode: "file" tercih edin.
• Dağıtımınız uzak görüntüleyici URL'leri gerektirmedikçe allowRemoteViewer devre dışı bırakılmış kalsın.
• Hassas diffs için açık ve kısa ttlSeconds ayarlayın.
• Gerekli olmadığında diff girdisinde gizli bilgiler göndermekten kaçının.
• Kanalınız görüntüleri agresif biçimde sıkıştırıyorsa (örneğin Telegram veya WhatsApp), PDF çıktısını tercih edin (fileFormat: "pdf").

İlgili

• Tarayıcı
• Plugins
• Araçlara genel bakış