用 WorkBuddy 做「更新差异」清单:只列与上一版不同的行

用 WorkBuddy 做「更新差异」清单:只列与上一版不同的行

版本公告看完,往往还是不知道「到底改了什么」。官方描述写得笼统,逐条猜很费力。这次用 WorkBuddy 做了一件很简单的事:把新旧两份资料逐行对比,只输出发生变化的行。

对比表怎么定

字段内容
对象改的是哪个条目
字段具体哪一项数值或描述
旧值上一版内容
新值本版内容
变化类型上调/下调/新增/删除

「变化类型」单独列一栏,比只给前后值更好扫。读者常常只关心「有没有削」,一眼看到类型就能判断要不要细看。

工具负责什么

把新旧两份交给 WorkBuddy,要求逐行比对,只输出差异行,按上面格式列成表格;不改写、不合并、不解释原因。这与 WorkBuddy 文档 里强调的「先说清输入与边界再执行」一致:把「只列差异」写死,输出才干净。

关于「数据要能逐行对齐」这件事,BackendWiki 里讲字段结构的思路同样适用:两版要对得上,字段名得一致;字段名一改,比对就会大面积误报。

跑完之后的两步

  1. 把差异行按「影响大不大」排序,不按出现顺序。
  2. 每条差异配一句「对谁有影响」,没影响的删掉。

第二步让清单从「改了什么」升级为「谁要注意什么」。版本公告的读者不是所有玩家,而是受影响的那部分。

适用边界

适合有结构化字段的资料:数值表、属性表、配置表。纯描述性长文逐行比对效果差,更适合人工看。另外,字段名变动频繁的资料,比对前先统一字段名,否则差异表会不可读。

小结

更新公告不必逐句猜,把新旧两版对齐就行。只列差异、标清类型、配一句影响,一次版本变更就能从「好像改了」变成「具体改了这几处」。