ส่วนต่าง

diffs เป็นเครื่องมือ Plugin แบบบันเดิลที่เลือกใช้ได้ ซึ่งแปลงข้อความก่อน/หลังหรือแพตช์แบบ unified ให้เป็นอาร์ติแฟกต์ diff แบบอ่านอย่างเดียว นอกจากนี้ยังเพิ่มคำแนะนำสั้นๆ สำหรับเอเจนต์ไว้ด้านหน้าของพรอมต์ระบบ และมาพร้อม Skills คู่กันสำหรับคำแนะนำที่ครบถ้วนยิ่งขึ้น

อินพุต: ข้อความ before + after หรือ patch แบบ unified (ใช้ร่วมกันไม่ได้)

เอาต์พุต: URL ตัวดูของ Gateway สำหรับนำเสนอบนแคนวาส, พาธไฟล์ PNG/PDF ที่เรนเดอร์แล้วสำหรับส่งข้อความ หรือทั้งสองอย่าง

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

openclaw plugins install diffs

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

ปิดคำแนะนำระบบในตัว

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

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

การตั้งค่านี้จะบล็อกฮุก before_prompt_build ของ Plugin ขณะที่ยังคงใช้งานเครื่องมือและ Skills ได้ หากต้องการปิดทั้งคำแนะนำและเครื่องมือ ให้ปิด Plugin แทน

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

ทุกฟิลด์เป็นตัวเลือก เว้นแต่จะระบุไว้เป็นอย่างอื่น

การเน้นไวยากรณ์

ภาษาในตัว:

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

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

ติดตั้ง Plugin Diff Viewer Language Pack เพื่อรองรับภาษาเพิ่มเติม (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 และอื่นๆ):

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

หากไม่มีแพ็ก ภาษาที่ไม่รองรับจะยังคงเรนเดอร์เป็นข้อความธรรมดาที่อ่านได้ ดูแค็ตตาล็อกจากต้นทางได้ที่ Plugin Diffs Language Pack และ ภาษาของ Shiki

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

ผลลัพธ์ที่สำเร็จทั้งหมดมี changed: อินพุตก่อน/หลังที่เหมือนกันจะคืนค่า false โดยไม่สร้างอาร์ติแฟกต์ ส่วนผลลัพธ์ที่เรนเดอร์แล้วจะคืนค่า true

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

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

การนำทางแบบหลายไฟล์

แพตช์ที่แก้ไขมากกว่าหนึ่งไฟล์จะเริ่มด้วยการ์ดสรุปไฟล์ที่เปลี่ยนแปลง: จำนวนรวม +N / -N, จำนวนต่อไฟล์, ป้ายเพิ่ม/ลบ/เปลี่ยนชื่อ และลิงก์แองเคอร์ที่ข้ามไปยังแต่ละไฟล์ ไฟล์ PNG/PDF ที่เรนเดอร์แล้วจะคงจำนวนในส่วนหัวต่อไฟล์ไว้ แต่ตัดตัวสลับมุมมองแบบโต้ตอบออก เนื่องจากตัวควบคุมเหล่านั้นใช้งานไม่ได้ในไฟล์แบบคงที่

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

คีย์ defaults ที่รองรับ: 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,          },        },      },    },  },}

วงจรชีวิตและพื้นที่จัดเก็บอาร์ติแฟกต์

• HTML และข้อมูลเมตาของ Viewer อยู่ในฐานข้อมูล state/openclaw.sqlite ที่ใช้ร่วมกันภายใต้เนมสเปซ Blob ของ Plugin Diffs โดย HTML จะถูกบีบอัดด้วย gzip ส่วน SQLite จะจัดเก็บเฉพาะแฮช SHA-256 ของโทเค็น URL แบบสุ่ม ไม่ได้จัดเก็บตัวโทเค็นเอง
• ไฟล์ PNG/PDF ที่เรนเดอร์แล้วยังคงเป็นไฟล์ชั่วคราวภายใต้ $TMPDIR/openclaw-diffs เนื่องจากการส่งผ่านช่องทางต้องใช้พาธไฟล์ SQLite เป็นผู้จัดการข้อมูลเมตาการหมดอายุของไฟล์เหล่านี้ และไม่มีการเขียนไฟล์ JSON ประกอบ
• TTL เริ่มต้นของอาร์ติแฟกต์: 30 นาที TTL สูงสุดที่ยอมรับ: 6 ชั่วโมง
• การล้างข้อมูลจะทำงานตามโอกาสหลังการเรียกสร้างอาร์ติแฟกต์แต่ละครั้ง โดยลบแถว SQLite ที่หมดอายุก่อน แล้วจึงลบไดเรกทอรี PNG/PDF ที่เกี่ยวข้อง
• การกวาดข้อมูลสำรองจะลบโฟลเดอร์ชั่วคราวที่ไม่มีแถวข้อมูลและมีอายุเกิน 24 ชั่วโมง โดยจะไม่นำเข้าหรืออ่านแคชเดิม meta.json, file-meta.json และ viewer.html

URL ของ Viewer และลักษณะการทำงานของเครือข่าย

เส้นทาง Viewer: /plugins/diffs/view/{artifactId}/{token}

แอสเซ็ตของ Viewer:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js (เฉพาะเมื่อ diff ใช้ภาษาของชุดภาษา)

เอกสาร Viewer จะอ้างอิงแอสเซ็ตเหล่านี้โดยสัมพันธ์กับ URL ของ Viewer ดังนั้นคำนำหน้าพาธ baseUrl ซึ่งเป็นตัวเลือกจะถูกใช้กับคำขอแอสเซ็ตด้วย

ลำดับการแก้ไข URL: baseUrl จากการเรียกเครื่องมือ (หลังผ่านการตรวจสอบอย่างเข้มงวด) -> viewerBaseUrl ของ Plugin -> ค่าเริ่มต้นแบบลูปแบ็ก 127.0.0.1 หากโหมดการผูก Gateway เป็น custom และมีการตั้งค่า gateway.customBindHost ระบบจะใช้โฮสต์นั้นแทนลูปแบ็ก

กฎของ baseUrl: ต้องเป็น http:// หรือ https://; ระบบจะปฏิเสธคิวรีและแฮช; อนุญาตให้ใช้ต้นทางพร้อมพาธฐานซึ่งเป็นตัวเลือก

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

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

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

ลำดับการค้นหา:

ข้อความแสดงความล้มเหลวทั่วไป: Diff PNG/PDF rendering requires a Chromium-compatible browser... แก้ไขโดยติดตั้ง Chrome, Chromium, Edge หรือ Brave หรือตั้งค่าตัวเลือกพาธไฟล์ปฏิบัติการรายการใดรายการหนึ่งข้างต้น

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

แนวทางการดำเนินงาน

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

เนื้อหาที่เกี่ยวข้อง

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