當你需要將編輯內容顯示為真正的差異比對結果時,請優先使用 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。
使用 mode=file 可獲得一個渲染後的檔案成品。請設定 fileFormat=png(預設值)或 fileFormat=pdf。工具結果會包含 details.filePath。
對於大型或需要高解析度的檔案,可以使用 fileQuality(standard | hq | print),並可選擇覆寫 fileScale / fileMaxWidth。
當你需要將渲染後的檔案傳送給使用者或頻道時,請不要依賴工具本身的原始渲染結果。相反地,請使用可用的檔案傳送工具,將 details.filePath 作為附件發送。
使用 mode=both 可同時取得網關檢視器網址與渲染後的檔案成品。
如果使用者已設定 diffs 外掛程式預設值,建議省略 mode、theme、layout 及相關的呈現選項,除非你必須針對此次差異比對進行覆寫。
當你確定檔案名稱時,請在 before / after 文字中包含 path 參數。