차이점

diffs는 변경 전/후 텍스트나 통합 패치를 읽기 전용 diff 아티팩트로 변환하는 선택적 번들 Plugin 도구입니다. 또한 시스템 프롬프트 앞에 간단한 에이전트 지침을 추가하고, 더 자세한 지침을 제공하는 보조 Skills를 함께 제공합니다.

입력: before + after 텍스트 또는 통합 patch(상호 배타적).

출력: 캔버스 표시에 사용할 Gateway 뷰어 URL, 메시지 전달에 사용할 렌더링된 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,        },      },    },  },}

이 설정은 도구와 Skills를 계속 사용할 수 있도록 유지하면서 Plugin의 before_prompt_build 훅을 차단합니다. 지침과 도구를 모두 비활성화하려면 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 등)은 해당 언어로 정규화됩니다.

더 많은 언어(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 등)를 사용하려면 Diff Viewer Language Pack Plugin을 설치하십시오.

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

팩이 없어도 지원되지 않는 언어는 읽을 수 있는 일반 텍스트로 렌더링됩니다. 업스트림 카탈로그는 Diffs Language Pack Plugin과 Shiki 언어를 참조하십시오.

출력 세부 정보 계약

성공한 모든 결과에는 changed가 포함됩니다. 변경 전/후 입력이 동일하면 아티팩트를 생성하지 않고 false를 반환하며, 렌더링된 결과는 true를 반환합니다.

접힌 변경되지 않은 섹션

뷰어에는 N unmodified lines와 같은 행이 표시됩니다. 렌더링된 diff에 확장 가능한 컨텍스트 데이터가 있을 때만 확장 컨트롤이 나타납니다(일반적으로 변경 전/후 입력의 경우). 많은 통합 패치는 헝크에서 컨텍스트 본문을 생략하므로 확장 컨트롤 없이 행만 나타날 수 있습니다. 이는 예상된 동작이며 버그가 아닙니다. expandUnchanged는 확장 가능한 컨텍스트가 있을 때만 적용됩니다.

여러 파일 탐색

둘 이상의 파일을 변경하는 패치는 변경된 파일 요약 카드로 시작합니다. 이 카드에는 총 +N / -N 개수, 파일별 개수, 추가됨/삭제됨/이름 변경됨 배지, 각 파일로 이동하는 앵커 링크가 포함됩니다. 렌더링된 PNG/PDF 파일은 파일별 헤더 개수를 유지하지만, 정적 파일에서는 작동하지 않는 컨트롤이므로 대화형 보기 전환 컨트롤은 제외합니다.

Plugin 기본값

~/.openclaw/openclaw.json에서 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,          },        },      },    },  },}

지원되는 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,          },        },      },    },  },}

아티팩트 수명 주기 및 저장소

• 아티팩트는 $TMPDIR/openclaw-diffs 아래에 저장됩니다.
• 뷰어 메타데이터에는 무작위 20자리 16진수 아티팩트 ID, 무작위 48자리 16진수 토큰, 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가 언어 팩 언어를 사용하는 경우에만 해당)

뷰어 문서는 이러한 에셋을 뷰어 URL을 기준으로 해석하므로, 선택적 baseUrl 경로 접두사도 에셋 요청에 적용됩니다.

URL 해석 순서: 도구 호출의 baseUrl(엄격한 검증 후) -> Plugin의 viewerBaseUrl -> 루프백 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"을 사용하십시오.
• 배포 환경에 원격 뷰어 URL이 필요하지 않다면 allowRemoteViewer를 비활성화된 상태로 유지하십시오.
• 민감한 diff에는 명시적으로 짧은 ttlSeconds를 설정하십시오.
• 필요하지 않은 경우 diff 입력에 비밀 정보를 포함하지 마십시오.
• 채널에서 이미지를 과도하게 압축하는 경우(예: Telegram 또는 WhatsApp) PDF 출력(fileFormat: "pdf")을 사용하십시오.

관련 항목

• 브라우저
• Plugin
• 도구 개요