docs(handoff): add delivery checklist for current round

docs/2026-04-17-本轮交付清单.md

@@ -0,0 +1,166 @@
+# 2026-04-17 本轮交付清单
+
+这份文档用于给本轮工作做最终交班。
+
+适用场景：
+
+1. 准备暂停这一轮，想留下一个最明确的交付记录
+2. 新的 Codex / 新同事 / 新机器接手时，先看“这轮到底做完了什么”
+3. 需要快速核对哪些文件已经整理、哪些结论已经坐实
+
+## 1. 本轮已经交付的内容
+
+### A. 前端 nginx 正式模板与目录整理
+
+已完成：
+
+1. 明确正式发布入口：
+   - [/www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-最终发布版.txt](/www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-最终发布版.txt)
+2. 给旧模板补充版本提示，降低拿错版本概率
+3. 新增服务器目录说明：
+   - [/www/wwwroot/diff-maccms/前端站群服务器nginx配置/README.md](/www/wwwroot/diff-maccms/前端站群服务器nginx配置/README.md)
+
+### B. 搜索页动态缓存规则固化
+
+已完成：
+
+1. 搜索页双入口规则确认：
+   - `/get-index`
+   - `/get/index`
+2. 正式模板中已同时兼容这两个入口
+3. `?__nocache=1` 已固定为人工排障标准入口
+
+### C. SEONexus 仓库文档体系补齐
+
+已完成并推送：
+
+1. 一页总结：
+   - [2026-04-17-当前阶段总结.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-当前阶段总结.md)
+2. 运维短摘要：
+   - [2026-04-17-spider-nginx-运维摘要.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md)
+3. 长交接文档：
+   - [1270-SEONexus-Codex多版本协作交接总文档.md](/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md)
+4. nginx 目录说明：
+   - [前端站群nginx配置目录说明.md](/www/wwwroot/diff-maccms/SEONexus/docs/前端站群nginx配置目录说明.md)
+5. docs 索引：
+   - [README.md](/www/wwwroot/diff-maccms/SEONexus/docs/README.md)
+
+### D. 受管蜘蛛映射口径修正
+
+已完成：
+
+1. 明确 `managed_spiders.map.conf.example` 与
+   `受管蜘蛛映射-最优方案.txt`
+   更偏“样例 / 推荐结构”
+2. 不再把样例文件直接等同于线上实时状态
+3. 当前判断优先级固定为：
+   - 先看 `X-Managed-Spider`
+   - 再看线上真实 `managed_spiders.map.conf`
+   - 最后才参考样例文件
+
+## 2. 本轮已经坐实的关键结论
+
+### 结论 1：前端 nginx 长期规则已经定型
+
+当前正式规则：
+
+1. 搜索页：
+   - `/get-index`
+   - `/get/index`
+   - cache key 带 `$args`
+2. 详情页 / 播放页 / 分类页 / 榜单页：
+   - cache key 不带 `$args`
+3. 所有动态页：
+   - 支持 `?__nocache=1`
+4. 排障先看：
+   - `X-Cache-Status`
+   - `X-Cache-Mode`
+   - `X-Managed-Spider`
+
+### 结论 2：搜索页双入口兼容是必要项
+
+已明确识别到：
+
+1. `www.jpjdxs.com => /get-index`
+2. `www.jingxifa.com => /get-index`
+3. `www.hyjssb.com => /get/index`
+
+因此：
+
+1. 双兼容不是冗余
+2. 是站群真实路由差异决定的必要规则
+
+### 结论 3：`sogou` 恢复已不是单窗偶发
+
+已确认：
+
+1. `17:30` 窗口：
+   - `10` 个请求里 `9` 个 `200`
+2. `17:40` 窗口：
+   - `5` 个请求全部 `200`
+3. 命中路径已覆盖：
+   - 首页
+   - 分类
+   - 详情
+   - 播放
+   - 搜索探测路径
+
+因此：
+
+1. `sogou` 已进入恢复初期
+2. 而且已经是连续窗口成立，不是单窗偶发
+
+### 结论 4：`bytespider` 当前还没有深页恢复样本
+
+已确认：
+
+1. 当天聚合里大部分还是 `robots`
+2. 有少量 `robots.txt` 与个别首页 `200`
+3. 没扫到稳定的详情 / 播放 / 分类 `200` 样本
+4. 实时响应头里仍是：
+   - `X-Managed-Spider: normal`
+
+因此：
+
+1. `bytespider` 目前属于“部分可通”
+2. 但尚未进入深页恢复阶段
+
+### 结论 5：最新 spider summary 的读取口径已经变化
+
+当前 summary 更应优先看：
+
+1. `bot_buckets`
+2. `summary_status_buckets`
+3. `summary_records`
+
+不要再只按旧字段：
+
+1. `by_bot`
+
+去判断有没有样本。
+
+## 3. 本轮最直接可用的入口
+
+如果只想最快进入状态，建议按这个顺序：
+
+1. 看一页总结：
+   - [2026-04-17-当前阶段总结.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-当前阶段总结.md)
+2. 看短摘要：
+   - [2026-04-17-spider-nginx-运维摘要.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md)
+3. 真要复制上线模板：
+   - [/www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-最终发布版.txt](/www/wwwroot/diff-maccms/前端站群服务器nginx配置/站点伪静态-最终发布版.txt)
+
+## 4. 如果下一轮继续，最自然的方向
+
+当前最自然的后续方向只剩两个：
+
+1. 继续追下一批 run
+   - 看 `sogou` 恢复是否持续
+   - 看 `bytespider` 是否开始出现深页样本
+2. 暂停这里
+   - 把本轮视为完整阶段收口
+   - 等新一批 run 再继续跟进
+
+## 5. 当前阶段一句话交班
+
+这轮已经把“前端 nginx 最终规则、搜索页双入口兼容、受管蜘蛛口径、`sogou` 连续恢复、`bytespider` 当前阶段、summary 字段变化”全部整理成可直接接手的状态，后续可以放心按新窗口继续增量判断。

