SEONexus/docs/old-tmp-seo/06-主Codex可执行检查清单-2026-04-17.md

1275-SEONexus 主 Codex 可执行检查清单 - 2026-04-17

目的

这份文档用于把 1271 到 1274 的分析，压缩成主 Codex 可以直接开干的检查清单。

目标不是重复分析结论，而是明确：

1. 先看哪几个文件
2. 每个文件要判断什么
3. 哪些问题优先级最高

当前建议的排查顺序

1. 先查深页兼容入口是否仍然过宽

优先级：P0

文件：

• router.php

重点看：

• legacyCompatRoutes 里注册了多少历史 detail/play 入口
• 哪些入口现在仍然在日志里高频出现
• 哪些入口只是历史遗留，但已经几乎没有真实命中

当前直接对应的高频路径：

• /voddetail/...
• /vodplay/...
• /video-info/...
• /video-play/...
• /video-show/...
• /vodbf/...

要回答的问题：

• 这些兼容入口是否都还必须保留
• 是否存在“先接住再跳一次”的非必要链路
• 是否可以把部分兼容入口进一步统一到更少的规范路径

判断标准：

• 如果某类旧入口仍然是百度高频命中来源，就不能贸然删
• 但如果它只是为了兼容而兼容，且跳转链过长，就应优先考虑压缩

2. 再查 canonical 是否仍然和当前 family 脱节

优先级：P0

文件：

• SiteStyle.php
• SiteStyle.php
• SiteStyle.php

重点看：

• detectPageType() 目前只识别 voddetail/* 和 vodplay/*
• guessDetailUrlFromVideo() 仍硬编码回 /voddetail/...
• buildSeoMeta() 的 canonical 生成没有明显读取当前站点 family

要回答的问题：

• 当前模板 canonical 是否仍然默认指向 voddetail
• 如果某站主输出不是 voddetail，canonical 会不会和真实输出路径冲突
• play 页 canonical 回 detail 时，是否一定回到了正确 family 下的 detail URL

判断标准：

• 如果 canonical 指向的不是当前规范输出 URL，这就是高优先级修复点
• 这条线和 yagyjt.com、www.ningxiaowei.com 的深页 301 很可能直接相关

3. 再查 sitemap 是否持续硬编码 https://www.

优先级：P0

文件：

• VideoSiteMapLogic.php
• VideoSiteMapLogic.php
• SiteMapLogic.php
• SiteMapLogic.php
• SiteMapLogic.php

重点看：

• 视频 sitemap 虽然已经开始读 url_family['detail']['pattern']
• 但最终 host 仍然是 https://www. + domain
• 小说 sitemap / 分类 / 章节相关输出同样大量直接拼 https://www.

要回答的问题：

• 当前真实规范 host 到底是不是 www
• 如果不是，sitemap 是否正在持续制造 /|301 和 host 规范化跳转
• sitemap 与 canonical、站内链接是否在同一 host 口径下

判断标准：

• 只要 sitemap 输出 host 和真实规范 host 不一致，这就是首页与深页 301 的高风险来源

4. 评估 fallback 机制是在“止血”还是在“制造语义偏差”

优先级：P1

文件：

• VideoService.php
• VideoService.php
• VideoService.php

重点看：

• getVideoByVId() 查不到时会进入 resolveFallbackVideoByRequest()
• fallback 会写入 host 维度的本地绑定文件
• 可能把旧 v_id 回落到随机或排序兜底视频

要回答的问题：

• 这条链当前到底拯救了多少原本会 404 的深链
• 回落后的页面内容是否和原始 URL 语义足够接近
• 是否需要限制 fallback 的适用范围，例如只对某些入口生效

判断标准：

• 如果 fallback 只是减少硬 404，它有价值
• 但如果它让错误 deep link 长期稳定落到无关视频，这会引入新的 SEO 误导风险

5. 444 不优先在 PHP 里深挖，先确认前置层

优先级：P1

文件：

• SiteContext.php

当前已知判断：

• 应用层主动拦截主要抛的是 404
• isSpider() 已对白名单蜘蛛放行
• 当前仓库里没有明显应用层 444 返回逻辑

要回答的问题：

• 444 是否来自 nginx / waf / 路径探测拦截
• 当前 444 是否已经波及：
  • /
  • robots.txt
  • sitemap*.xml
  • detail
  • play

判断标准：

• 如果 444 只集中在 .rar/.zip/.txt/zb_system 这类路径，先视为安全噪音
• 如果开始进入首页、sitemap、深页主路径，再提升为 P0

当前最值得优先验证的 5 个判断

1. yagyjt.com 的深页 301 是否主要来自 canonical / family 不一致

因为：

• 它已经是明确深抓正样本
• 但 detail|301 / play|301 仍接近 200

2. www.ningxiaowei.com 的 video-info / video-play 是否只是兼容入口过多

因为：

• 这批路径仍然高频出现
• 很适合作为“内容层兼容是否还能继续收口”的观察站

3. sitemap 输出 host 是否和真实规范 host 一致

因为：

• 这条线会同时影响首页 /|301
• 也会影响深页入口持续规范化跳转

4. fallback 绑定文件是否正在稳定扩大“错误 deep link -> 可访问页面”的覆盖

因为：

• 这可能解释 404 的大幅下降
• 同时也可能埋下语义偏差风险

5. 444 是否已经误伤真实搜索蜘蛛主路径

因为：

• 目前看更像前置层安全噪音
• 但这个结论需要持续观察，不应直接定死

建议的执行节奏

第一轮

• 只读检查 router.php
• 只读检查 SiteStyle.php
• 只读检查 VideoSiteMapLogic.php / SiteMapLogic.php

目标：

• 先确认深页主输出、兼容入口、canonical、sitemap host 是否在同一规范口径

第二轮

• 再看 VideoService fallback

目标：

• 判断 404 的下降里有多少是“真实修复”
• 有多少是“应用层兜底”

第三轮

• 再去联动前置层查 444

目标：

• 确认 444 是安全噪音，还是已经开始误伤 SEO 主路径

给主 Codex 的一句话

如果只能先看 3 个地方，就先看 router.php 的历史深页兼容、SiteStyle.php 的 canonical 构建、以及 VideoSiteMapLogic/SiteMapLogic 的 https://www. host 拼接；这三条线最有可能直接对应当前仍未收口的深页 301 和首页 /|301。