OpenFlare/docs/plan/20260718-edge-cache-static-default.md

边缘缓存默认 static 策略 — 实现计划

对应设计：edge-cache-design.md

目标

路由开启缓存后，新建推荐仅缓存标准静态扩展名（static）；存量 url/空策略映射为 all，不收窄缓存范围。

兼容规则（评审后定稿）

场景	行为
已启用 + '' / url	读 API / 快照 / 渲染 → all
写入时 enabled 且 policy 为空	规范为 all（旧客户端兼容）
UI 新建/推荐默认	显式提交 static
关闭缓存	policy 存 ''，rules 清空

修改清单

1. 渲染 pkg/render/openresty/render.go：static 内置扩展名；空/url/all 无路径限制
2. 校验/展示 proxy_route/helpers.go：normalizeCachePolicy + displayCachePolicy
3. 快照 config_version/logics.go：normalizeSnapshotCachePolicy
4. 前端 cache-section.tsx + helpers：存量 empty/url→all；关闭时提交 ''；新建默认 static
5. 测试 render + proxy_route
6. 设计/changelog 同步兼容说明

验证

go test ./pkg/render/openresty/ ./internal/apps/openflare/proxy_route/ ./internal/apps/openflare/config_version/
# 已通过（2026-07-18）

状态

• 功能实现 + 评审修复（empty→all，禁止静默收窄）
• 提交 fix(cache): ...（待用户确认）
• 合并 / 发布后需重新发布节点配置