ส่วนต่าง

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.

• ข้อความ before และ after
• patch แบบ unified

• URL ตัวแสดงผลของ Gateway สำหรับการนำเสนอแบบแคนวาส
• พาธไฟล์ที่เรนเดอร์แล้ว (PNG หรือ PDF) สำหรับการส่งผ่านข้อความ
• เอาต์พุตทั้งสองแบบในการเรียกครั้งเดียว

​

เริ่มต้นอย่างรวดเร็ว

openclaw plugins install diffs

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

​

ปิดใช้งานคำแนะนำระบบในตัว

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

​

เวิร์กโฟลว์เอเจนต์ทั่วไป

​

ตัวอย่างอินพุต

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

​

เอกสารอ้างอิงอินพุตของเครื่องมือ

​

สัญญารายละเอียดเอาต์พุต

​

ส่วนที่ไม่เปลี่ยนแปลงซึ่งถูกยุบไว้

• ตัวแสดงผลสามารถแสดงแถวเช่น N unmodified lines
• ตัวควบคุมขยายบนแถวเหล่านั้นมีเงื่อนไข และไม่รับประกันว่าจะมีสำหรับอินพุตทุกชนิด
• ตัวควบคุมขยายจะปรากฏเมื่อ diff ที่เรนเดอร์มีข้อมูลบริบทที่ขยายได้ ซึ่งเป็นเรื่องปกติสำหรับอินพุตก่อนและหลัง
• สำหรับอินพุต unified patch จำนวนมาก เนื้อหาบริบทที่ละไว้จะไม่มีอยู่ใน hunk ของ patch ที่แยกวิเคราะห์แล้ว ดังนั้นแถวอาจปรากฏโดยไม่มีตัวควบคุมขยาย นี่เป็นพฤติกรรมที่คาดไว้
• expandUnchanged ใช้เฉพาะเมื่อมีบริบทที่ขยายได้อยู่เท่านั้น

​

ค่าเริ่มต้นของ 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

​

การกำหนดค่า 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 อาร์ติแฟกต์แบบสุ่ม (อักขระ hex 20 ตัว)
  • โทเค็นแบบสุ่ม (อักขระ hex 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

• หากระบุ baseUrl ในการเรียกเครื่องมือ ระบบจะใช้ค่านั้นหลังจากตรวจสอบอย่างเข้มงวด
• มิฉะนั้น หากกำหนดค่า viewerBaseUrl ของ Plugin ไว้ ระบบจะใช้ค่านั้น
• หากไม่มีค่าแทนที่ทั้งสองแบบ URL ตัวแสดงผลจะมีค่าเริ่มต้นเป็น loopback 127.0.0.1
• หากโหมด bind ของ Gateway เป็น custom และตั้งค่า gateway.customBindHost ไว้ ระบบจะใช้ host นั้น

• ต้องเป็น http:// หรือ https://
• Query และ hash จะถูกปฏิเสธ
• อนุญาตให้ใช้ origin พร้อมพาธฐานแบบไม่บังคับ

​

โมเดลความปลอดภัย

​

ข้อกำหนดของเบราว์เซอร์สำหรับโหมดไฟล์

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

​

การแก้ไขปัญหา

​

คำแนะนำการดำเนินงาน

• ควรใช้ mode: "view" สำหรับการรีวิวแบบโต้ตอบภายในเครื่องในแคนวาส
• ควรใช้ mode: "file" สำหรับช่องแชตขาออกที่ต้องใช้ไฟล์แนบ
• ปิดใช้ allowRemoteViewer ไว้ เว้นแต่การปรับใช้ของคุณต้องใช้ URL ของ Viewer ระยะไกล
• ตั้งค่า ttlSeconds แบบสั้นอย่างชัดเจนสำหรับ diff ที่ละเอียดอ่อน
• หลีกเลี่ยงการส่งข้อมูลลับในอินพุต diff เมื่อไม่จำเป็น
• หากช่องของคุณบีบอัดรูปภาพอย่างรุนแรง (ตัวอย่างเช่น Telegram หรือ WhatsApp) ควรใช้เอาต์พุต PDF (fileFormat: "pdf")

​

ที่เกี่ยวข้อง

• เบราว์เซอร์
• Plugin
• ภาพรวมเครื่องมือ