mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-09-29 22:06:38 +08:00
ryan
204f6d9a8b
评审修复：enabled 且 policy 为空或 url 时，写入/展示/快照/渲染均映射为 all， 保证旧站点宽缓存范围不变；新建 UI 仍显式提交 static 作为推荐默认。
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# 边缘缓存默认 static 策略 — 实现计划
|
||
|
||
对应设计：[edge-cache-design.md](../design/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** 同步兼容说明
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
go test ./pkg/render/openresty/ ./internal/apps/openflare/proxy_route/ ./internal/apps/openflare/config_version/
|
||
# 已通过（2026-07-18）
|
||
```
|
||
|
||
## 状态
|
||
|
||
- [x] 功能实现 + 评审修复（empty→all，禁止静默收窄）
|
||
- [ ] 提交 `fix(cache): ...`（待用户确认）
|
||
- [ ] 合并 / 发布后需重新发布节点配置
|