docs(readme): 补 docs/logo 说明与 logo 重新导出步骤 (#2)

- 目录树补 docs/logo/ 一行,注明「只进仓库、不部署到站点」,
  避免后续有人把线上 /docs/logo/logo-1024.png 的 404 误判成故障
  (_sp_deploy.sh 只覆盖 index.html)
- 新增 logo 重新导出命令:_sp_logo_export.js / _sp_logo_verify.py /
  _sp_logo_verify_falsify.py,解释器统一写 python3(WSL 无 python 别名)
- 尺寸档位按实际产物写 64/128/256/512/1024,五档 × 带阴影/无阴影
This commit is contained in:
2026-10-29 13:24:47 +08:00
parent 33166407ea
commit e09943fefb
+16
View File
@@ -75,8 +75,24 @@ Chrome / Edge / Firefox / Safari 的近两年版本,以及移动端浏览器
``` ```
index.html 全部内容:结构、样式、脚本 index.html 全部内容:结构、样式、脚本
docs/ README 用的界面截图 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`): 改完 `index.html` 后建议跑一遍(脚本在仓库外的 `_tooling/`,配合 `jsdom` 与 `playwright`):