Различия

diffs — необязательный инструмент Plugin с краткими встроенными системными указаниями и сопутствующим Skill, который превращает содержимое изменений в доступный только для чтения артефакт diff для агентов.

Он принимает:

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

Он может возвращать:

• URL просмотрщика Gateway для представления на canvas
• путь к отрендеренному файлу (PNG или PDF) для доставки в сообщении
• оба результата за один вызов

Если плагин включен, он добавляет краткие указания по использованию в пространство системного промпта, а также предоставляет подробный 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 плагина diffs, сохраняя доступными сам плагин, инструмент и сопутствующий Skill.

Если вы хотите отключить и указания, и инструмент, отключите плагин.

Типичный рабочий процесс агента

Примеры входных данных

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

Справочник входных данных инструмента

Все поля необязательны, если не указано иное.

Подсветка синтаксиса

OpenClaw включает подсветку синтаксиса для распространенных языков исходного кода, конфигурации и документации:

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, нормализуются к этим стандартным языкам.

Установите Plugin языкового пакета просмотрщика различий, чтобы подсвечивать другие языки:

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

Когда языковой пакет доступен, OpenClaw может подсвечивать гораздо больше языков. Если пакет не установлен, файлы вне списка по умолчанию все равно отображаются как читаемый простой текст. Примеры включают 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 Diffs Language Pack, а каталог языков и псевдонимов верхнего уровня Shiki — в языках Shiki.

Контракт сведений вывода

Инструмент возвращает структурированные метаданные в details.

Сводка поведения режимов:

Свернутые неизмененные разделы

• Средство просмотра может показывать строки вида N unmodified lines.
• Элементы управления раскрытием для таких строк условны и не гарантируются для каждого вида ввода.
• Элементы управления раскрытием появляются, когда отрисованный diff содержит данные раскрываемого контекста, что типично для ввода до и после.
• Для многих входных данных в формате unified patch пропущенные тела контекста недоступны в разобранных hunks патча, поэтому строка может отображаться без элементов управления раскрытием. Это ожидаемое поведение.
• 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",            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.
• Метаданные артефакта просмотрщика содержат:
  • случайный ID артефакта (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, когда diff использует язык из Diff Viewer Language Pack

Документ просмотрщика разрешает эти ресурсы относительно URL просмотрщика, поэтому необязательный префикс пути baseUrl также сохраняется для обоих запросов ресурсов.

Поведение построения URL:

• Если в tool-call предоставлен baseUrl, он используется после строгой проверки.
• Иначе, если настроен 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").

Связанные материалы

• Браузер
• Плагины
• Обзор инструментов