fix: 修复升级后整站无样式与点击特效失效

- 旧哈希静态资源随版本升级被删除，被缓存的 HTML 仍请求旧文件名导致
  FileNotFoundException 500，补 compat/assets 历史资源并在构建时合并
- postbuild 增加静态资源引用校验，缺失即构建失败
- ClickEffect 改为常驻配置节点 + data 属性驱动，避免配置未落库时静默失效；
  强制回流修正 transition 不触发；特效层挂到 body 下避免被导航栏遮挡
- 新增 scripts: postbuild/snapshot-assets/package/smoke-clickfx
- 版本 1.2.1

docs/faq.md

@@ -6,7 +6,7 @@
 
 检查以下几点：
 
-1. 确认 Halo 版本 >= 2.24.0
+1. 确认 Halo 版本 >= 2.26.0
 2. 确认主题已启用
 3. 清除浏览器缓存后重试（Ctrl+Shift+R 强制刷新）
 4. 检查 Halo 后台日志是否有报错
@@ -26,8 +26,32 @@ docker cp templates/ halo:/root/.halo2/themes/warm-island/
 docker restart halo
 ```
 
+### 升级主题后整站都没有样式？
+
+主题的 CSS / JS 文件名带内容哈希，每次构建都会变化。如果 Halo 页面缓存或前置反向代理
+（OpenResty、CDN 等）里还留着上一版本的 HTML，它请求的仍是已被删除的旧文件名，
+Halo 找不到文件时会返回 **500**（日志里能看到 `FileNotFoundException: .../templates/assets/Layout.xxxx.css`），
+于是样式全部失效。
+
+依次处理：
+
+1. Halo 后台执行一次「清理缓存」（设置 → 缓存，或直接重启 Halo / 容器）
+2. 刷新 CDN、反向代理缓存
+3. 浏览器强制刷新（Ctrl+Shift+R）
+
+v1.2.1 起安装包会保留各版本的哈希资源（v1.1.7 之后全部覆盖），
+即使缓存里的旧 HTML 被再次请求也不会 500，但最终仍建议清一次缓存以使用最新样式。
+
 ## 功能相关
 
+### 鼠标点击效果 / 拖尾效果开启了却没反应？
+
+1. 确认「总体样式 → 鼠标点击效果」开关已开启并点击了保存
+2. 确认「点击效果类型」没有选择「关闭」（选了关闭时即使开启开关也不会有任何特效）
+3. 清除浏览器缓存后重试；老版本的浏览器请更新到较新的 Chrome / Edge / Firefox / Safari
+
+若仍无效，打开浏览器控制台（F12）检查是否有 JS 报错 —— 第三方脚本报错会中断后续脚本执行。
+
 ### 搜索按钮不显示？
 
 搜索功能依赖 Halo 搜索插件：