الفروقات

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

​

البدء السريع

openclaw plugins install diffs

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

​

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

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

​

سير عمل الوكيل المعتاد

​

أمثلة الإدخال

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

​

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

​

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

​

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

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

​

القيم الافتراضية لـPlugin

{
  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

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

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

​

نموذج الأمان

​

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

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

​

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

​

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

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

​

ذو صلة

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