수동 편집 요약 대신 실제 diff로 편집 내용을 보여줘야 할 때는 diffs 도구를 사용하세요.
diffs 도구는 before + after 텍스트 또는 통합 patch 문자열을 입력으로 받습니다.
details.changed를 확인하세요. before/after 입력이 동일하면 false를 반환하여 아티팩트를 생성하지 않으며, 렌더링된 결과는 true를 반환합니다.
대화형 게이트웨이 기반 뷰어가 필요하면 mode=view를 사용하세요. 도구가 반환된 후, 사용 가능한 표면-표시 도구로 details.viewerUrl을 제시하세요.
배포 환경에서 루프백 신뢰 프록시(예: gateway.trustedProxies에 127.0.0.1을 포함하는 Tailscale Serve)를 사용하는 경우, 전달된 클라이언트 IP 헤더가 없으면 원시 루프백 뷰어 요청이 거부될 수 있습니다. 이러한 토폴로지에서는 mode=file / mode=both를 선호하거나, 공유 가능한 뷰어 URL이 필요할 때는 구성된 viewerBaseUrl / 명시적 프록시/공용 baseUrl을 사용하세요.
렌더링된 파일 아티팩트가 필요하면 mode=file을 사용하세요. fileFormat은 png(기본값) 또는 pdf로 설정하세요. 도구 결과에는 details.filePath가 포함됩니다.
크거나 고해상도 파일의 경우 fileQuality(standard|hq|print)를 사용하고, 필요 시 fileScale/fileMaxWidth를 재정의할 수 있습니다.
렌더링된 파일을 사용자나 채널에 전달해야 하는 경우, 원시 도구 결과 렌더러에 의존하지 마세요. 대신 사용 가능한 파일 전송 도구를 사용하여 details.filePath를 첨부 파일로 보내세요.
게이트웨이 뷰어 URL과 렌더링된 아티팩트를 모두 원하면 mode=both를 사용하세요.
사용자가 diffs 플러그인 기본값을 구성한 경우, 이 특정 diff에 대해 재정의할 필요가 없으면 mode, theme, layout 및 관련 표시 옵션을 생략하는 것을 선호하세요.
파일 이름을 알고 있을 때는 before/after 텍스트에 path를 포함하세요.