الفروقات

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

تقبل إما:

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

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

• عنوان URL لعارض Gateway من أجل عرض اللوحة
• مسار ملف معروض (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"}

مرجع إدخال الأداة

كل الحقول اختيارية ما لم يُذكر خلاف ذلك.

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

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

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

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

• يمكن أن يعرض العارض صفوفًا مثل N unmodified lines.
• عناصر التحكم في التوسيع على تلك الصفوف شرطية وليست مضمونة لكل نوع إدخال.
• تظهر عناصر التحكم في التوسيع عندما يحتوي diff المعروض على بيانات سياق قابلة للتوسيع، وهذا معتاد لإدخال قبل وبعد.
• بالنسبة للعديد من إدخالات Patch الموحّدة، لا تكون أجسام السياق المحذوفة متاحة في أجزاء Patch المحللة، لذا يمكن أن يظهر الصف من دون عناصر تحكم في التوسيع. هذا سلوك متوقع.
• ينطبق 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

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

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

• إذا تم توفير baseUrl في استدعاء الأداة، فسيُستخدم بعد تحقق صارم.
• وإلا إذا تم إعداد viewerBaseUrl الخاص بـPlugin، فسيُستخدم.
• من دون أي تجاوز، يكون عنوان URL للعارض افتراضيًا local 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
• نظرة عامة على الأدوات