diff --git a/README.md b/README.md
index 028289f..e5abc3d 100644
--- a/README.md
+++ b/README.md
@@ -75,8 +75,24 @@ Chrome / Edge / Firefox / Safari 的近两年版本，以及移动端浏览器
 ```
 index.html    全部内容：结构、样式、脚本
 docs/         README 用的界面截图
+  logo/       品牌 logo 多尺寸 PNG（5 档 × 带阴影/无阴影）
 ```
 
+`docs/logo/` 里的图**只进仓库、不部署到站点**（`_sp_deploy.sh` 只覆盖 `index.html`），
+所以线上访问 `https://password.yangyq.net/docs/logo/logo-1024.png` 会 404 —— 这是预期行为。
+
+重新导出 logo（脚本在仓库外的 `_tooling/`，需要 `playwright` + `Pillow`）：
+
+```bash
+node _sp_logo_export.js      # 输出到 docs/logo/：logo-{64,128,256,512,1024}[-flat].png
+python3 _sp_logo_verify.py    # 像素判据 95 项：白边比例 / 主体居中 / 阴影朝向 / 圆角
+python3 _sp_logo_verify_falsify.py   # 反证 6 条：证明上面那套判据抓得住 bug
+```
+
+尺寸是 64/128/256/512/1024 五档，每档两版：`logo-N.png` 带品牌阴影（用于展示场合）、
+`logo-N-flat.png` 无阴影（用于 favicon、深色底、贴边摆放）。画布是正方形，
+白边控制在 shadow 8% / flat 3%（旧版 41%）。
+
 ## 开发校验
 
 改完 `index.html` 后建议跑一遍（脚本在仓库外的 `_tooling/`，配合 `jsdom` 与 `playwright`）：