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 改回
  按域名取键后，这些断言确实失败）。

.gitattributes

@@ -0,0 +1,14 @@
+# 统一按 LF 存放。Windows 上 core.autocrlf=true 会在下次 checkout 时把工作区
+# 文件换成 CRLF（git 会提示 "LF will be replaced by CRLF"），而本站是部署到
+# Linux 的 PHP 项目，不该带 CRLF 进去。
+* text=auto eol=lf
+
+# 二进制资源不参与换行符转换
+*.png binary
+*.ico binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.webp binary
+*.woff binary
+*.woff2 binary

README.md

@@ -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

admin/actions.php

@@ -59,7 +59,8 @@ try {
                 break;
             }
 
-            $domain = domain_of($url);
+            // 图标文件的命名键：按整条网址算（同域名不同路径必须互不覆盖，见 icon_key()）
+            $iconKey = icon_key($url);
 
             // ---- 图标 ----
             //   icon_auto 勾选 = 允许「全部更新」自动刷新图标（icon_custom=0）
@@ -74,7 +75,7 @@ try {
                 if ($bin === '' || strlen($bin) > 2 * 1024 * 1024) {
                     flash('图标文件过大或为空（限 2MB）', 'err');
                 } else {
-                    $new = save_custom_icon($bin, $domain);
+                    $new = save_custom_icon($bin, $iconKey);
                     if ($new !== '') {
                         $iconFile = $new;
                         $custom = 1;
@@ -85,7 +86,7 @@ try {
             } else {
                 $iconUrl = trim((string)($_POST['icon_url'] ?? ''));
                 if ($iconUrl !== '') {
-                    $new = download_best_icon([norm_url($iconUrl)], $domain, 1);
+                    $new = download_best_icon([norm_url($iconUrl)], $iconKey, 1);
                     if ($new !== '') {
                         $iconFile = $new;
                         $custom = 1;

admin/fetch_meta.php

@@ -19,7 +19,9 @@ if ($url === '') {
 
 $meta   = fetch_site_meta($url);
 $domain = domain_of($meta['final_url'] ?: $url);
-$iconFile = download_best_icon($meta['icons'], $domain);
+// 图标文件名按「用户填的那条网址」算，不用 final_url —— 否则站点日后每次抓取
+// （或跳转变化）都会算出不同的键，重复下载、留下孤儿文件。
+$iconFile = download_best_icon($meta['icons'], icon_key($url));
 
 $name = $meta['name'] !== '' ? $meta['name'] : ($meta['title'] !== '' ? $meta['title'] : $domain);
 

admin/update_all.php

@@ -32,7 +32,6 @@ foreach ($rows as $row) {
     $custom = (int)$row['icon_custom'] === 1;
 
     $meta = fetch_site_meta($url);
-    $domain = domain_of($meta['final_url'] ?: $url);
     $name = $meta['name'] !== '' ? $meta['name'] : $meta['title'];
 
     $sets = ['updated_at=?'];
@@ -43,7 +42,8 @@ foreach ($rows as $row) {
         // 用户自定义图标：绝不覆盖
         $skipped++;
     } else {
-        $iconFile = download_best_icon($meta['icons'], $domain);
+        // 键取自记录里存的那条 URL（不用 final_url），保证每次算出来都一样
+        $iconFile = download_best_icon($meta['icons'], icon_key($url));
         if ($iconFile !== '') { $sets[] = 'icon=?'; $args[] = $iconFile; }
         if ($iconFile !== '' || $name !== '') { $updated++; } else { $failed++; }
     }

functions.php

@@ -26,7 +26,12 @@ function norm_url(string $url): string
     return $url;
 }
 
-/** 取主域名（用于图标文件名与首字母回退） */
+/**
+ * 取主域名（用于首字母回退、标题回退等展示用途）。
+ *
+ * ⚠️ 不要再拿它当图标文件名！图标文件请一律用 icon_key($url) ——
+ *    同一域名下不同路径是两个不同的网站条目，用域名做键会互相覆盖。
+ */
 function domain_of(string $url): string
 {
     $host = parse_url(norm_url($url), PHP_URL_HOST);
@@ -301,14 +306,61 @@ function attr_value(string $tag, string $attr): string
  *  图标下载与规范化
  * ========================================================================= */
 
+/**
+ * 图标文件的命名键：**按整条网址**算，而不是只按域名。
+ *
+ * 为什么不能只用域名（2026-09-28 修的真实 bug）：
+ *   同一域名下不同路径往往是两个独立的网站条目，例如
+ *     https://nas.yangyq.net/calendar   与   https://nas.yangyq.net/
+ *   若键只取域名，两条记录会指向**同一个图标文件** —— 改其中一个的自定义图标，
+ *   另一个跟着变；更糟的是保存时会 `unlink` 那个文件名，直接把对方**搞成破图**。
+ *
+ * 归一化规则（尽量少，只抹掉「同一个网址的不同写法」带来的差异）：
+ *   - 协议与主机名转小写；主机名**不**去 www（`www.a.com` 与 `a.com` 是两个条目）
+ *   - 空路径补成 `/`（`https://a.com` 与 `https://a.com/` 视为同一个）
+ *   - 查询串、锚点（`#/calendar` 这类 SPA 路由）**保留**，它们是区分条目的信息
+ * 一句话：**不同网址 → 不同图标文件**。
+ *
+ * 注意：调用方要用「记录里存的那条 URL」来算，不要用跳转后的 final_url，
+ * 否则同一个网站在不同次请求里会算出不同的键（每次重下 + 留下孤儿文件）。
+ *
+ * 返回的是键（md5 十六进制串）；实际文件名会再哈希一次（历史遗留，只是让文件名长度固定，
+ * 不影响任何行为）。
+ */
+function icon_key(string $url): string
+{
+    $u = trim($url);
+    if ($u === '') {
+        return '';
+    }
+    if (!preg_match('#^https?://#i', $u)) {
+        $u = 'http://' . $u;
+    }
+    $p = @parse_url($u);
+    if (!is_array($p) || empty($p['host'])) {
+        return md5($u);   // 解析不出来就整串兜底，至少不会跟别人撞
+    }
+    $norm = strtolower((string)$p['scheme']) . '://'
+        . strtolower((string)$p['host'])
+        . (empty($p['port']) ? '' : ':' . $p['port'])
+        . (isset($p['path']) && $p['path'] !== '' ? $p['path'] : '/')
+        . (isset($p['query']) ? '?' . $p['query'] : '')
+        . (isset($p['fragment']) ? '#' . $p['fragment'] : '');
+    return md5($norm);
+}
+
 /**
  * 按候选顺序抓取图标，返回质量最佳的一张的本地文件名（失败返回 ''）。
  * 规则：min(宽,高) 越大越优；达到 $minGood 即停止；另有总耗时预算，避免批量更新超时。
  *
  * @param string[] $urls 候选图标地址（已按优先级排序）
+ * @param string   $key  图标文件的命名键，**请传 icon_key($url)**（不要传域名）
  */
 function download_best_icon(array $urls, string $key, int $minGood = 120, float $budget = 10.0): string
 {
+    if ($key === '') {          // 没有键就不写文件，避免全部落到 md5('') 上互相覆盖
+        return '';
+    }
     if (!is_dir(ICON_PATH)) {
         @mkdir(ICON_PATH, 0755, true);
     }
@@ -500,9 +552,16 @@ function grab_icon(string $iconUrl): ?array
     return ['tmp' => $tmp, 'ext' => 'png', 'w' => $w, 'h' => $h];
 }
 
-/** 保存用户上传/指定的自定义图标（文件内容直接给），返回本地文件名 */
+/**
+ * 保存用户上传/指定的自定义图标（文件内容直接给），返回本地文件名。
+ *
+ * @param string $key 图标文件的命名键，**请传 icon_key($url)**（不要传域名）
+ */
 function save_custom_icon(string $binary, string $key): string
 {
+    if ($key === '') {
+        return '';
+    }
     if (!is_dir(ICON_PATH)) {
         @mkdir(ICON_PATH, 0755, true);
     }