docs/README.md

@@ -18,7 +18,19 @@
 2. 想用最短材料完成交接
 3. 想先看结论，再决定要不要展开看长文档
 
-### 2. 当前蜘蛛 / nginx 短摘要
+### 2. 本轮交付清单
+
+如果你更关心“这轮到底已经交付了哪些东西”，直接看：
+
+- [2026-04-17-本轮交付清单.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-本轮交付清单.md)
+
+适用场景：
+
+1. 准备停在这一轮，想做最终交班
+2. 想快速核对哪些文件、哪些结论已经落地
+3. 想直接把这轮成果转交给别人
+
+### 3. 当前蜘蛛 / nginx 短摘要
 
 先看：
 
@@ -31,7 +43,7 @@
 3. 想知道哪些站已经验证通过
 4. 想避免把旧日志误判成当前问题
 
-### 3. 当前总交接文档
+### 4. 当前总交接文档
 
 再看：
 
@@ -44,7 +56,7 @@
 3. 需要多人 / 多 Codex 协作边界
 4. 需要正式服接手时的详细步骤
 
-### 4. 新会话接手检查清单
+### 5. 新会话接手检查清单
 
 如果是新的 Codex 会话、人工值班、跨机器继续跟进，建议再配合使用：
 
@@ -56,7 +68,7 @@
 2. 多人 / 多 Codex 协作时避免漏项
 3. 用最短格式记录“当前结论、当前证据、下一步”
 
-### 5. 新 Codex 启动提示词模板
+### 6. 新 Codex 启动提示词模板
 
 如果你准备新开一个 Codex 会话，建议直接复制使用：
 
@@ -70,7 +82,7 @@
 
 模板里已经区分了不同用途，不用每次重新组织开场描述。
 
-### 6. 前端 Nginx 切换后复测模板
+### 7. 前端 Nginx 切换后复测模板
 
 如果某台机器刚切换前端站点伪静态，建议直接使用：
 
@@ -82,7 +94,7 @@
 2. 清缓存后的复测记录
 3. 需要快速判断“是已生效，还是只是看起来像生效”
 
-### 7. 前端站群 Nginx 配置目录说明
+### 8. 前端站群 Nginx 配置目录说明
 
 如果你需要从服务器目录里直接拿模板，或者要判断“到底该复制哪份伪静态”，建议看：
 
@@ -96,7 +108,7 @@
 
 ## 历史 / 专项文档
 
-### 8. 老模板回灌执行文档
+### 9. 老模板回灌执行文档
 
 - [1269-SEONexus-老模板第一阶段回灌执行文档.md](/www/wwwroot/diff-maccms/SEONexus/docs/1269-SEONexus-老模板第一阶段回灌执行文档.md)
 
@@ -106,7 +118,7 @@
 2. 对照历史回灌动作
 3. 排查旧版本与新版本差异
 
-### 9. Admin2 Spider Workbench 生产排障记录
+### 10. Admin2 Spider Workbench 生产排障记录
 
 - [2026-04-16-admin2-spider-workbench-production-fix.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-16-admin2-spider-workbench-production-fix.md)