Khác biệt

diffs là một công cụ plugin đi kèm tùy chọn, chuyển văn bản trước/sau hoặc một bản vá hợp nhất thành phần tạo tác diff chỉ đọc. Công cụ này cũng thêm hướng dẫn ngắn cho agent vào đầu lời nhắc hệ thống và cung cấp một skill đi kèm với hướng dẫn đầy đủ hơn.

Đầu vào: văn bản before + after, hoặc một patch hợp nhất (loại trừ lẫn nhau).

Đầu ra: URL trình xem của Gateway để trình bày trên canvas, đường dẫn tệp PNG/PDF đã kết xuất để gửi qua tin nhắn, hoặc cả hai.

Bắt đầu nhanh

openclaw plugins install diffs

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

Tắt hướng dẫn hệ thống tích hợp sẵn

Để giữ công cụ nhưng loại bỏ hướng dẫn được thêm vào đầu lời nhắc hệ thống, hãy đặt plugins.entries.diffs.hooks.allowPromptInjection thành false:

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

Thao tác này chặn hook before_prompt_build của plugin nhưng vẫn giữ công cụ và skill khả dụng. Để tắt cả hướng dẫn lẫn công cụ, hãy tắt plugin.

Tham chiếu đầu vào của công cụ

Tất cả các trường đều là tùy chọn, trừ khi có ghi chú khác.

Tô sáng cú pháp

Các ngôn ngữ tích hợp sẵn:

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 và toml.

Các bí danh phổ biến (js, ts, bash, md, yml, c++, dockerfile, rb, kt, ps1, v.v.) được chuẩn hóa thành các ngôn ngữ đó.

Cài đặt plugin Diff Viewer Language Pack để có thêm ngôn ngữ (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 và nhiều ngôn ngữ khác):

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

Khi không có gói này, các ngôn ngữ không được hỗ trợ vẫn được kết xuất dưới dạng văn bản thuần túy dễ đọc. Xem plugin Diffs Language Pack và các ngôn ngữ Shiki để biết danh mục từ dự án thượng nguồn.

Hợp đồng chi tiết đầu ra

Tất cả kết quả thành công đều bao gồm changed: đầu vào trước/sau giống hệt nhau trả về false mà không tạo phần tạo tác; kết quả đã kết xuất trả về true.

Các phần không thay đổi được thu gọn

Trình xem hiển thị các hàng như N unmodified lines. Các nút điều khiển mở rộng chỉ xuất hiện khi diff đã kết xuất có dữ liệu ngữ cảnh có thể mở rộng (thường gặp với đầu vào trước/sau). Nhiều bản vá hợp nhất bỏ qua phần thân ngữ cảnh trong các hunk, vì vậy hàng có thể xuất hiện mà không có nút điều khiển mở rộng -- đây là hành vi dự kiến, không phải lỗi. expandUnchanged chỉ áp dụng khi có ngữ cảnh có thể mở rộng.

Điều hướng nhiều tệp

Các bản vá tác động đến nhiều hơn một tệp bắt đầu bằng một thẻ tóm tắt tệp đã thay đổi: tổng số +N / -N, số lượng theo từng tệp, huy hiệu đã thêm/đã xóa/đã đổi tên và các liên kết neo để chuyển đến từng tệp. Các tệp PNG/PDF đã kết xuất giữ lại số lượng trong tiêu đề của từng tệp nhưng loại bỏ các nút chuyển đổi chế độ xem tương tác, vì chúng là các nút điều khiển không hoạt động trong tệp tĩnh.

Giá trị mặc định của plugin

Đặt các giá trị mặc định trên toàn plugin trong ~/.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,          },        },      },    },  },}

Các khóa defaults được hỗ trợ: fontFamily, fontSize, lineSpacing, layout, showLineNumbers, diffIndicators, wordWrap, background, theme, fileFormat, fileQuality, fileScale, fileMaxWidth, mode, ttlSeconds. Các tham số gọi công cụ được chỉ định rõ ràng sẽ ghi đè những giá trị này.

