Farklar

• before ve after metni
• birleşik bir patch

• 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ı

​

Hızlı başlangıç

openclaw plugins install diffs

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

​

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

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

​

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

​

Sözdizimi vurgulama

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

​

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

​

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ı

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

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

​

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ışı

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

• /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

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

• 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

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

​

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ış