docs: 补充「升级后部分页面配色不生效」排查记录

根因为「页面静态缓存」插件只随文章变更刷新缓存，主题升级/设置变更
不会失效，旧 HTML 停留在 v1.1.x（无 data-palette、旧 CSS）。
FAQ 新增专项条目与清缓存步骤；README 安装节加指引；changelog 补记。

docs/changelog.md

@@ -18,6 +18,21 @@
 
 - 🧰 新增构建脚本：`pnpm snapshot`（历史资源快照）、`pnpm package`（打安装包）、`pnpm smoke`（点击特效冒烟测试）
 
+### 补充排查记录：升级后部分页面配色/新样式不生效
+
+上线后收到反馈：更换主题配色后，**首页与瞬间页不跟随**，其他页面正常。经排查
+（对比浏览器实际加载的资源、CDP 读取计算样式、比对响应头）确认：
+
+- 浏览器拿到的首页/瞬间 HTML 是 **v1.1.11 / v1.1.12 时期**的旧页面（引用旧哈希 CSS、
+  `<html>` 上没有 v1.2.0 新增的 `data-palette` 属性）
+- 响应头 `X-Halo-Cache-At` 与 `Cache-Control: max-age=3, s-maxage=120` 表明这些页面
+  被 **「页面静态缓存」插件** 缓存，而该插件只随文章变更自动刷新，
+  **主题升级 / 主题设置变更不会刷新缓存**
+- 裸 `curl`（无浏览器请求头）会绕过该缓存拿到新 HTML，因此服务端"看起来"一切正常
+
+这是缓存层行为、不是主题缺陷，**在 Halo 后台点一次「刷新页面缓存」即可**；
+排查步骤已写入 [FAQ](faq.md#升级主题或修改配色后部分页面的新样式配色不生效)。
+
 ## v1.2.0
 
 ### 主题配色系统