admin/SEONexus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
dev
SEONexus/docs/gpt-template-seo/08-GPT模板其它服务器更新交接-2026-04-18.md

14 KiB
Raw Permalink Blame History

08 GPT模板其它服务器最新版对齐交接 2026-04-18

这份文档给“其它服务器上的 Codex / 接手同学”使用。

目标不是让对方自己猜，而是让对方直接知道：

  1. 这次要同步的是哪一条线
  2. 哪些文件必须一起更新
  3. 上线后先验什么
  4. 出现异常时先查哪里

1. 先定边界

这次不是“从老模板迁到 GPT 模板”。

前提是：

  1. 目标服务器原本就是 GPT 模板
  2. 目标服务器也在跑 videoGpt1
  3. 现在要做的是把它对齐到当前这台机器的最新 GPT 主线版本

这次同步的不是老模板，也不是全站所有样式。

这次同步的是：

  1. videoGpt1 这条 GPT 模板线
  2. GPT 模板详情 / 播放 / 搜索页 SEO 修复
  3. slug-only 详情兜底
  4. sitemap 修复
  5. 前台详情异常补充日志

不要混入：

  1. 1001-1005 老模板
  2. 其它组还没更新到当前 GPT 主线版本的站
  3. 与 GPT 模板无关的历史试验文件

2. 这次同步的核心目标

把“原本也是 GPT 模板”的其它服务器，对齐到当前主线，重点保证下面 5 件事：

  1. slug-only 详情页不要再硬 404
  2. /detail/pinyin-xxx 这类链接能兜底到真实详情页
  3. sitemap 主入口和视频分页正常
  4. GPT 模板搜索页 / 播放页 / 详情页主标题正常
  5. 如果前台详情页再出现 ThinkPHP 错页，能在日志里抓到异常栈

3. 必须同步的代码文件

下面这些文件建议按“必须同步”处理，不要只挑一半。

3.1 路由与详情兜底

这一组负责：

  1. 域名上下文正确落到 GPT 站
  2. /detail/:strPinyin
  3. /detail/pinyin-:strPinyin
  4. slug-only 详情 fallback
  5. 播放路由的详情取数兼容

3.2 sitemap 修复

这一组负责：

  1. sitemap 目录递归创建
  2. 详情 URL slug 规范化
  3. 空 slug 回退

3.3 前台异常抓栈

这一项是这次补的关键兜底。

作用：

  1. 当前台 detail / play 类请求再出现 ThinkPHP 错页
  2. 自动记录 host、url、route 参数、UA、异常 message、file、line
  3. 方便后续按时间点抓栈

3.4 GPT 模板详情 / 播放 / 搜索页模板

搜索页：

播放页：

4. 推荐同步顺序

不要乱序，建议按下面顺序做：

  1. 先同步服务层与路由：
    • SiteContext.php
    • VideoService.php
    • router.php
  2. 再同步 sitemap：
    • VideoSiteMapLogic.php
    • SiteMapLogic.php
  3. 再同步 GPT 模板：
    • getVideoInfo.html
    • getVideoPlayUrl.html
    • 搜索页模板
    • 播放页模板
    • detail_main/title.html
  4. 最后同步异常处理：
    • ExceptionHandle.php

原因：

  1. 先保证路由和取数能通
  2. 再保证 sitemap 不继续产坏链
  3. 再保证页面展示层正常
  4. 最后补抓栈，方便后续继续盯

5. 其它服务器接手 Codex 的执行步骤

第一步：先确认该服务器是不是同一条 GPT 模板线

先确认目标站是否真的使用 videoGpt1。

如果不是，就不要直接照搬这份文档。

如果是，就按“同模板线升级”处理，不要按“跨模板迁移”处理。

第二步：同步上面的必须文件

如果是同一套 GPT 模板代码目录，优先直接按文件覆盖同步。

如果是人工搬运，至少保证：

  1. 服务层 3 个文件一起到位
  2. sitemap 2 个文件一起到位
  3. GPT 模板文件整组到位
  4. ExceptionHandle.php 最后到位

第三步：清理运行时缓存

同步完代码后，至少做一次运行时清理，避免旧编译模板或旧路由缓存继续干扰。

重点关注：

  1. 模板缓存
  2. runtime 缓存
  3. sitemap 输出缓存

如果接手的 Codex 不确定怎么清，就先只做安全清理，不要删业务数据。

第四步：先验 4 类 URL

