docs: 核查并润色文档,对齐项目实际实现

- 删除未经验证的环境要求(Docker 版本号、浏览器条目)与括号废话
- 故障排查改为真实处理路径(升级→重新发布→强制同步→重建 Agent→提交 issue),删除仅开发时用的排障章节
- 删除设计文档中的测试与验收、实现检查清单、贡献者阅读建议等开发内容
- 修正与代码不符的事实:reset-passwd 命令名、证书续签窗口 7 天、Pages 检查间隔 1440 分钟、Relay vhost 端口 8080、SSO 仅支持 OIDC 等
- 去除口语化表述与无意义括号,改写「不是…而是…」句式
- 同步修正文档站链接锚点,构建验证通过
This commit is contained in:
ryan
2026-08-16 17:49:57 +08:00
parent 4e3d79c001
commit 600a7acdfb
37 changed files with 275 additions and 517 deletions
+2 -28
View File
@@ -204,7 +204,6 @@ access.log cache_status=$upstream_cache_status
| 模型/默认 | 创建路由默认 `cache_policy=static`;读写时 `url`→`all` |
| 快照 | `config_version` 快照规范化 |
| UI | `proxy-routes/detail/components/cache-section.tsx` |
| 测试 | `pkg/render/openresty/render_test.go` 等 |
---
@@ -235,21 +234,7 @@ access.log cache_status=$upstream_cache_status
---
## 7. 验证要点
* 渲染:无 Cookie/Auth/请求 Cache-Control 旁路;含 `proxy_cache_valid` 三行;`proxy_no_cache` 含 `$upstream_http_set_cookie`。
* 单测:内置表含 `css`/`js`/`map`/`mjs`,**不含** `html`/`json`。
* 手动:
* 带 session Cookie 请求 `/a.js` → 第二次 `HIT`;
* `/index.html` + `static` → 未缓存;
* 源站对 eligible 路径返回 `Set-Cookie` → 不入库(持续 MISS/不 HIT);
* 源站 `Cache-Control: private` → 不入库。
* 观测:access log 三态与原始 `cache_status` 一致。
* 生效:配置版本发布并节点应用后验证。
---
## 8. 决策矩阵(防漏判)
## 7. 决策矩阵(防漏判)
| 场景 | CF | OpenFlare(本设计) |
| --- | --- | --- |
@@ -264,18 +249,7 @@ access.log cache_status=$upstream_cache_status
---
## 9. 后续路线图
1. Auth 完整 RFC/CF 条件缓存(Lua)
2. 强制 Edge TTL / `proxy_ignore_headers`(Cache Rules 级)
3. Purge API
4. Cache Rules(有序规则 + 动作)
5. 全局默认可缓存扩展名可配置;可选对齐 CF 更长扩展名表
6. HEAD→GET
---
## 10. 决策记录
## 8. 决策记录
| 决策 | 选择 | 原因 |
| --- | --- | --- |