md5sum uploads/2026/11/*.jpg | sort | uniq -w32 -D wp post list --post_type=attachment --format=ids
编辑改一次封面就重传一遍，几个月下来媒体库里同一个文件名带着不同序号排了十几条，每一条还各存了一整套缩略图。先别急着动参数，把报错原文和时间点记下来，顺序反了容易白折腾。
原因不复杂，同名文件落盘时自动追加序号，插入之前没有按内容做比对，每个副本还各自生成一整套尺寸，文件数量和磁盘占用一起翻倍。
围绕「媒体库重复附件」排查时，命令行跑一遍比在面板里点十次有用，面板会替你做掉不少隐式操作。备份不是备了就行，恢复一次才算数，很多备份文件打开才发现是空的。
接口问题先分清是没发出去、发出去了没收到，还是收到了处理失败。
处理上按这个顺序：上传之前先算一遍文件内容哈希 拿去库里查重；命中就直接复用已有的那个附件 不再新建一份；把批量重复的那些挑出来 统一做一次合并清理。
改完只确认一件事：同一张图在媒体库里只会留一条记录，磁盘占用也跟着回落。