अंतर

diffs एक वैकल्पिक Plugin टूल है, जिसमें छोटा अंतर्निहित सिस्टम मार्गदर्शन और एक सहायक Skills होता है, जो परिवर्तन सामग्री को एजेंटों के लिए रीड-ओनली diff आर्टिफैक्ट में बदलता है।

यह इनमें से कोई भी स्वीकार करता है:

• before और after टेक्स्ट
• एक unified patch

यह लौटा सकता है:

• कैनवास प्रस्तुति के लिए Gateway व्यूअर URL
• संदेश डिलीवरी के लिए रेंडर किया गया फ़ाइल पथ (PNG या PDF)
• एक ही कॉल में दोनों आउटपुट

सक्षम होने पर, Plugin सिस्टम-प्रॉम्प्ट स्थान में संक्षिप्त उपयोग मार्गदर्शन जोड़ता है और उन मामलों के लिए एक विस्तृत Skills भी उपलब्ध कराता है जहाँ एजेंट को अधिक पूर्ण निर्देशों की आवश्यकता होती है।

त्वरित शुरुआत

openclaw plugins install diffs

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

अंतर्निहित सिस्टम मार्गदर्शन अक्षम करें

यदि आप diffs टूल को सक्षम रखना चाहते हैं लेकिन उसका अंतर्निहित सिस्टम-प्रॉम्प्ट मार्गदर्शन अक्षम करना चाहते हैं, तो plugins.entries.diffs.hooks.allowPromptInjection को false पर सेट करें:

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

यह diffs Plugin के before_prompt_build हुक को ब्लॉक करता है, जबकि Plugin, टूल और सहायक Skills उपलब्ध रहते हैं।

यदि आप मार्गदर्शन और टूल दोनों को अक्षम करना चाहते हैं, तो इसके बजाय Plugin को अक्षम करें।

सामान्य एजेंट वर्कफ़्लो

इनपुट उदाहरण

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

टूल इनपुट संदर्भ

जहाँ उल्लेख न हो, सभी फ़ील्ड वैकल्पिक हैं।

सिंटैक्स हाइलाइटिंग

OpenClaw में सामान्य source, config और documentation भाषाओं के लिए सिंटैक्स हाइलाइटिंग शामिल है:

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, और toml।

js, ts, bash, md, yml, c++, dockerfile, rb, kt, और ps1 जैसे सामान्य aliases उन डिफ़ॉल्ट भाषाओं में normalize किए जाते हैं।

अन्य भाषाओं को हाईलाइट करने के लिए Diff Viewer Language Pack Plugin इंस्टॉल करें:

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

Language Pack उपलब्ध होने पर, OpenClaw कई और भाषाओं को हाईलाइट कर सकता है। यदि पैक इंस्टॉल नहीं है, तो डिफ़ॉल्ट सूची से बाहर की फ़ाइलें फिर भी पठनीय सादे टेक्स्ट के रूप में रेंडर होती हैं। उदाहरणों में 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, और diff फ़ाइलें शामिल हैं।

विवरण के लिए Diffs Language Pack Plugin और Shiki की अपस्ट्रीम भाषा और alias कैटलॉग के लिए Shiki languages देखें।

आउटपुट विवरण अनुबंध

टूल details के अंतर्गत संरचित मेटाडेटा लौटाता है।

मोड व्यवहार सारांश:

संक्षिप्त किए गए अपरिवर्तित सेक्शन

• व्यूअर N unmodified lines जैसी पंक्तियाँ दिखा सकता है।
• उन पंक्तियों पर expand controls शर्तों पर निर्भर हैं और हर input kind के लिए गारंटीकृत नहीं हैं।
• Expand controls तब दिखाई देते हैं जब रेंडर किए गए diff में expandable context data होता है, जो before और after input के लिए सामान्य है।
• कई unified patch inputs के लिए, छोड़े गए context bodies parsed patch hunks में उपलब्ध नहीं होते, इसलिए पंक्ति expand controls के बिना दिखाई दे सकती है। यह अपेक्षित व्यवहार है।
• expandUnchanged केवल तब लागू होता है जब expandable context मौजूद हो।

