Khác biệt

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• văn bản before và after
• một patch hợp nhất

• URL trình xem Gateway để trình bày trên canvas
• đường dẫn tệp đã render (PNG hoặc PDF) để gửi qua tin nhắn
• cả hai đầu ra trong một lần gọi

​

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

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

​

Quy trình tác nhân điển hình

​

Ví dụ đầu vào

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

​

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

​

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

​

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

• Trình xem có thể hiển thị các hàng như N unmodified lines.
• Các điều khiển mở rộng trên những hàng đó là có điều kiện và không được bảo đảm cho mọi loại đầu vào.
• Các điều khiển mở rộng xuất hiện khi diff đã render có dữ liệu ngữ cảnh có thể mở rộng, điều này thường gặp với đầu vào trước và sau.
• Với nhiều đầu vào unified patch, phần thân ngữ cảnh bị bỏ qua không có sẵn trong các hunk patch đã phân tích, vì vậy hàng có thể xuất hiện mà không có điều khiển mở rộng. Đây là hành vi dự kiến.
• expandUnchanged chỉ áp dụng khi tồn tại ngữ cảnh có thể mở rộng.

​

Mặc định của Plugin

{
  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

​

Cấu hình URL trình xem bền vững

{
  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ữ tạo tác

• Tạo tác được lưu trong thư mục con tạm: $TMPDIR/openclaw-diffs.
• Siêu dữ liệu tạo tác trình xem chứa:
  • ID tạo tác ngẫu nhiên (20 ký tự hex)
  • token ngẫu nhiên (48 ký tự hex)
  • createdAt và expiresAt
  • đường dẫn viewer.html đã lưu
• TTL tạo tác mặc định là 30 phút khi không được chỉ định.
• TTL trình xem tối đa được chấp nhận là 6 giờ.
• Dọn dẹp chạy theo cơ hội sau khi tạo tạo tác.
• Tạo tác hết hạn sẽ bị xóa.
• Dọn dẹp dự phòng sẽ xóa các thư mục cũ hơn 24 giờ khi thiếu siêu dữ liệu.

​

Hành vi URL trình xem và mạng

• /plugins/diffs/view/{artifactId}/{token}

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js

• Nếu baseUrl của lần gọi công cụ được cung cấp, nó sẽ được sử dụng sau khi xác thực nghiêm ngặt.
• Nếu không, nếu viewerBaseUrl của Plugin được cấu hình, nó sẽ được sử dụng.
• Nếu không có ghi đè nào, URL trình xem mặc định là loopback 127.0.0.1.
• Nếu chế độ bind Gateway là custom và gateway.customBindHost được đặt, host đó sẽ được sử dụng.

• Phải là http:// hoặc https://.
• Query và hash sẽ bị từ chối.
• Origin cộng với đường dẫn cơ sở tùy chọn được cho phép.

​

Mô hình bảo mật

​

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

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

​

Khắc phục sự cố

​

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

• Ưu tiên mode: "view" cho các phiên đánh giá tương tác cục bộ trong canvas.
• Ưu tiên mode: "file" cho các kênh chat đi ra ngoài cần tệp đính kèm.
• Giữ allowRemoteViewer ở trạng thái tắt trừ khi triển khai của bạn yêu cầu URL trình xem từ xa.
• Đặt ttlSeconds ngắn và rõ ràng cho các diff nhạy cảm.
• Tránh gửi bí mật trong đầu vào diff khi không bắt buộc.
• Nếu kênh của bạn nén ả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
• Plugins
• Tổng quan công cụ