Diff

diffs เป็นเครื่องมือ Plugin เสริมที่มีคำแนะนำระบบแบบสั้นในตัว และมี skill คู่กันสำหรับแปลงเนื้อหาการเปลี่ยนแปลงให้เป็นอาร์ติแฟกต์ diff แบบอ่านอย่างเดียวสำหรับเอเจนต์

รับอินพุตได้ทั้ง:

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

สามารถส่งคืน:

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

เมื่อเปิดใช้งาน Plugin จะเติมคำแนะนำการใช้งานแบบกระชับไว้ในพื้นที่ system prompt และยังเปิดเผย skill แบบละเอียดสำหรับกรณีที่เอเจนต์ต้องการคำแนะนำครบถ้วนกว่า

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

openclaw plugins install diffs

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

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

หากต้องการเปิดใช้เครื่องมือ diffs ต่อไป แต่ปิดใช้งานคำแนะนำ system prompt ในตัว ให้ตั้งค่า plugins.entries.diffs.hooks.allowPromptInjection เป็น false:

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

การตั้งค่านี้จะบล็อก hook before_prompt_build ของ Plugin diffs ขณะยังคงให้ Plugin, เครื่องมือ และ skill คู่กันพร้อมใช้งาน

หากต้องการปิดทั้งคำแนะนำและเครื่องมือ ให้ปิดใช้งาน Plugin แทน

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

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

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

alias ทั่วไป เช่น js, ts, bash, md, yml, c++, dockerfile, rb, kt, และ ps1 จะถูกทำให้เป็นภาษาค่าเริ่มต้นเหล่านั้นตามมาตรฐาน

ติดตั้ง Plugin Diff Viewer Language Pack เพื่อไฮไลต์ภาษาอื่น ๆ:

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 จำนวนมาก เนื้อหาบริบทที่ถูกละไว้จะไม่มีอยู่ใน hunk ของแพตช์ที่แยกวิเคราะห์แล้ว ดังนั้นแถวจึงอาจปรากฏโดยไม่มีตัวควบคุมการขยายได้ ซึ่งเป็นพฤติกรรมที่คาดไว้
• 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

เอกสารตัวแสดงผลจะ resolve แอสเซ็ตเหล่านั้นแบบสัมพันธ์กับ URL ของตัวแสดงผล ดังนั้นคำนำหน้าพาธ baseUrl ที่เป็นตัวเลือกจะถูกคงไว้สำหรับคำขอแอสเซ็ตทั้งสองรายการด้วย

พฤติกรรมการสร้าง URL:

• หากมี baseUrl ของ tool-call ให้มา จะใช้ค่านั้นหลังจากผ่านการตรวจสอบอย่างเข้มงวด
• มิฉะนั้น หากตั้งค่า Plugin viewerBaseUrl ไว้ จะใช้ค่านั้น
• หากไม่มี override ใด ๆ URL ของตัวแสดงผลจะใช้ค่าเริ่มต้นเป็น loopback 127.0.0.1
• หากโหมด bind ของ gateway เป็น custom และตั้งค่า gateway.customBindHost ไว้ จะใช้โฮสต์นั้น

กฎของ baseUrl:

• ต้องเป็น http:// หรือ https://
• ไม่ยอมรับ query และ hash
• อนุญาตให้ใช้ origin พร้อมพาธฐานที่เป็นตัวเลือกได้

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

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

mode: "file" และ mode: "both" ต้องใช้เบราว์เซอร์ที่เข้ากันได้กับ Chromium

ลำดับการ resolve:

ข้อความล้มเหลวที่พบบ่อย:

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

แก้ไขโดยติดตั้ง Chrome, Chromium, Edge หรือ Brave หรือตั้งค่าหนึ่งในตัวเลือกพาธ executable ด้านบน

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

แนวทางการปฏิบัติงาน

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

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

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