Plugin डिफ़ॉल्ट

Plugin-व्यापी डिफ़ॉल्ट ~/.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,          },        },      },    },  },}

समर्थित डिफ़ॉल्ट:

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

स्पष्ट टूल पैरामीटर इन डिफ़ॉल्ट को override करते हैं।

स्थायी व्यूअर URL कॉन्फ़िगरेशन

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

सुरक्षा कॉन्फ़िगरेशन

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

Artifact lifecycle और storage

• आर्टिफैक्ट temp सबफ़ोल्डर के अंतर्गत संग्रहीत होते हैं: $TMPDIR/openclaw-diffs.
• व्यूअर आर्टिफैक्ट मेटाडेटा में शामिल है:
  • यादृच्छिक आर्टिफैक्ट आईडी (20 हेक्स वर्ण)
  • यादृच्छिक टोकन (48 हेक्स वर्ण)
  • createdAt और expiresAt
  • संग्रहीत viewer.html पथ
• निर्दिष्ट न होने पर डिफ़ॉल्ट आर्टिफैक्ट TTL 30 मिनट है।
• अधिकतम स्वीकृत व्यूअर TTL 6 घंटे है।
• आर्टिफैक्ट बनाने के बाद क्लीनअप अवसरवादी रूप से चलता है।
• समाप्त हो चुके आर्टिफैक्ट हटाए जाते हैं।
• मेटाडेटा न होने पर fallback क्लीनअप 24 घंटे से पुराने stale फ़ोल्डर हटाता है।

व्यूअर URL और नेटवर्क व्यवहार

व्यूअर रूट:

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

व्यूअर एसेट:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js जब diff, Diff Viewer Language Pack की किसी भाषा का उपयोग करता है

व्यूअर दस्तावेज़ उन एसेट को व्यूअर URL के सापेक्ष resolve करता है, इसलिए वैकल्पिक baseUrl पथ prefix दोनों एसेट अनुरोधों के लिए भी सुरक्षित रहता है।

URL निर्माण व्यवहार:

• यदि tool-call baseUrl दिया गया है, तो उसे कड़ी validation के बाद उपयोग किया जाता है।
• अन्यथा यदि Plugin viewerBaseUrl configured है, तो उसका उपयोग किया जाता है।
• दोनों override न होने पर, व्यूअर URL डिफ़ॉल्ट रूप से loopback 127.0.0.1 होता है।
• यदि gateway bind mode custom है और gateway.customBindHost सेट है, तो उसी host का उपयोग किया जाता है।

baseUrl नियम:

• http:// या https:// होना चाहिए।
• Query और hash अस्वीकार किए जाते हैं।
• Origin के साथ वैकल्पिक base path की अनुमति है।

सुरक्षा मॉडल

फ़ाइल मोड के लिए browser आवश्यकताएँ

mode: "file" और mode: "both" को Chromium-compatible browser चाहिए।

Resolution क्रम:

सामान्य विफलता text:

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

Chrome, Chromium, Edge, या Brave install करके, या ऊपर दिए गए executable path विकल्पों में से एक सेट करके ठीक करें।

समस्या निवारण

संचालन मार्गदर्शन

• canvas में local interactive reviews के लिए mode: "view" को प्राथमिकता दें।
• attachment की आवश्यकता वाले outbound chat channels के लिए mode: "file" को प्राथमिकता दें।
• जब तक आपकी deployment को remote व्यूअर URLs की आवश्यकता न हो, allowRemoteViewer disabled रखें।
• sensitive diffs के लिए स्पष्ट छोटे ttlSeconds सेट करें।
• आवश्यकता न होने पर diff input में secrets भेजने से बचें।
• यदि आपका channel images को aggressively compress करता है (उदाहरण के लिए Telegram या WhatsApp), तो PDF output (fileFormat: "pdf") को प्राथमिकता दें।

संबंधित

• Browser
• Plugins
• Tools overview