perf(cache): 边缘缓存对齐 Cloudflare 默认模型

docs/guide/proxy-config.md

@@ -84,3 +84,34 @@
 2. 在历史列表中找到发布前的上一个稳定版本。
 3. 点击 **「激活此版本」**。
 4. 所有在线 Agent 节点将在秒级自动重载回历史配置，实现秒级避险。
+
+---
+
+## 边缘缓存（可选）
+
+站点详情 **「缓存」** 页可开启边缘 `proxy_cache`（须同时开启 **性能设置 → 全局 OpenResty 缓存**）。行为对标 Cloudflare 默认模型，详见 [边缘缓存策略设计](../design/edge-cache-design.md)。
+
+### 推荐设置
+
+| 项 | 建议 |
+| --- | --- |
+| 策略 | **标准静态资源**（默认推荐）：仅 css/js/map/图片/字体等，**不含 HTML/JSON** |
+| 登录 Cookie | **不会**单独跳过缓存；带会话的用户仍可命中静态资源 |
+| 源站 | 静态资源建议 `Cache-Control: public, max-age=…`；动态/个性化必须 `private` 或 `no-store` |
+| 响应 Set-Cookie | 不会写入边缘缓存 |
+| 无源站缓存头 | 按状态码使用默认 Edge TTL（如 200 约 120 分钟） |
+
+### 高级策略「所有可缓存 GET」
+
+类似 Cloudflare Cache Everything：路径不再限制扩展名。若源站对 HTML 未声明 `private`/`no-store`，**可能把个性化页面缓存并串用户**。仅在源站缓存头正确、或内容全局一致时使用。
+
+### 生效方式
+
+缓存开关与策略写在配置快照中。保存站点后须 **发布并激活配置版本**，Agent 应用后才生效。仅改 UI 不发布则节点仍用旧规则。
+
+### 快速自检
+
+1. 全局缓存已开，站点缓存已开，策略为「标准静态资源」。  
+2. 发布配置并确认节点应用成功。  
+3. 带登录 Cookie 连续两次请求同一 `/assets/app.js`（或带 hash 的 immutable 路径），访问日志中 `cache_status` 第二次应为 **HIT**（或 UI「命中」）。  
+4. 若仍为「未缓存」：确认策略是否匹配该路径扩展名、是否非 GET、源站是否返回 `Set-Cookie` / `private`，以及节点是否已应用新版本。更多见 [故障排查 · 边缘缓存](./troubleshooting.md#边缘缓存命中率异常)。