Diffs

这个“Diffs”工具是一个可选的小插件。它就像一个小助手，能把“修改前”和“修改后”的文字，或者一个叫“补丁”（patch）的东西，变成一张清晰的对比图。你可以把它想成玩“找不同”游戏时，帮你把不同点圈出来的神奇眼镜。

第一步：让小工具开始工作 要使用它，你需要先把它打开（启用）。

1. 在配置里找到 plugins.entries.diffs 这个地方。
2. 把里面的 enabled 这个开关，从 false 改成 true。

第二步：告诉小工具你想怎么玩 小工具准备好了，你就可以叫它来帮忙了。你需要告诉它两样东西：一是你要比较什么，二是你想要什么结果。

1. 给它看东西：你可以给它看两段文字（before 和 after），或者给它一个“补丁”（patch）。注意哦，这两样东西不能同时给，只能选一种。
2. 告诉它你想要什么：用 mode 来告诉它。
   • 如果你想在屏幕上直接看，就说 mode: "view"。
   • 如果你想要一张图片或一个文件，就说 mode: "file"。
   • 如果两个都想要，就说 mode: "both"。

一些重要的提醒和规则

• 小心别给太多：before 和 after 的文字不能太大，每个最多512KB。patch 可以大一点，但也不能超过2MB。
• 注意安全设置：默认情况下，生成的对比图只能在你的电脑本地看。如果你想让别人也能通过网络看到，需要把 security.allowRemoteViewer 这个设置改成 true。不过，除非你真的需要，否则最好别打开它。
• 需要一个小帮手：如果你想生成图片（PNG）或文件（PDF），你的电脑里需要安装一个像Chrome、Edge这样的浏览器。如果小工具说找不到，你就需要去安装一个，或者告诉它浏览器装在哪里。
• 东西会自己消失：生成的对比图不会永远留着。默认30分钟后就会自动清理掉，最长也只能保留6小时。所以重要的东西要及时看或保存哦。
• 有些行可能打不开：在看对比图时，有些没改动的行会折叠起来。如果它来自“补丁”（patch），可能就没有“展开”按钮，这是正常的，不是坏了。

如果遇到问题怎么办？

• 如果小工具说“Provide patch or both before and after text”，意思是：你需要同时提供 before 和 after 两段文字，或者只提供一个 patch。
• 如果它说“Provide either patch or before/after input, not both”，意思是：patch 和 before/after 不能混在一起用，只能选一种。
• 如果生成的图片网址打不开，默认它只能在你自己的电脑上打开（网址是127.0.0.1）。如果你想让别人也能打开，需要在调用工具时提供一个 baseUrl，或者修改网关的主机设置。

给小工具换个皮肤（设置默认样子） 你可以提前告诉小工具你喜欢的样式，比如用深色还是浅色背景，图片格式用PNG还是PDF。这些设置可以写在 ~/.openclaw/openclaw.json 文件里的 plugins.entries.diffs.config.defaults 下面。这样以后每次用它，它就会按你喜欢的样式来工作啦。