From 570f36e2c2523dd9c6147c26d3d127235445091e Mon Sep 17 00:00:00 2001
From: root <root@v2202604268673447256.ultrasrv.de>
Date: Fri, 17 Apr 2026 16:07:48 +0800
Subject: [PATCH] docs(nginx): record managed cache rollout verification

---
 ...1270-SEONexus-Codex多版本协作交接总文档.md | 93 +++++++++++++------
 1 file changed, 67 insertions(+), 26 deletions(-)

diff --git a/docs/1270-SEONexus-Codex多版本协作交接总文档.md b/docs/1270-SEONexus-Codex多版本协作交接总文档.md
index 2a565e8..b779083 100644
--- a/docs/1270-SEONexus-Codex多版本协作交接总文档.md
+++ b/docs/1270-SEONexus-Codex多版本协作交接总文档.md
@@ -3694,6 +3694,17 @@ php code/scripts/seo_copy_front_verify.php chuanjiafeng.net category_list dian-y
    - 详情页前台已出现：
      - `先核对资料`
    - 说明详情页方向已对，文案修复至少已在详情页落地
+4. `jpjdxs.com`
+   - 详情页：`/neirong-76342-se-jiang-zhi-xue-mei-gui`
+   - 播放页：`/bf-76342-se-jiang-zhi-xue-mei-gui/default-1`
+   - 2026-04-17 在前端清缓存后再次复测，详情页正文已出现：
+     - `本页为色降2之血玫瑰的详情资料页...`
+     - `如果你已确认片名与资料信息...`
+     - `先核对资料`
+   - 播放页仍正常输出：
+     - `当前为色降2之血玫瑰播放页...`
+     - `播放前建议...`
+   - 说明这站最终不是代码回退，而是前端整页缓存顶住旧 HTML，清缓存后已恢复
 
 #### B 类：代码逻辑大概率已生效，但前台可能仍受缓存影响
 
@@ -3705,35 +3716,16 @@ php code/scripts/seo_copy_front_verify.php chuanjiafeng.net category_list dian-y
 
 已确认样本：
 
-1. `jpjdxs.com`
-   - 详情页：`/neirong-76342-se-jiang-zhi-xue-mei-gui`
-   - 播放页：`/bf-76342-se-jiang-zhi-xue-mei-gui/default-1`
-   - 当前现象：
-     - 播放页前台已出现：
-       - `当前为色降2之血玫瑰播放页`
-       - `如果你已在详情页确认...`
-       - `播放前建议...`
-       - `先看线路`
-     - 同站详情页当前仍显示旧通用句式
-   - 2026-04-17 进一步实锤：
-     - 本机直接跑 `VideoService::getSeoCopyBlock('detail')`，返回的是新文案：
-       - `本页为色降2之血玫瑰的详情资料页，可先核对年份 1992...`
-       - `如果你已确认片名与资料信息，可直接从本页跳转到播放页...`
-       - `先核对资料`
-     - 真实线上详情页响应头是：
-       - `x-cache-status: HIT`
-     - 真实线上播放页响应头是：
-       - `x-cache-status: MISS`
-     - 真实线上详情页正文仍命中旧句式：
-       - `本页围绕《色降2之血玫瑰》整理剧情简介、题材信息与播放线索...`
-     - 这说明不是代码没恢复，而是详情页前端缓存还顶着旧 HTML，播放页已经先刷新到新 HTML
+1. 当前暂无新的稳定 B 类样本。
+   - `jpjdxs.com` 原先属于这一类
+   - 但 2026-04-17 在前端清缓存并切换新版 nginx 动态页缓存策略后，已转入 A 类
+   - 这次案例可作为“代码没问题，只是前端缓存顶着旧 HTML”的标准样本
 
 当前更合理的判断是：
 
-1. 代码兼容层已经生效
-2. 播放页缓存先刷新
-3. 详情页可能还被页面缓存 / 反向代理缓存顶住
-4. 当前前端 nginx 动态页缓存 key 只含 `$scheme$request_method$host$uri`，不含 query string，所以加 `?_t=`、`?v=` 这种参数不能绕过旧缓存
+1. 若再次出现 B 类问题，优先先看前端整页缓存
+2. 老配置里动态页 cache key 若只按 path 或只按 URI，极容易把旧 HTML 顶很久
+3. 加 query 参数不一定能绕过缓存，要结合当前 nginx 的 `proxy_cache_key` 判断
 
 #### C 类：本地文案完整，但线上细页路径/部署仍需单独确认
 
@@ -3773,6 +3765,55 @@ php code/scripts/seo_copy_front_verify.php chuanjiafeng.net category_list dian-y
 2. 再对 B 类站点重点清缓存、复测详情页
 3. 对 C 类站点先排真实路由 / nginx / 回源，不要急着重写 seo_copy 数据
 
+### 5.4 2026-04-17 前端 nginx 动态页安全缓存方案已验证生效
+
+这轮已经把前端 nginx 新规则真实上线验证通过，当前建议作为长期标准方案使用。
+
+#### 当前建议规则
+
+1. 搜索页 `/get-index`
+   - `cache key` 带 `$args`
+2. 详情页 / 播放页 / 分类页 / 榜单页
+   - `cache key` 不带 `$args`
+3. 所有动态页支持 `?__nocache=1`
+   - 仅用于人工排障
+4. 所有动态页返回调试响应头
+   - `X-Cache-Status`
+   - `X-Cache-Mode`
+   - `X-Cache-Bypass`
+5. 受管蜘蛛版继续保留
+   - `X-Managed-Spider`
+
+#### 线上已验证现象
+
+以 `jpjdxs.com` 为样本，2026-04-17 再次验证：
+
+1. 详情页普通访问：
+   - `X-Cache-Status: STALE`
+   - `X-Cache-Mode: path-only`
+   - `X-Cache-Bypass: 0`
+   - `X-Managed-Spider: normal`
+2. 搜索页：
+   - `X-Cache-Status: MISS`
+   - `X-Cache-Mode: with-args`
+3. 详情页加 `?__nocache=1`：
+   - `X-Cache-Status: BYPASS`
+   - `X-Cache-Mode: bypass`
+   - `X-Cache-Bypass: 1`
+
+#### 对后续 Codex 的直接结论
+
+1. 如果前端响应头里已经有：
+   - `X-Cache-Mode`
+   - `X-Cache-Bypass`
+   - `X-Managed-Spider`
+   说明新版伪静态已经生效
+2. 如果页面内容看起来像旧版，但 `?__nocache=1` 正常
+   - 优先判断为前端缓存问题
+   - 不要先判断成 git 覆盖或后端模板回退
+3. 当前最优模板文件是：
+   - `前端站群服务器nginx配置/站点伪静态-受管蜘蛛放行版-动态页安全缓存.txt`
+
 ### 6. 对后续 Codex 的明确提醒
 
 后面如果再看到：