diff --git a/.htaccess b/.htaccess
index bb5d694..10f7542 100644
--- a/.htaccess
+++ b/.htaccess
@@ -6,3 +6,35 @@
# 关闭目录浏览
Options -Indexes
+
+# 根目录静态资源(favicon / apple-touch-icon / webmanifest)也走「长缓存 + 版本号」
+# 注意:assets/ 下的资源由 assets/.htaccess 负责,这里只管根目录这几个文件。
+
+
+ Header set Cache-Control "public, max-age=31536000, immutable"
+
+
+
+# ---------------------------------------------------------------------------
+# 绕开「服务器侧整页缓存」
+#
+# 背景(2026-09-28 线上实测):服务器装了宝塔面板的「网站加速」,那是一层基于
+# memcached 的整页缓存(脚本 /www/server/speed/httpd_speed.lua,站点配置
+# /www/server/speed/config.lua 里 n.yangyq.net 这节,expire=30 秒)。它的缓存键
+# 按 host:port + 完整 URI 计算,只缓存 GET 的 text/html。
+#
+# 关键坑:它**读不到 FastCGI 后端返回的 Cache-Control**(实测存下来的副本里
+# 根本没有这个头),所以 PHP 里发的 no-store / no-cache 对它无效 —— 会出现
+# 「后台改完,前台刷新还是旧的」,而且因为每次 MISS 都会重新写入,旧页面窗口
+# 还会被后续访问不断续期(滑动 30 秒)。
+#
+# 它唯一认的「别缓存我」信号是**请求** cookie `X_CACHE=1`(它本来用于标记已登录
+# 用户)。这里就在请求侧直接注入该标记:edit 处理「已经有 Cookie」的情况,
+# setifempty 处理「完全没有 Cookie」的首次访问。
+#
+# 若哪天不需要了(例如该站点已关闭「网站加速」),整段删掉即可。
+# ---------------------------------------------------------------------------
+
+ RequestHeader edit Cookie "^(.*)$" "$1; X_CACHE=1"
+ RequestHeader setifempty Cookie "X_CACHE=1"
+
diff --git a/README.md b/README.md
index 627be07..241ed45 100644
--- a/README.md
+++ b/README.md
@@ -6,12 +6,14 @@
- **轻量**:纯 PHP + SQLite,不依赖 MySQL / 框架 / Composer;前端无 Bootstrap / jQuery,原生 CSS + JS。
- **个人向**:单管理员,页面就是「你自己常用网站的起始页」。
-- **搜索引擎可切换 + 联想下拉**:后台勾选喜欢的搜索引擎即可显示在顶部;输入时下拉联想词由服务端代理(规避跨域)。
-- **添加即补全**:填网址自动抓取网站名称、图标(图标下载并规范化后存到服务器本地)。
+- **搜索引擎可切换 + 联想下拉**:后台勾选喜欢的搜索引擎即可显示在顶部;输入时下拉联想词由服务端代理(规避跨域)。后台的「显示/隐藏」按钮点一下**原地生效、不跳页**,且无 JS 时也能正常提交。
+- **添加即补全**:填网址后先访问该网址拿到标题,再按「高清优先」的顺序去网上找相关图标(`manifest` 512 → `apple-touch-icon` → `` → 第三方聚合服务),下载后统一规范化为 **128×128 PNG** 存到服务器本地。
+- **图标可自定义,且自定义后不再被覆盖**:可为任一网站上传图标或直接填图标地址;一旦自定义,该网站的图标会被标记保护,「一键全部更新」只刷新它的名称、跳过图标。
- **显示简称**:每个网站有「名称(自动)」和「简称(手动)」两个字段,页面展示你自定义的简称。
- **自定义排序**:网站 / 板块 / 搜索引擎都可上移下移排序。
-- **一键全部更新**:批量刷新所有网站的图标与名称,**不会改动你自定义的简称**。
+- **一键全部更新**:批量刷新所有网站的图标与名称,**不会改动你自定义的简称,也不会覆盖你自定义的图标**。
- **合集标签页**:把「合集」做成标签页,点标签平铺该合集下的全部链接。
+- **前后台永远一致**:所有动态页面都发 `Cache-Control: no-store, no-cache`,静态资源走「长缓存 + 版本号」(文件名不变、URL 带 `?v=mtime-size`)。
## 页面结构(复刻 n.yangyq.net 风格)
@@ -26,15 +28,17 @@ SimpleNav/
├─ index.php 前台首页
├─ suggest.php 搜索联想代理(多引擎,服务端请求)
├─ login.php / logout.php 管理员登录 / 首次初始化
-├─ db.php 数据库初始化(建表 + 默认数据)
+├─ db.php 数据库初始化(建表 + 默认数据 + 幂等列迁移)
├─ config.php 基础配置
-├─ functions.php 公共函数(抓取元信息、下载图标等)
+├─ functions.php 公共函数(抓取元信息、下载图标、资源版本号、不缓存响应头)
+├─ .htaccess 根目录安全规则(禁止访问 data/ 与 .git/)
├─ admin/ 后台(网站 / 板块 / 搜索引擎 / 设置)
│ ├─ index.php 后台页面
-│ ├─ actions.php 增删改 / 排序处理
+│ ├─ actions.php 增删改 / 排序处理(支持 AJAX 原地切换)
│ ├─ fetch_meta.php 添加网站时自动抓取名称与图标
│ └─ update_all.php 一键“全部更新”(分批)
-├─ assets/ CSS / JS / 图标
+├─ assets/ CSS / JS / 图标 / logo
+│ └─ .htaccess 静态资源长缓存(配合 ?v= 版本号)
├─ uploads/icons/ 抓取到的网站图标(需可写)
└─ data/ SQLite 数据库(需可写,禁止 Web 访问)
```
@@ -43,10 +47,16 @@ SimpleNav/
1. 上传全部文件到站点目录(如 `/www/wwwroot/n.yangyq.net/simplenav`)。
2. 确保 web 用户对 `data/` 与 `uploads/icons/` 有写权限。
-3. 浏览器打开站点 → 首次访问进入「初始化管理员」,创建账号后即可在后台管理。
-4. 建议在 nginx server{} 中加入 `deploy/nginx-simplenav-deny-data.conf` 里的规则(禁止访问 `data/`)。
+3. 服务器需开启 PHP 的 **GD 扩展**(图标规范化要用)与 `curl`。
+4. 浏览器打开站点 → 首次访问进入「初始化管理员」,创建账号后即可在后台管理。
+5. 若服务器是 **Apache**(宝塔默认可能装 Apache 或 Nginx),`data/` 的访问拦截由仓库自带的
+ `data/.htaccess` + 根目录 `.htaccess` 完成,无需改 vhost;若是 Nginx,请把
+ `nginx-simplenav-deny-data.conf`(见本机 `_tooling/simplenav-deploy/`)里的规则加进 `server{}`。
-服务器上创建最小权限部署账号:以 root 运行 `deploy/setup-simplenav-user.sh`。
+服务器上创建最小权限部署账号:以 root 运行 `setup-simplenav-user.sh`(同样在 `_tooling/simplenav-deploy/`)。
+
+> 需要额外说明的是:**服务器上若装了宝塔「网站加速」之类的页面缓存插件,本站也不需要为它做任何特殊配置**。
+> 动态页发的 `Cache-Control: ... no-cache ...` 会被这类插件视为「不缓存」而直接跳过写入。
## 搜索引擎联想接口说明
diff --git a/admin/_auth.php b/admin/_auth.php
index 20c788e..ae66b94 100644
--- a/admin/_auth.php
+++ b/admin/_auth.php
@@ -70,8 +70,10 @@ function admin_layout(string $active, string $title, string $body): void
= e($title) ?> · = e(site_name()) ?> 后台
-
-
+
+
+
+
@@ -87,7 +89,7 @@ function admin_layout(string $active, string $title, string $body): void
= $body ?>
-
+