تفاوت‌ها

diffs یک ابزار اختیاریِ همراهِ Plugin است که متن پیش/پس یا یک وصلهٔ یکپارچه را به یک مصنوع diff فقط‌خواندنی تبدیل می‌کند. همچنین راهنمایی کوتاهی برای عامل به ابتدای اعلان سیستم می‌افزاید و برای دستورالعمل‌های کامل‌تر، یک Skill همراه ارائه می‌دهد.

ورودی: متن before + after، یا یک patch یکپارچه (ناهم‌زمان و انحصاری).

خروجی: یک URL نمایشگر Gateway برای ارائه در بوم، مسیر فایل PNG/PDF رندرشده برای تحویل پیام، یا هر دو.

شروع سریع

openclaw plugins install diffs

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

غیرفعال‌کردن راهنمای داخلی سیستم

برای نگه‌داشتن ابزار و حذف راهنمای افزوده‌شده به اعلان سیستم، plugins.entries.diffs.hooks.allowPromptInjection را روی false تنظیم کنید:

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

این کار قلاب before_prompt_build متعلق به Plugin را مسدود می‌کند، درحالی‌که ابزار و Skill همچنان در دسترس می‌مانند. برای غیرفعال‌کردن هم راهنما و هم ابزار، خود Plugin را غیرفعال کنید.

مرجع ورودی ابزار

همهٔ فیلدها اختیاری‌اند، مگر آنکه خلافش ذکر شده باشد.

برجسته‌سازی نحو

زبان‌های داخلی:

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 و غیره) به آن زبان‌ها نرمال‌سازی می‌شوند.

برای زبان‌های بیشتر (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 بستهٔ زبان نمایشگر Diff را نصب کنید:

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

بدون این بسته، زبان‌های پشتیبانی‌نشده همچنان به‌شکل متن سادهٔ خوانا رندر می‌شوند. برای فهرست بالادستی، به Plugin بستهٔ زبان Diffs و زبان‌های Shiki مراجعه کنید.

قرارداد جزئیات خروجی

همهٔ نتایج موفق شامل changed هستند: ورودی پیش/پس یکسان، بدون ایجاد مصنوع، false را برمی‌گرداند؛ نتایج رندرشده true را برمی‌گردانند.

بخش‌های بدون تغییرِ جمع‌شده

نمایشگر ردیف‌هایی مانند N unmodified lines نشان می‌دهد. کنترل‌های گسترش فقط زمانی ظاهر می‌شوند که diff رندرشده دادهٔ زمینهٔ قابل‌گسترش داشته باشد (که برای ورودی پیش/پس معمول است). بسیاری از وصله‌های یکپارچه بدنهٔ زمینه را در قطعه‌های خود حذف می‌کنند؛ بنابراین ممکن است ردیف بدون کنترل گسترش ظاهر شود—این رفتار مورد انتظار است، نه اشکال. expandUnchanged فقط زمانی اعمال می‌شود که زمینهٔ قابل‌گسترش وجود داشته باشد.

پیمایش چندفایلی

وصله‌هایی که بیش از یک فایل را تغییر می‌دهند، با یک کارت خلاصهٔ فایل‌های تغییریافته آغاز می‌شوند: تعداد کل +N / -N، تعدادهای هر فایل، نشان‌های افزوده/حذف‌شده/تغییرنام‌یافته و پیوندهای لنگری که به هر فایل می‌پرند. فایل‌های PNG/PDF رندرشده تعدادهای سربرگ هر فایل را نگه می‌دارند، اما کلیدهای تعاملی نما را حذف می‌کنند، زیرا این کنترل‌ها در یک فایل ایستا کارایی ندارند.

پیش‌فرض‌های 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,          },        },      },    },  },}

کلیدهای پشتیبانی‌شدهٔ defaults:‏ 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 (فقط زمانی که تفاوت از زبانِ یک بستهٔ زبانی استفاده می‌کند)

سند نمایشگر این دارایی‌ها را نسبت به نشانی اینترنتی نمایشگر تفکیک می‌کند، بنابراین پیشوند مسیر اختیاری baseUrl به درخواست‌های دارایی نیز منتقل می‌شود.

ترتیب تفکیک نشانی اینترنتی: baseUrl فراخوانی ابزار (پس از اعتبارسنجی سخت‌گیرانه) -> viewerBaseUrl مربوط به Plugin -> پیش‌فرض حلقهٔ بازگشتی 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 را غیرفعال نگه دارید.
• برای تفاوت‌های حساس، یک ttlSeconds کوتاه و صریح تنظیم کنید.
• اگر لازم نیست، از ارسال اسرار در ورودی تفاوت خودداری کنید.
• اگر کانال شما تصاویر را به‌شدت فشرده می‌کند (برای مثال Telegram یا WhatsApp)، خروجی PDF را ترجیح دهید (fileFormat: "pdf").

مطالب مرتبط

• مرورگر
• Pluginها
• نمای کلی ابزارها