每台 GPT 服务器完成最新版对齐后，至少要验这 4 类：

  1. 首页
  2. 搜索页
  3. 详情页
  4. 播放页

6. 上线后最小验收清单

6.1 详情页兜底

至少抽查 2 类：

  1. 正常详情 URL
  2. slug-only / pinyin 详情 URL

例如：

/detail/pinyin-xxxxx
/film/slug/id
/movie/id-slug

通过标准：

  1. 返回 200
  2. canonical 正常
  3. 页面主 h1 正常
  4. 不再硬跳 ThinkPHP 错页

6.2 搜索页

通过标准：

  1. 搜索页 h1 有内容
  2. 不再空标题
  3. 搜索结果页 title / canonical 正常

6.3 播放页

通过标准：

  1. 播放页主标题正常
  2. 标题不再掉成空值
  3. 能从播放页正常回到详情页

6.4 sitemap

至少验：

  1. /sitemap.xml
  2. /sitemap_index.xml
  3. /sitemap-main.xml

通过标准：

  1. 返回 200
  2. 能打开
  3. 详情 URL 不再明显带空 slug

7. 推荐验收命令

看状态码

curl -I -L -s 'https://example.com/detail/pinyin-xxx'

看 nocache

curl -I -L -s 'https://example.com/detail/pinyin-xxx?__nocache=1'

抽取 title / canonical / h1

curl -L -s 'https://example.com/detail/pinyin-xxx' | rg -o '<title>.*?</title>|<link rel=\"canonical\".*?>|<h1[^>]*>.*?</h1>' -N

8. 如果仍出现 ThinkPHP 错页，先怎么查

这次已经补了前台 detail/play 异常日志。

如果其它服务器也同步了 ExceptionHandle.php，下次再出现：

9. 蜘蛛池 MD 远程推送补充说明

如果其它服务器也要同步“蜘蛛池 MD 自动生成 + 远程推送”，这次已经支持：

  1. Gitee 推送
  2. GitHub 推送
  3. 计划任务自动生成

9.1 后台系统配置里现在能看到的 GitHub 参数

进入“系统配置”后，搜索 SPIDER_MD_GITHUB，应该能看到：

  1. SPIDER_MD_GITHUB_ENABLED
    • 0 表示关闭
    • 1 表示开启
  2. SPIDER_MD_GITHUB_OWNER
    • 仓库所属用户名或组织名
    • 例如：yourname
  3. SPIDER_MD_GITHUB_REPO
    • 仓库名，不带 owner
    • 例如：seo-spider-md
  4. SPIDER_MD_GITHUB_BRANCH
    • 目标分支
    • 默认建议：main
  5. SPIDER_MD_GITHUB_ROOT
    • 仓库内子目录
    • 默认可填：seo-spider-md
    • 如果想直接写仓库根目录，可以留空
  6. SPIDER_MD_GITHUB_TOKEN
    • GitHub Token
    • 建议使用细粒度 Token
    • 至少给当前仓库 Contents: Read and write

9.2 最小可用配置

如果只想先跑通 GitHub 推送，最少需要填：

  1. SPIDER_MD_GITHUB_ENABLED=1
  2. SPIDER_MD_GITHUB_OWNER
  3. SPIDER_MD_GITHUB_REPO
  4. SPIDER_MD_GITHUB_BRANCH
  5. SPIDER_MD_GITHUB_ROOT
  6. SPIDER_MD_GITHUB_TOKEN

注意：

  1. 只开 ENABLED=1 但没填 owner / repo / token，不会真正推送成功
  2. root 只是远程目录，不是本地目录
  3. GitHub 和 Gitee 可以并行开启，互不冲突

9.3 计划任务怎么接

这次已经补了计划任务种子命令：

php think plan:seed:domain-spider-md

作用：

  1. 自动写入一条 GENERATE_DOMAIN_SPIDER_MD 计划任务
  2. 默认是 禁用 状态，不会一落地就乱跑
  3. 你可以进后台计划任务页再手工启用

执行逻辑：

  1. 任务 code：GENERATE_DOMAIN_SPIDER_MD
  2. 任务内容：生成蜘蛛池 MD
  3. 如果配置了 Gitee / GitHub，就会同步推送远程文件

9.4 其它服务器上线后先验什么

