328 lines
9.6 KiB
Markdown
328 lines
9.6 KiB
Markdown
# 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 路由与详情兜底
|
||
|
||
- [SiteContext.php](/www/wwwroot/diff-maccms/SEONexus/code/app/services/SiteContext.php)
|
||
- [VideoService.php](/www/wwwroot/diff-maccms/SEONexus/code/app/services/VideoService.php)
|
||
- [router.php](/www/wwwroot/diff-maccms/SEONexus/code/app/home/config/router.php)
|
||
|
||
这一组负责：
|
||
|
||
1. 域名上下文正确落到 GPT 站
|
||
2. `/detail/:strPinyin`
|
||
3. `/detail/pinyin-:strPinyin`
|
||
4. slug-only 详情 fallback
|
||
5. 播放路由的详情取数兼容
|
||
|
||
### 3.2 sitemap 修复
|
||
|
||
- [VideoSiteMapLogic.php](/www/wwwroot/diff-maccms/SEONexus/code/app/task/logic/VideoSiteMapLogic.php)
|
||
- [SiteMapLogic.php](/www/wwwroot/diff-maccms/SEONexus/code/app/task/logic/SiteMapLogic.php)
|
||
|
||
这一组负责：
|
||
|
||
1. sitemap 目录递归创建
|
||
2. 详情 URL slug 规范化
|
||
3. 空 slug 回退
|
||
|
||
### 3.3 前台异常抓栈
|
||
|
||
- [ExceptionHandle.php](/www/wwwroot/diff-maccms/SEONexus/code/app/ExceptionHandle.php)
|
||
|
||
这一项是这次补的关键兜底。
|
||
|
||
作用：
|
||
|
||
1. 当前台 detail / play 类请求再出现 ThinkPHP 错页
|
||
2. 自动记录 host、url、route 参数、UA、异常 message、file、line
|
||
3. 方便后续按时间点抓栈
|
||
|
||
### 3.4 GPT 模板详情 / 播放 / 搜索页模板
|
||
|
||
- [getVideoInfo.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/video/getVideoInfo.html)
|
||
- [getVideoPlayUrl.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/video/getVideoPlayUrl.html)
|
||
- [dplayer.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/player/engine/dplayer.html)
|
||
- [title.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/detail_main/title.html)
|
||
|
||
搜索页：
|
||
|
||
- [search_header_simple.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/search/search_header_simple.html)
|
||
- [search_header_seo.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/search/search_header_seo.html)
|
||
- [search_header_rich.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/search/search_header_rich.html)
|
||
- [search_header_centered.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/search/search_header_centered.html)
|
||
- [search_header_media.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/search/search_header_media.html)
|
||
|
||
播放页：
|
||
|
||
- [play_01.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/play/play_01.html)
|
||
- [play_02.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/play/play_02.html)
|
||
- [play_03.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/play/play_03.html)
|
||
- [play_04.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/play/play_04.html)
|
||
- [play_05.html](/www/wwwroot/diff-maccms/SEONexus/code/app/home/view/videoGpt1/module/play/play_05.html)
|
||
|
||
## 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
|
||
|
||
例如：
|
||
|
||
```text
|
||
/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. 推荐验收命令
|
||
|
||
### 看状态码
|
||
|
||
```bash
|
||
curl -I -L -s 'https://example.com/detail/pinyin-xxx'
|
||
```
|
||
|
||
### 看 nocache
|
||
|
||
```bash
|
||
curl -I -L -s 'https://example.com/detail/pinyin-xxx?__nocache=1'
|
||
```
|
||
|
||
### 抽取 title / canonical / h1
|
||
|
||
```bash
|
||
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](/www/wwwroot/diff-maccms/SEONexus/code/app/ExceptionHandle.php)，下次再出现：
|
||
|
||
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 的接手话术
|
||
|
||
可以直接复制这段给对方：
|
||
|
||
```text
|
||
这次不是把别的模板迁到 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](/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/README.md)
|
||
2. [00-GPT模板SEO公共总览-2026-04-18.md](/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/00-GPT模板SEO公共总览-2026-04-18.md)
|
||
3. [07-GPT模板交接说明-2026-04-18.md](/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/07-GPT模板交接说明-2026-04-18.md)
|
||
|
||
## 11. 一句话结论
|
||
|
||
> 其它服务器如果原本也是 GPT 模板，现在要对齐到当前最新版，不要只改几个模板文件，必须把路由、服务层、sitemap 和异常抓栈一起同步，否则最容易出现“页面样式像更新了，但 slug 详情 / sitemap / 偶发异常仍停在旧版本”的半更新问题。
|