Відмінності

diffs — це необов’язковий Plugin tool із короткими вбудованими системними вказівками та супровідним skill, який перетворює вміст змін на артефакт diff лише для читання для агентів.

Він приймає або:

• текст before і after
• уніфікований patch

Він може повернути:

• URL переглядача Gateway для подання на canvas
• шлях до відрендереного файлу (PNG або PDF) для доставлення повідомленням
• обидва виходи за один виклик

Коли ввімкнено, Plugin додає стислі вказівки з використання в простір системного prompt, а також надає детальний skill для випадків, коли агенту потрібні повніші інструкції.

# Швидкий старт

openclaw plugins install diffs

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

# Вимкнення вбудованих системних вказівок

Якщо ви хочете залишити tool diffs увімкненим, але вимкнути його вбудовані вказівки системного prompt, установіть plugins.entries.diffs.hooks.allowPromptInjection у false:

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

Це блокує hook before_prompt_build Plugin diffs, водночас залишаючи Plugin, tool і супровідний skill доступними.

Якщо ви хочете вимкнути і вказівки, і tool, натомість вимкніть 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"
}

# Довідник вхідних даних tool

Усі поля необов’язкові, якщо не зазначено інше.

# Контракт вихідних details

Tool повертає структуровані метадані в 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",
          },
        },
      },
    },
  },
}

Підтримувані типові значення:

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

Явні параметри tool перевизначають ці типові значення.

# Конфігурація постійного 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.
• Метадані артефакту переглядача містять:
  • випадковий ID артефакту (20 hex chars)
  • випадковий токен (48 hex chars)
  • 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 виклику tool, він використовується після суворої валідації.
• Інакше, якщо налаштовано Plugin viewerBaseUrl, використовується він.
• Без будь-якого перевизначення URL переглядача за замовчуванням використовує loopback 127.0.0.1.
• Якщо режим прив’язування Gateway — custom і встановлено gateway.customBindHost, використовується цей хост.

Правила baseUrl:

• Має бути http:// або https://.
• Query і hash відхиляються.
• Дозволено origin плюс необов’язковий базовий шлях.

# Модель безпеки

# Вимоги браузера для файлового режиму

mode: "file" і mode: "both" потребують Chromium-сумісного браузера.

Порядок визначення:

Поширений текст помилки:

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

Виправте, встановивши Chrome, Chromium, Edge або Brave, або задавши один із варіантів шляху до виконуваного файла вище.

# Усунення несправностей

# Операційні рекомендації

• Надавайте перевагу mode: "view" для локальних інтерактивних рев’ю в canvas.
• Надавайте перевагу mode: "file" для вихідних каналів чату, яким потрібне вкладення.
• Тримайте allowRemoteViewer вимкненим, якщо ваше розгортання не потребує віддалених URL переглядача.
• Задавайте явні короткі ttlSeconds для чутливих diff.
• Не надсилайте секрети у вхідних даних diff, якщо це не потрібно.
• Якщо ваш канал сильно стискає зображення (наприклад, Telegram або WhatsApp), надавайте перевагу виводу PDF (fileFormat: "pdf").

# Пов’язане

• Браузер
• Plugins
• Огляд інструментів