一、它能帮你做什么WHY
两类手段：插件层（装好就生效）+ 服务器层（本页给出检测与配置片段）。
| 能力 | 开关状态 | 做了什么 / 预期收益 |
|---|---|---|
| 页面缓存 | 默认已开启 | 整页 HTML 缓存体，命中后不再跑重、不再渲染模板，首屏 TT8 与服务器负载改善最明显，是性价比最高的一项 |
| 图片优化 | 默认已开启 | ① 统一补懒加载（搜索页自动跳过）② 列表页缩略图化，不用加载原图 ③ WebP 输出（体积再降 25%~70%）④ 补 width/height 减少布局抖动 |
| 输出压缩 | 默认关 | 去掉 HTML 注释与标签间空白，体积小幅下降。有小概率脚本异常，建议不开 |
| 服务器配置 | 视环境而定 | gzip / brotli 压缩、HTTP/2、CDN 边缘缓存、OPcache —— 只能在 Nginx / Apache 上配置，本页给体检结果与配置片段 |
与其它插件互不干扰：缓存的是模板渲染结果（HTML 字符串），命中后 response_send 上的处理仍然会跑 —— JSON-LD 结构化数据、站长验证 meta、AI 爬虫抓取统计都不失效。这是它与「Nginx 直接吐静态文件」最大的区别。
二、三分钟上手QUICK START
1. 打开「加速优化」
后台 → 扩展管理 → 加速优化（内容管理里也散布着各快捷入口：清缓存 / 体检 / 命中统计等）。
2. 看自检清单
「加速总览」的自检逐项打勾：插件文件完整性、缓存接入、缓存目录可写、GD / WebP 支持等。
3. 跑一遍「服务器配置」体检
看服务器层还差什么（OPcache / 文本压缩 / HTTP2 / 静态缓存头），能改的按片段抄。
4. 改内容后
什么都不用做——发布 / 更新 / 删除文章会自动失效相关缓存；也可以手动「清空页面缓存」。
跟 AI 助手下指令时，可以直接说：
把加速优化打开：页面缓存保持 600 秒，图片优化全开（缩略图 + WebP + 首屏 preload），完事跑一次自检和服务器体检给我看结果。
三、五个页签怎么用TOUR
3.1 加速总览 —— 状态、收益与自检
- 加速状态与收益：页面缓存开关 / 有效期 / 版本、缓存命中率（命中 0 次说明刚清空或刚开启）、缓存范围（首页 / 列表 / 详情 / 标签 / 其它，搜索页与表单页已强制排除）、缓存目录可写性；
- 自检：插件状态、文件完整性、fetch 接入点、后台菜单、附件表字段、GD 图像库、WebP 支持、懒加载等逐项 ✓；
- 一键动作：重新体检 / 清空页面缓存。
3.2 页面缓存 —— 缓什么、什么时不缓
- 缓存的是什么：模板渲染结果（HTML 字符串），插件层处理照常生效；
- 什么时候自动失效：发布 / 更新 / 删除文章、改栏目、改配置时随框架清理一起失效；保存设置立即清空；到期（默认 600 秒）自动过期；
- 为什么搜索页 / 表单页不能缓存：搜索结果因人而异；表单页有 CSRF 令牌，缓存会令提交失败——这两类已强制排除；
- PC / 手机版不会串：缓存键带设备标识，各存各的；
- 额外排除规则：一行一个关键字匹配请求地址，如
keyword=、?from=； - 排查用：地址后加
?nocache=1即看实时页面。
3.3 图片优化 —— 缩略图 / WebP / 首屏 preload
- 列表图缩略图化：默认「只处理已标记懒加载的图」最安全；缩略图默认 800×600，按需生成、不影响原图；
- WebP 输出：支持的浏览器自动用 WebP（体积再降 25%~70%），不支持的回落原图；可设质量（默认 82）与排除清单（logo、水印图、整个目录等）；
- 首屏图 preload（推荐开）：head 里提前声明首屏大图，LCP 明显变快；模板已自行 preload 的自动跳过；
- 背景图也走 WebP：banner 多是 background:url，开启后同样转 WebP；
- 轮播图延迟加载：第 2 张起等主体渲染完再下载，把首屏带宽留给第一张；禁用 JS 的访客也能看到全部幻灯片（内置兜底）；
- 响应式图片 srcset：手机下给小图，进一步省流量。
3.4 输出与记录 —— 压缩与命中统计
HTML 压缩若页面上有依赖注释的脚本或内联代码，压缩后可能异常——建议保持关闭；开启后逐页检查，有问题立即关。
3.5 服务器配置 —— 插件管不到的那一半
四、服务器层还能做什么SERVER
| 项目 | 解决什么 | 在哪配 |
|---|---|---|
| 文本压缩 gzip / brotli | 文本体积再降 60%~80%，服务器层收益最大、风险最低 | Apache：.htaccess；Nginx：server 块 |
| 静态资源缓存头 Expires / Cache-Control | 图片 / 字体 / CSS / JS 设长缓存，重复访客几乎不再下载 | 同上 |
| HTTP/2 | 同域名资源并行传输，首屏明显提前 | 只能改服务器主配置 |
| OPcache | PHP 执行开销降 20%~40% | php.ini：opcache.enable=1 |
| CDN | 静态资源就近分发 + 边缘缓存 + 抗攻击 | 改 DNS（国内需备案） |
本页检测面板会告诉你「现在是怎样、还差什么」，并附 Apache / Nginx 配置片段，可直接复制到 public/.htaccess 末尾或 server 块。
五、常见问题 FAQFAQ
1. 改了设置 / 发了文章，前台没变化？
基本是缓存在起作用：发布 / 更新会自动失效缓存；配置类改动可手动「清空页面缓存」，或地址后加
?nocache=1 验证实时页面。2. WebP 转换没有发生？
检查三点：① 服务器 GD 是否支持 WebP（总览自检会显示）；② 是否命中了「不转 WebP 的图片」排除清单；③ 浏览器是否支持 WebP（不支持会自动回落原图，属正常）。
3. 表单提交失败和缓存有关吗？
插件已强制排除表单页（CSRF 令牌原因）。若你把表单地址写进了「缓存范围」其它页里，请关掉——搜索页与表单页永远不该缓存。
4. 命中率一直是 0%？
刚清空缓存或刚开启时前几次必然未命中（要先写入）。正常访问几页后再看；仍为 0 则检查总开关与缓存目录可写性。
5. 换服务器 / 搬站要带哪些文件？
复制
plugins/SpeedUp/ + application/cms/model/SpeedUp.php + application/cms/admin/Speedup.php + public/static/cms/js/as-su.js，装好插件即可；页面缓存接入点在 application/cms/home/common.php 的 fetch()。六、找不到答案怎么办SUPPORT
文档没覆盖到的情况，按下面这样反馈，我们能最快定位。
- 带上「加速总览」自检清单截图（哪项 ✗ 一目了然）；
- 页面异常时说明哪个页签改了什么开关（尤其 HTML 压缩）；
- 服务器层问题附上「服务器配置」页签的检测面板截图。
小技巧：排查页面异常，先
?nocache=1 对比缓存前后的差异，基本能把问题二分定位。