تفاوت‌ها

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,        },      },    },  },}

این کار hook مربوط به 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,          },        },      },    },  },}

چرخهٔ عمر و ذخیره‌سازی مصنوع

• HTML نمایشگر و فراداده‌ها در پایگاه دادهٔ مشترک state/openclaw.sqlite در فضای نام blob افزونهٔ Diffs نگهداری می‌شوند. HTML با gzip فشرده می‌شود؛ SQLite فقط هش SHA-256 توکن تصادفی URL را ذخیره می‌کند، نه خود توکن را.
• فایل‌های PNG/PDF رندرشده به‌صورت نمونه‌های موقت در $TMPDIR/openclaw-diffs باقی می‌مانند، زیرا تحویل از طریق کانال به مسیر فایل نیاز دارد. SQLite مالک فرادادهٔ انقضای آن‌هاست؛ هیچ فایل جانبی JSON نوشته نمی‌شود.
• TTL پیش‌فرض آرتیفکت: 30 دقیقه. حداکثر TTL پذیرفته‌شده: 6 ساعت.
• پاک‌سازی پس از هر فراخوانی ایجاد آرتیفکت، در صورت فراهم‌بودن فرصت اجرا می‌شود. ابتدا ردیف‌های منقضی‌شدهٔ SQLite حذف می‌شوند و سپس هر دایرکتوری PNG/PDF متناظر حذف می‌شود.
• یک پیمایش پشتیبان، پوشه‌های موقت بدون ردیف را که بیش از 24 ساعت قدمت دارند حذف می‌کند. کش‌های قدیمی meta.json، file-meta.json و viewer.html وارد یا خوانده نمی‌شوند.

URL نمایشگر و رفتار شبکه

مسیر نمایشگر: /plugins/diffs/view/{artifactId}/{token}

دارایی‌های نمایشگر:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js (فقط زمانی که diff از یکی از زبان‌های بستهٔ زبانی استفاده می‌کند)

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

ترتیب تفکیک URL: ‏baseUrl در فراخوانی ابزار (پس از اعتبارسنجی سخت‌گیرانه) -> ‏viewerBaseUrl افزونه -> پیش‌فرض loopback یعنی 127.0.0.1. اگر حالت bind در Gateway برابر custom باشد و gateway.customBindHost تنظیم شده باشد، به‌جای loopback از آن میزبان استفاده می‌شود.

قواعد baseUrl: باید http:// یا https:// باشد؛ query و hash رد می‌شوند؛ origin به‌همراه مسیر پایهٔ اختیاری مجاز است.

مدل امنیتی

الزامات مرورگر برای حالت فایل

mode: "file" و mode: "both" به مرورگری سازگار با Chromium نیاز دارند.

ترتیب تفکیک:

متن رایج خطا: Diff PNG/PDF rendering requires a Chromium-compatible browser.... برای رفع آن، Chrome، Chromium، Edge یا Brave را نصب کنید یا یکی از گزینه‌های مسیر فایل اجرایی بالا را تنظیم کنید.

عیب‌یابی

راهنمای عملیاتی

• برای بازبینی‌های تعاملی محلی در canvas، ‏mode: "view" را ترجیح دهید.
• برای کانال‌های چت خروجی که به پیوست نیاز دارند، ‏mode: "file" را ترجیح دهید.
• ‏allowRemoteViewer را غیرفعال نگه دارید، مگر اینکه استقرار شما به URLهای راه دور نمایشگر نیاز داشته باشد.
• برای diffهای حساس، یک ttlSeconds کوتاه و صریح تنظیم کنید.
• در صورت عدم نیاز، از ارسال اطلاعات محرمانه در ورودی diff خودداری کنید.
• اگر کانال شما تصاویر را به‌شدت فشرده می‌کند (برای مثال Telegram یا WhatsApp)، خروجی PDF را ترجیح دهید (fileFormat: "pdf").

مرتبط

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