Cấu hình URL trình xem cố định

{  plugins: {    entries: {      diffs: {        enabled: true,        config: {          viewerBaseUrl: "https://gateway.example.com/openclaw",        },      },    },  },}

Cấu hình bảo mật

{  plugins: {    entries: {      diffs: {        enabled: true,        config: {          security: {            allowRemoteViewer: false,          },        },      },    },  },}

Vòng đời và lưu trữ phần tạo tác

• HTML của trình xem và siêu dữ liệu nằm trong cơ sở dữ liệu state/openclaw.sqlite dùng chung, thuộc không gian tên blob của plugin Diffs. HTML được nén bằng gzip; SQLite chỉ lưu hàm băm SHA-256 của token URL ngẫu nhiên, không lưu chính token đó.
• Các tệp PNG/PDF đã kết xuất vẫn là các bản hiện thực hóa tạm thời trong $TMPDIR/openclaw-diffs vì việc phân phối qua kênh yêu cầu đường dẫn tệp. SQLite quản lý siêu dữ liệu hết hạn của chúng; không ghi tệp JSON phụ trợ nào.
• TTL mặc định của tạo phẩm: 30 phút. TTL tối đa được chấp nhận: 6 giờ.
• Quá trình dọn dẹp chạy theo cơ hội sau mỗi lệnh gọi tạo tạo phẩm. Các hàng SQLite đã hết hạn được xóa trước, sau đó là mọi thư mục PNG/PDF tương ứng.
• Một lượt quét dự phòng xóa các thư mục tạm thời không có hàng tương ứng và cũ hơn 24 giờ. Các bộ nhớ đệm cũ meta.json, file-meta.json và viewer.html không được nhập hoặc đọc.

URL của trình xem và hành vi mạng

Tuyến trình xem: /plugins/diffs/view/{artifactId}/{token}

Tài nguyên của trình xem:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js (chỉ khi diff sử dụng ngôn ngữ của gói ngôn ngữ)

Tài liệu trình xem phân giải các tài nguyên này tương đối theo URL của trình xem, vì vậy tiền tố đường dẫn baseUrl tùy chọn cũng được áp dụng cho các yêu cầu tài nguyên.

Thứ tự phân giải URL: baseUrl của lệnh gọi công cụ (sau khi xác thực nghiêm ngặt) -> viewerBaseUrl của plugin -> mặc định loopback 127.0.0.1. Nếu chế độ liên kết Gateway là custom và gateway.customBindHost được đặt, máy chủ đó sẽ được dùng thay cho loopback.

Quy tắc baseUrl: phải là http:// hoặc https://; truy vấn và hàm băm bị từ chối; cho phép origin cùng đường dẫn cơ sở tùy chọn.

Mô hình bảo mật

Yêu cầu trình duyệt cho chế độ tệp

mode: "file" và mode: "both" cần trình duyệt tương thích với Chromium.

Thứ tự phân giải:

Thông báo lỗi thường gặp: Diff PNG/PDF rendering requires a Chromium-compatible browser.... Khắc phục bằng cách cài đặt Chrome, Chromium, Edge hoặc Brave, hoặc đặt một trong các tùy chọn đường dẫn tệp thực thi ở trên.

Khắc phục sự cố

Hướng dẫn vận hành

• Ưu tiên mode: "view" để review tương tác cục bộ trong canvas.
• Ưu tiên mode: "file" cho các kênh trò chuyện gửi ra ngoài cần tệp đính kèm.
• Giữ allowRemoteViewer ở trạng thái tắt trừ khi bản triển khai yêu cầu URL trình xem từ xa.
• Đặt ttlSeconds ngắn một cách tường minh cho các diff nhạy cảm.
• Tránh gửi bí mật trong đầu vào diff khi không cần thiết.
• Nếu kênh nén hình ảnh mạnh (ví dụ: Telegram hoặc WhatsApp), hãy ưu tiên đầu ra PDF (fileFormat: "pdf").

Liên quan

• Trình duyệt
• Plugin
• Tổng quan về công cụ