# 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 字段变化”全部整理成可直接接手的状态，后续可以放心按新窗口继续增量判断。