用 WorkBuddy 做「更新差异」清单:只列与上一版不同的行
版本公告看完,往往还是不知道「到底改了什么」。官方描述写得笼统,逐条猜很费力。这次用 WorkBuddy 做了一件很简单的事:把新旧两份资料逐行对比,只输出发生变化的行。
对比表怎么定
| 字段 | 内容 |
|---|---|
| 对象 | 改的是哪个条目 |
| 字段 | 具体哪一项数值或描述 |
| 旧值 | 上一版内容 |
| 新值 | 本版内容 |
| 变化类型 | 上调/下调/新增/删除 |
「变化类型」单独列一栏,比只给前后值更好扫。读者常常只关心「有没有削」,一眼看到类型就能判断要不要细看。
工具负责什么
把新旧两份交给 WorkBuddy,要求逐行比对,只输出差异行,按上面格式列成表格;不改写、不合并、不解释原因。这与 WorkBuddy 文档 里强调的「先说清输入与边界再执行」一致:把「只列差异」写死,输出才干净。
关于「数据要能逐行对齐」这件事,BackendWiki 里讲字段结构的思路同样适用:两版要对得上,字段名得一致;字段名一改,比对就会大面积误报。
跑完之后的两步
- 把差异行按「影响大不大」排序,不按出现顺序。
- 每条差异配一句「对谁有影响」,没影响的删掉。
第二步让清单从「改了什么」升级为「谁要注意什么」。版本公告的读者不是所有玩家,而是受影响的那部分。
适用边界
适合有结构化字段的资料:数值表、属性表、配置表。纯描述性长文逐行比对效果差,更适合人工看。另外,字段名变动频繁的资料,比对前先统一字段名,否则差异表会不可读。
小结
更新公告不必逐句猜,把新旧两版对齐就行。只列差异、标清类型、配一句影响,一次版本变更就能从「好像改了」变成「具体改了这几处」。