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 đã kết xuất (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

{
  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 agent đ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 đổ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 đã kết xuất 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 bản vá hợp nhất, phần thân ngữ cảnh bị lược bỏ không có sẵn trong các hunk bản vá đã phân tích, nên 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 có 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",
          },
        },
      },
    },
  },
}

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

​

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 thời: $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 mặc định của tạo tác 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 xóa các thư mục cũ hơn 24 giờ khi thiếu siêu dữ liệu.

​

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

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

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

• Nếu baseUrl của lệnh gọi công cụ được cung cấp, nó sẽ được 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 dùng.
• Khi không có ghi đè nào, URL trình xem mặc định là loopback 127.0.0.1.
• Nếu chế độ bind của Gateway là custom và gateway.customBindHost được đặt, host đó sẽ được dùng.

• Phải là http:// hoặc https://.
• Query và hash bị từ chối.
• Cho phép origin cộng với đườ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

• 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 trò chuyện gửi đi cần tệp đính kèm.
• Giữ allowRemoteViewer 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 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 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
• Plugins
• Tổng quan công cụ