الفروقات

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

تقبل إما:

• نصي 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.
• عناصر التحكم في التوسيع على تلك الصفوف مشروطة وليست مضمونة لكل نوع إدخال.
• تظهر عناصر التحكم في التوسيع عندما يحتوي الفرق المُصيّر على بيانات سياق قابلة للتوسيع، وهذا معتاد لإدخال قبل وبعد.
• في كثير من مدخلات الرقع الموحدة، لا تكون أجسام السياق المحذوفة متاحة في كتل الرقعة المحللة، لذلك قد يظهر الصف دون عناصر تحكم للتوسيع. هذا سلوك متوقع.
• لا ينطبق 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",
          },
        },
      },
    },
  },
}

الإعدادات الافتراضية المدعومة:

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

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

# إعداد عنوان 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 المخزّن
• مدة بقاء الأثر الافتراضية هي 30 دقيقة عند عدم تحديدها.
• أقصى مدة بقاء عارض مقبولة هي 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
• نظرة عامة على الأدوات