diff --git a/docs/2026-04-17-本轮交付清单.md b/docs/2026-04-17-本轮交付清单.md new file mode 100644 index 0000000..f20a1fa --- /dev/null +++ b/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 字段变化”全部整理成可直接接手的状态，后续可以放心按新窗口继续增量判断。 diff --git a/docs/README.md b/docs/README.md index 79433ff..d1a2600 100644 --- a/docs/README.md +++ b/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)