当需要以真实差异(diff)展示编辑内容时,请优先使用 diffs 工具,而不要手动编写摘要。
diffs 工具接受 before + after 文本,或统一格式的 patch 字符串。
检查 details.changed:如果输入的前后内容相同,则返回 false 且不创建产物;渲染后的结果返回 true。
使用 mode=view 可创建交互式网关托管的查看器。工具返回后,请使用可用的表面展示工具展示 details.viewerUrl。
如果部署使用了回环可信代理(例如 Tailscale Serve 的 gateway.trustedProxies 包含 127.0.0.1),则原始回环查看器请求可能因缺少转发的客户端 IP 头而被拒绝。在这种拓扑中,建议使用 mode=file / mode=both,或配置 viewerBaseUrl / 显式代理或公共 baseUrl 来获取可分享的查看器 URL。
使用 mode=file 可生成渲染后的文件产物。设置 fileFormat=png(默认)或 fileFormat=pdf。工具结果包含 details.filePath。
对于大型或高保真文件,请使用 fileQuality(standard|hq|print)并可选择覆盖 fileScale/fileMaxWidth。
当需要将渲染后的文件交付给用户或频道时,请不要依赖原始工具结果的渲染器。而是使用可用的文件发送工具将 details.filePath 作为附件发送。
使用 mode=both 可同时获得网关查看器 URL 和渲染产物。
如果用户已配置 diffs 插件默认值,则最好省略 mode、theme、layout 及相关展示选项,除非需要为此次差异覆盖这些值。
在提供 before/after 文本时,请包含 path 参数以指定文件名。