Farklar

diffs, kısa yerleşik sistem yönergelerine ve değişiklik içeriğini aracıların kullanımı için salt okunur bir diff yapıtına dönüştüren eşlik eden bir skill’e sahip isteğe bağlı bir plugin aracıdır.

Şunlardan birini kabul eder:

• before ve after metni
• unified patch

Şunları döndürebilir:

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

Etkinleştirildiğinde plugin, sistem istemi alanına kısa kullanım yönergeleri ekler ve aracının daha kapsamlı talimatlara 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 yönergelerini devre dışı bırakma

diffs aracını etkin tutup yerleşik sistem istemi yönergelerini 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, plugin’i, aracı ve eşlik eden skill’i kullanılabilir tutarken diffs plugin’inin before_prompt_build hook’unu engeller.

Hem yönergeleri hem de aracı devre dışı bırakmak istiyorsanız bunun yerine plugin’i devre dışı bırakın.

# Tipik aracı 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

Belirtilmedikçe tüm alanlar isteğe bağlıdır.

# Çı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şmeyen bölümler

• Görüntüleyici N unmodified lines gibi satırlar gösterebilir.
• Bu satırlardaki genişletme kontrolleri koşulludur ve her girdi türü için garanti edilmez.
• Genişletme kontrolleri, işlenmiş diff genişletilebilir bağlam verisine sahip olduğunda görünür; bu, before ve after girdileri için tipiktir.
• Birçok unified patch girdisinde, atlanan bağlam gövdeleri ayrıştırılmış patch hunk’larında bulunmaz; bu nedenle satır genişletme kontrolleri 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",
          },
        },
      },
    },
  },
}

Desteklenen varsayılanlar:

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

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

# Yapıt yaşam döngüsü ve depolama

• Yapıtlar temp alt klasörü altında depolanır: $TMPDIR/openclaw-diffs.
• Görüntüleyici yapıt meta verileri şunları içerir:
  • rastgele yapıt kimliği (20 hex karakter)
  • rastgele token (48 hex karakter)
  • createdAt ve expiresAt
  • depolanan viewer.html yolu
• Belirtilmediğinde varsayılan yapıt TTL’si 30 dakikadır.
• Kabul edilen en fazla görüntüleyici TTL’si 6 saattir.
• Temizleme, yapıt oluşturulduktan sonra fırsat buldukça çalışır.
• Süresi dolmuş yapıtlar silinir.
• Geri dönüş temizliği, meta veri eksik olduğunda 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

Görüntüleyici belgesi bu varlıkları görüntüleyici URL’sine göre çözümler; bu nedenle isteğe bağlı baseUrl yol öneki 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 kullanılır.
• İki geçersiz kılma da yoksa görüntüleyici URL’si varsayılan olarak loopback 127.0.0.1 olur.
• Gateway bind modu custom ise ve gateway.customBindHost ayarlanmışsa o host kullanılır.

baseUrl kuralları:

• http:// veya https:// olmalıdır.
• Sorgu ve hash reddedilir.
• Kaynak ve isteğe bağlı taban yoluna 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 kurarak ya da yukarıdaki çalıştırılabilir yol seçeneklerinden birini ayarlayarak düzeltin.

# Sorun giderme

# Operasyonel rehberlik

• Tuvalde yerel etkileşimli incelemeler için mode: "view" tercih edin.
• Ek gerektiren 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ışı kalsın.
• Hassas diff'ler 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ı (fileFormat: "pdf") tercih edin.

# İlgili

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