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

根因为「页面静态缓存」插件只随文章变更刷新缓存，主题升级/设置变更不会失效，旧 HTML 停留在 v1.1.x（无 data-palette、旧 CSS）。 FAQ 新增专项条目与清缓存步骤；README 安装节加指引；changelog 补记。
2026-09-27 17:49:34 +08:00
parent 125d0592c9
commit c1b08ad915
3 changed files with 47 additions and 0 deletions
@@ -101,6 +101,10 @@
 > 它引用的 CSS 文件名带内容哈希，升级后已被删除，请求会直接 500。
 > 先在 Halo 后台执行一次「清理缓存」（并刷新 CDN / Nginx 缓存）即可。
 > 主题从 v1.2.1 起会把历史版本的哈希资源一并发进安装包，旧 HTML 也不会请求失败。
+>
+> **升级主题或修改配色后，部分页面不生效**：如果安装了「页面静态缓存」插件，
+> 它只随文章变更自动刷新，主题层的变更需要手动点一次「刷新页面缓存」，
+> 详见 [FAQ：升级主题或修改配色后部分页面不生效](docs/faq.md#升级主题或修改配色后部分页面的新样式配色不生效)。

 或从源码构建：