生成器可检测与管理远端主题素材（列表 / 差异 / 覆盖 / 删除）

「传上去」之后还得知道「传得对不对」：同一 slug 传过三次、换过 slug 旧图还在、
重新导出后远端仍是旧版，这些在页面上都看不出来。

- serve.py：s3_request 支持 query；新增 ListObjectsV2（含分页）与 DeleteObject，
  端点 /api/s3/list、/api/s3/delete。
- index.html：远端素材清单按对象键名跟本地比 —— 一致 / 旧图（同名但大小不同）/
  多余（当前主题已不引用）/ 缺失。「补齐差异」只传缺的与旧图，「删除多余」批量删，
  单行可 ↻ 覆盖或 ✕ 删除；删除走 confirm 二次确认。改过 slug 会提示重新检测。
- 修：list 返回完整键而 upload/delete 收相对键，不剥前缀会删到不存在的键
  （S3 回 204，看起来删成功其实没删）。加 relKey() 统一。
- check_sigv4.py 补带 query 的用例（ListObjectsV2 三参数、乱序 token）→ 8/8；
  selftest_upload.py 补列表/分页/幂等删除 → 20 项全过。

dev/theme-builder/README.md

@@ -225,6 +225,24 @@ WebP 体积 ≈ 像素数 × 质量。**真正的大头是像素**：CSS 里只
 需要自定义域或 CDN 域名，那种情况自己填「公开前缀」。测试里的「匿名可读」会给一条提醒，
 但不会拦上传 —— 很多人就是靠自定义域分发的。
 
+### 检测与清理
+
+传上去只是第一步，「传上去之后对不对」是另一回事：同一个 slug 传过三次、换过 slug
+旧图还留在桶里、重新导出后远端还是旧版 —— 这些在页面上都看不出来。所以还有一块
+「远端素材」，点「**检测**」列出 `<路径前缀>/<slug>/` 下所有对象，按对象键名跟本地比：
+
+| 状态 | 判断依据 | 能做什么 |
+| --- | --- | --- |
+| 一致 | 远端大小 == 本地编码后大小 | — |
+| 旧图 | 同名但大小不同（多半重新导出过） | 行内 ↻ 用本地覆盖 |
+| 多余 | 远端有、当前主题已不再引用（换过 slug / 删过素材） | 行内 ✕ 或「删除多余」批量删 |
+| 缺失 | 本地有、远端没有 | 「补齐差异」一次传完 |
+
+- 「**补齐差异**」只传缺失 + 旧图，一致的不重传（省流量也省时间）；
+- 「**删除多余**」列清单后二次确认，走 `DeleteObject`（幂等，不存在的键也算成功）；
+- 改过 slug 会提示「重新检测」—— 拿旧主题的清单去比新主题，会满屏「多余」；
+- 只动远端，本地素材与工程文件不受影响。
+
 厂商怎么填（2026 年的常见值，各家控制台都有「S3 API」页面）：
 
 | 厂商 | Endpoint | Region | 路径风格 |