fix: 图标文件名按「整条网址」命名,同域名不同路径不再互相覆盖

https://nas.yangyq.net/calendar 与 https://nas.yangyq.net/ 这类「同域名、
不同路径」的条目,图标文件名原先只由域名决定(md5(域名)),两条记录指向
同一个文件:改其中一个的自定义图标,另一个跟着变;保存时还会 unlink /
覆盖掉对方的文件,直接把对方搞成破图。

- 新增 icon_key($url):按整条网址取键(协议与主机名转小写、空路径补 /、
  查询串与锚点保留),语义是「不同网址 → 不同图标文件」。
- 4 处调用点全部改用它:site_save(上传图标 / 自定义地址)、fetch_meta、
  update_all;键一律取自「记录里存的那条 URL」,不用跳转后的 final_url,
  保证同一个网站每次算出来的键都一样(否则每次重下 + 留下孤儿文件)。
- download_best_icon() / save_custom_icon() 增加空键保护,避免键为空时
  所有图标都落到同一个文件名上。
- README 新增「图标文件的命名规则」一节。
- .gitattributes 统一按 LF 存放,防止 Windows 的 core.autocrlf 在下次
  checkout 时把 PHP/JS/CSS 换成 CRLF。
- e2e 新增「同域名不同路径」回归场景:用三张颜色不同的图,比对两条记录
  落盘图标的内容,验证改 A 不会波及 B;并已做反向验证(把 icon_key 改回
  按域名取键后,这些断言确实失败)。
This commit is contained in:
2026-09-28 17:26:40 +08:00
parent 34473d0120
commit 4ba512b147
6 changed files with 99 additions and 9 deletions
+15 -1
View File
@@ -8,7 +8,7 @@
- **个人向**:单管理员,页面就是「你自己常用网站的起始页」。
- **搜索引擎可切换 + 联想下拉**:后台勾选喜欢的搜索引擎即可显示在顶部;输入时下拉建议词由服务端代理(规避跨域)。默认**联想词统一取百度、搜索走各自引擎**,并带自动兜底,任何引擎都保证有下拉词(详见下节实测表)。后台的「显示/隐藏」按钮点一下**原地生效、不跳页**,且无 JS 时也能正常提交。
- **添加即补全**:填网址后先访问该网址拿到标题,再按「高清优先」的顺序去网上找相关图标(`manifest` 512 → `apple-touch-icon` → `<link rel=icon>` → 第三方聚合服务),下载后统一规范化为 **128×128 PNG** 存到服务器本地。
- **图标可自定义,且自定义后不再被覆盖**:可为任一网站上传图标或直接填图标地址;一旦自定义,该网站的图标会被标记保护,「一键全部更新」只刷新它的名称、跳过图标。
- **图标可自定义,且自定义后不再被覆盖**:可为任一网站上传图标或直接填图标地址;一旦自定义,该网站的图标会被标记保护,「一键全部更新」只刷新它的名称、跳过图标。图标按**整条网址**分别存档,所以同一域名下的不同路径(如 `/calendar` 与 `/`)各自独立、互不影响。
- **显示简称**:每个网站有「名称(自动)」和「简称(手动)」两个字段,页面展示你自定义的简称。
- **自定义排序**:网站 / 板块 / 搜索引擎都可上移下移排序。
- **一键全部更新**:批量刷新所有网站的图标与名称,**不会改动你自定义的简称,也不会覆盖你自定义的图标**。
@@ -92,6 +92,20 @@ SimpleNav/
| `sogou_ajaj` | 搜狗 | `{"items":[…]}`(GBK,已自动转码) |
| `ddg` | DuckDuckGo | `[{"phrase":"…"}]` |
## 图标文件的命名规则
`uploads/icons/` 下的文件名 = `md5(icon_key(网址))` + 真实扩展名(`.png` / `.svg`)。
`icon_key()` **按整条网址**算,只做极少的归一化:协议与主机名转小写、空路径补成 `/`,
查询串与锚点(`#/calendar` 这类 SPA 路由)**原样保留**。
也就是说:**不同网址 → 不同图标文件**。同域名下的不同路径是两个独立的网站条目,例如
`https://nas.example.com/calendar` 与 `https://nas.example.com/` 各自拥有独立图标,
改一个不会影响另一个;`https://a.com` 与 `https://a.com/` 则视为同一个网址,共用一张图标。
> 早期版本曾用 `md5(域名)` 命名,导致同域名不同路径的两条记录指向同一个文件,
> 改其中一条的自定义图标会把另一条一起改掉、甚至把对方的文件删成破图。
## 许可
Apache License 2.0