至少先验下面 4 件事：

  1. 后台系统配置能搜到 SPIDER_MD_GITHUB_*
  2. 执行一次蜘蛛池 MD 生成后，摘要里能看到 GitHub 配置状态
  3. 若已填 Token，生成记录里能看到 GitHub 推送结果
  4. 若开了计划任务，后台计划任务列表里能看到 GENERATE_DOMAIN_SPIDER_MD

9.5 如果后台看不到 GitHub 配置项

优先排查：

  1. 是否已同步 SpiderMdConfigHelper.php
  2. 是否已同步 SystemConfig.php
  3. 是否打开过一次“系统配置”列表页

当前版本里，系统配置列表页会自动把 SPIDER_MD_GITHUB_* 与 SPIDER_MD_GITEE_* 默认项补进数据库。

10. Spider MD 异步任务窗口补充说明

这次还额外补了 Spider MD 的异步任务消费器。

意义是：

  1. 后台点“生成并推送 / 强制重生成”后，不再只是创建一个 queued 任务
  2. 任务会真正进入 running
  3. 前台任务窗口会持续看到：
    • 当前阶段
    • 进度百分比
    • 实时日志
    • 失败原因

10.1 这次同步时必须注意的文件

如果漏掉这个文件，现场最常见的表现就是：

  1. 后台按钮点了
  2. 任务号也出来了
  3. 但状态一直停在 queued
  4. 进度条始终 0%
  5. 日志窗口只显示“任务已入队，等待执行”

10.2 现场正确现象

同步后，Spider MD 任务窗口里应该能看到：

  1. status: running
  2. progress_percent 持续变化
  3. 日志里出现：
    • 已载入多少个域名
    • [1/32] ... [2/32] ...
    • 已推送 GitHub：part-001.md
    • 如果失败，会直接显示失败原因

10.3 后台复制体验补充

这次 Vue 后台还补了：

  1. 主表右侧固定 一键复制MD
  2. 复制内容只保留 .md 直链
  3. 不再复制 summary.json / summary.html

如果其它服务器更新后发现：

  1. 要横向滚很远才能看到按钮
  2. 复制出来的是页面链接不是 md 直链

说明 SEONexusAdmin 最新代码还没有同步到位。

  1. 先记下精确时间
    • 例如：2026-04-18 14:23:15 +08:00
  2. 记下完整 URL
  3. 去 runtime 日志里搜：
    • frontend_detail_exception

重点看：

  1. host
  2. url
  3. route.strPinyin
  4. route.intVId
  5. exception_message
  6. exception_file
  7. exception_line

9. 给其它服务器 Codex 的接手话术

可以直接复制这段给对方：

这次不是把别的模板迁到 GPT。

目标服务器原本也是 GPT 模板，现在要做的是把它对齐到当前最新 GPT 主线版本。

请只处理 videoGpt1 相关代码，不要混入 1001-1005 老模板。

必须一起同步：
1. app/services/SiteContext.php
2. app/services/VideoService.php
3. app/home/config/router.php
4. app/task/logic/VideoSiteMapLogic.php
5. app/task/logic/SiteMapLogic.php
6. app/ExceptionHandle.php
7. app/home/view/videoGpt1/video/getVideoInfo.html
8. app/home/view/videoGpt1/video/getVideoPlayUrl.html
9. app/home/view/videoGpt1/module/detail_main/title.html
10. app/home/view/videoGpt1/module/player/engine/dplayer.html
11. app/home/view/videoGpt1/module/search/ 下 5 个搜索页模板
12. app/home/view/videoGpt1/module/play/ 下 5 个播放页模板

更新完成后先验：
1. 首页
2. 搜索页
3. 详情页
4. 播放页
5. sitemap.xml / sitemap_index.xml / sitemap-main.xml

重点确认：
1. slug-only 详情不再 404
2. 搜索页 h1 正常
3. 播放页 h1 正常
4. canonical 正常
5. 如再出现 ThinkPHP 错页，去查 frontend_detail_exception 日志

10. 接手前建议先看

先看这些文档再动代码：

  1. README.md
  2. 00-GPT模板SEO公共总览-2026-04-18.md
  3. 07-GPT模板交接说明-2026-04-18.md

11. 一句话结论

其它服务器如果原本也是 GPT 模板，现在要对齐到当前最新版，不要只改几个模板文件，必须把路由、服务层、sitemap 和异常抓栈一起同步，否则最容易出现“页面样式像更新了，但 slug 详情 / sitemap / 偶发异常仍停在旧版本”的半更新问题。

Reference in New Issue View Git Blame Copy Permalink