الفروقات

diffs هي أداة Plugin اختيارية تتضمن إرشادات نظام مدمجة قصيرة وSkill مرافقة تحوّل محتوى التغييرات إلى أثر diff للقراءة فقط للوكلاء.

تقبل إما:

• نص before وafter
• patch موحدًا

يمكنها إرجاع:

• عنوان URL لعارض Gateway لعرض canvas
• مسار ملف مُصيَّر (PNG أو PDF) لتسليم الرسائل
• كلا المخرجين في استدعاء واحد

عند تمكينها، تضيف Plugin إرشادات استخدام موجزة في مساحة مطالبة النظام، وتكشف أيضًا عن Skill مفصلة للحالات التي يحتاج فيها الوكيل إلى تعليمات أكمل.

البدء السريع

openclaw plugins install diffs

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

تعطيل إرشادات النظام المدمجة

إذا أردت إبقاء أداة diffs ممكّنة مع تعطيل إرشادات مطالبة النظام المدمجة بها، فاضبط plugins.entries.diffs.hooks.allowPromptInjection على false:

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

يحظر هذا خطاف before_prompt_build الخاص بـ Plugin diffs مع إبقاء Plugin والأداة وSkill المرافقة متاحة.

إذا أردت تعطيل كل من الإرشادات والأداة، فعطّل 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 تمييز الصياغة للغات المصدر والتكوين والتوثيق الشائعة:

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 إلى تلك اللغات الافتراضية.

ثبّت Plugin حزمة لغة عارض الفروقات لتمييز لغات أخرى:

openclaw plugins install clawhub:@openclaw/diffs-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.

راجع Plugin حزمة لغة الفروقات للتفاصيل ولغات Shiki لفهرس اللغات والأسماء المستعارة الصادر من Shiki.

عقد تفاصيل الإخراج

تعيد الأداة بيانات وصفية منظمة تحت details.

ملخص سلوك الوضع:

الأقسام غير المتغيرة المطوية

• يمكن للعارض إظهار صفوف مثل N unmodified lines.
• عناصر التحكم في التوسيع على تلك الصفوف شرطية وليست مضمونة لكل نوع إدخال.
• تظهر عناصر التحكم في التوسيع عندما يحتوي الفرق المعروض على بيانات سياق قابلة للتوسيع، وهذا شائع لإدخال ما قبل وما بعد.
• في كثير من إدخالات التصحيحات الموحدة، لا تكون أجسام السياق المحذوفة متاحة في مقاطع التصحيح المحللة، لذلك قد يظهر الصف بدون عناصر تحكم في التوسيع. هذا سلوك متوقع.
• ينطبق expandUnchanged فقط عند وجود سياق قابل للتوسيع.

افتراضيات 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

تتجاوز معاملات الأداة الصريحة هذه الافتراضيات.

إعداد عنوان URL عارض دائم

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

إعداد الأمان

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

دورة حياة العناصر والتخزين

• تُخزَّن الآثار ضمن المجلد الفرعي المؤقت: $TMPDIR/openclaw-diffs.
• تحتوي بيانات تعريف أثر العارض على:
  • معرّف أثر عشوائي (20 حرفًا سداسيًا)
  • رمز عشوائي (48 حرفًا سداسيًا)
  • createdAt وexpiresAt
  • مسار viewer.html المخزَّن
• قيمة TTL الافتراضية للأثر هي 30 دقيقة عند عدم تحديدها.
• الحد الأقصى المقبول لقيمة TTL للعارض هو 6 ساعات.
• يعمل التنظيف بصورة انتهازية بعد إنشاء الأثر.
• تُحذف الآثار منتهية الصلاحية.
• يزيل التنظيف الاحتياطي المجلدات القديمة التي يتجاوز عمرها 24 ساعة عند غياب بيانات التعريف.

عنوان URL للعارض وسلوك الشبكة

مسار العارض:

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

أصول العارض:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js عندما يستخدم الفرق لغة من حزمة لغة عارض الفروقات

يحلّ مستند العارض تلك الأصول نسبةً إلى عنوان URL للعارض، لذلك يُحفَظ بادئ مسار baseUrl الاختياري لطلبات الأصول أيضًا.

سلوك إنشاء عنوان URL:

• إذا تم توفير baseUrl في استدعاء الأداة، فيُستخدم بعد تحقق صارم.
• وإلا، إذا تم تكوين viewerBaseUrl في Plugin، فيُستخدم.
• من دون أي من التجاوزين، يكون عنوان URL للعارض افتراضيًا على loopback 127.0.0.1.
• إذا كان وضع ربط Gateway هو custom وتم ضبط gateway.customBindHost، فيُستخدم ذلك المضيف.

قواعد baseUrl:

• يجب أن يكون http:// أو https://.
• تُرفض الاستعلامات والهاش.
• يُسمح بالأصل مع مسار أساسي اختياري.

نموذج الأمان

متطلبات المتصفح لوضع الملف

يحتاج mode: "file" وmode: "both" إلى متصفح متوافق مع Chromium.

ترتيب الحل:

نص فشل شائع:

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

أصلح ذلك بتثبيت Chrome أو Chromium أو Edge أو Brave، أو بضبط أحد خيارات مسار الملف التنفيذي أعلاه.

استكشاف الأخطاء وإصلاحها

إرشادات التشغيل

• فضّل mode: "view" للمراجعات التفاعلية المحلية في اللوحة.
• فضّل mode: "file" لقنوات الدردشة الصادرة التي تحتاج إلى مرفق.
• أبقِ allowRemoteViewer معطّلًا ما لم يتطلب النشر لديك عناوين URL بعيدة للعارض.
• اضبط ttlSeconds قصيرة وصريحة للفروقات الحساسة.
• تجنّب إرسال الأسرار في إدخال الفرق عندما لا يكون ذلك مطلوبًا.
• إذا كانت قناتك تضغط الصور بقوة (مثل Telegram أو WhatsApp)، ففضّل مخرجات PDF (fileFormat: "pdf").

ذات صلة

• المتصفح
• Plugins
• نظرة عامة على الأدوات