304 lines
7.4 KiB
Markdown
304 lines
7.4 KiB
Markdown
# 2026-04-18 其它服务器更新操作单 PHP + Vue
|
||
|
||
## 适用范围
|
||
|
||
这份操作单用于把本轮 `GPT 模板 SEO 收口` 同步到其它服务器。
|
||
|
||
本轮更新不是单仓库，而是两套仓库一起更新：
|
||
|
||
1. `SEONexus`
|
||
用途：PHP 后端、接口、计划任务、命令、公共规则、文档
|
||
2. `SEONexusAdmin`
|
||
用途：Vue 后台页面、菜单、交互、导入后分流弹窗、缺字段控制台
|
||
|
||
如果只更新其中一个仓库，会出现前后端不匹配。
|
||
|
||
---
|
||
|
||
## 本轮目标
|
||
|
||
同步完成后，其它服务器应具备以下能力：
|
||
|
||
1. Vue 后台可直接打开视频缺字段工作台
|
||
2. Vue 后台首页首屏能看到“视频缺字段控制台”
|
||
3. Vue 后台可直接维护 `SEO AI 规则`
|
||
4. 新域名导入成功后，可弹出：
|
||
- `Codex继续`
|
||
- `OpenAI继续`
|
||
5. PHP 后端已具备：
|
||
- 视频缺字段工作台接口
|
||
- 任务池接口
|
||
- 状态接口
|
||
- 计划任务刷新能力
|
||
- 命令行工具
|
||
- 视频空字段安全补全能力
|
||
|
||
---
|
||
|
||
## 对应提交
|
||
|
||
### PHP 仓库
|
||
|
||
- 仓库：`SEONexus`
|
||
- 分支：`dev`
|
||
- 提交：`cec1fdbc`
|
||
|
||
### Vue 仓库
|
||
|
||
- 仓库：`SEONexusAdmin`
|
||
- 分支：`main`
|
||
- 提交：`2d18344`
|
||
|
||
---
|
||
|
||
## 更新前确认
|
||
|
||
先确认当前服务器的两个目录存在：
|
||
|
||
```bash
|
||
ls -ld /www/wwwroot/diff-maccms/SEONexus
|
||
ls -ld /www/wwwroot/diff-maccms/SEONexusAdmin
|
||
```
|
||
|
||
再确认仓库属主是否是 `www`，后续 git 建议都使用 `www` 账号执行：
|
||
|
||
```bash
|
||
stat -c '%U %G %a %n' /www/wwwroot/diff-maccms/SEONexus
|
||
stat -c '%U %G %a %n' /www/wwwroot/diff-maccms/SEONexusAdmin
|
||
```
|
||
|
||
---
|
||
|
||
## 第一步 更新 PHP 仓库
|
||
|
||
```bash
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexus fetch origin2'
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexus checkout dev'
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexus pull origin2 dev'
|
||
```
|
||
|
||
如果只想精确到本次提交，也可以执行：
|
||
|
||
```bash
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexus checkout cec1fdbc'
|
||
```
|
||
|
||
但正式线上仍建议保持在 `dev` 分支。
|
||
|
||
---
|
||
|
||
## 第二步 更新 Vue 仓库
|
||
|
||
```bash
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexusAdmin fetch origin2'
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexusAdmin checkout main'
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexusAdmin pull origin2 main'
|
||
```
|
||
|
||
如果只想精确到本次提交，也可以执行：
|
||
|
||
```bash
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexusAdmin checkout 2d18344'
|
||
```
|
||
|
||
---
|
||
|
||
## 第三步 构建 Vue 后台
|
||
|
||
只有拉了 `SEONexusAdmin` 还不够，必须重新 build：
|
||
|
||
```bash
|
||
su -s /bin/bash www -c 'cd /www/wwwroot/diff-maccms/SEONexusAdmin && npm run build'
|
||
```
|
||
|
||
如果服务器线上是直接用 `dist` 静态目录，这一步必须执行，否则后台还是旧页面。
|
||
|
||
---
|
||
|
||
## 第四步 建议执行的 PHP 检查
|
||
|
||
```bash
|
||
php -l /www/wwwroot/diff-maccms/SEONexus/code/app/admin/controller/Video.php
|
||
php -l /www/wwwroot/diff-maccms/SEONexus/code/app/admin/controller/Site.php
|
||
php -l /www/wwwroot/diff-maccms/SEONexus/code/app/admin/controller/SystemConfig.php
|
||
php -l /www/wwwroot/diff-maccms/SEONexus/code/app/task/module/PlanTask.php
|
||
php -l /www/wwwroot/diff-maccms/SEONexus/code/app/model/VideoModel.php
|
||
```
|
||
|
||
如果这些文件语法通过，再继续下一步。
|
||
|
||
---
|
||
|
||
## 第五步 如需补齐计划任务
|
||
|
||
这轮更新里新增了视频缺字段相关计划任务种子。
|
||
|
||
建议执行：
|
||
|
||
```bash
|
||
php /www/wwwroot/diff-maccms/SEONexus/code/think plan:seed:video-metadata-missing
|
||
```
|
||
|
||
说明：
|
||
|
||
1. 这条命令负责写入或补齐 `REFRESH_VIDEO_METADATA_TASK_POOL`
|
||
2. 它本身不会偷偷调用 OpenAI
|
||
3. 它只是把“视频缺字段工作台/任务池刷新计划”补齐
|
||
|
||
---
|
||
|
||
## 第六步 进入后台验证
|
||
|
||
### 1. 首页验证
|
||
|
||
登录 Vue 后台后，首页首屏应该能看到：
|
||
|
||
- `视频缺字段控制台`
|
||
|
||
如果首页没有这块，大概率是：
|
||
|
||
1. `SEONexusAdmin` 没更新
|
||
2. `npm run build` 没执行
|
||
3. 部署的不是最新 `dist`
|
||
|
||
### 2. 菜单验证
|
||
|
||
在视频管理下应能看到：
|
||
|
||
- `缺字段工作台`
|
||
- `缺字段任务池`
|
||
|
||
### 3. SEO 规则页验证
|
||
|
||
在系统配置下应能看到：
|
||
|
||
- `SEO AI规则`
|
||
|
||
---
|
||
|
||
## 第七步 正确页面入口
|
||
|
||
本轮后台入口以 `Vue hash 路由` 为准，不要再用旧的 PHP 页面思路。
|
||
|
||
正确入口示例：
|
||
|
||
- `#/video/metadata/missing/workbench`
|
||
- `#/video/metadata/missing/task-pool`
|
||
- `#/video/metadata/missing/task-pool/status`
|
||
- `#/video/metadata/missing/task-pool/ops`
|
||
- `#/system/config/seo-ai-rules`
|
||
|
||
错误理解：
|
||
|
||
- 不是直接访问 PHP 视图页来当后台页面
|
||
- PHP 现在主要是接口和执行逻辑
|
||
|
||
---
|
||
|
||
## 第八步 新域名导入后验证
|
||
|
||
导入一批新域名后，应该出现以下行为：
|
||
|
||
1. 导入成功
|
||
2. 返回探测结果
|
||
3. 弹出“下一步选择”
|
||
- `Codex继续`
|
||
- `OpenAI继续`
|
||
4. 可以复制 Codex 提示词
|
||
5. 可以查看导入后自动产物审计
|
||
|
||
如果这一步没出现，多半需要检查：
|
||
|
||
- `SEONexusAdmin/src/views/site/index.vue`
|
||
- `SEONexus/code/app/admin/controller/Site.php`
|
||
|
||
---
|
||
|
||
## 第九步 视频缺字段机制说明
|
||
|
||
这轮更新后，视频空字段处理分三层：
|
||
|
||
### 第一层 采集回填
|
||
|
||
当采集器再次抓到真实字段时：
|
||
|
||
- 只在原字段为空时回填
|
||
- 不覆盖已有非空值
|
||
|
||
### 第二层 本地安全补全
|
||
|
||
本地可安全补的只有：
|
||
|
||
- `v_description`
|
||
- `v_remarks`
|
||
|
||
且只能基于已有真实字段组织资料型文案。
|
||
|
||
### 第三层 工作台与任务池
|
||
|
||
如果演员、导演、年份、简介等仍为空：
|
||
|
||
- 进入工作台
|
||
- 进入任务池
|
||
- 由技术通过 Codex 继续处理
|
||
|
||
默认不自动调用 OpenAI 去补结构化事实。
|
||
|
||
---
|
||
|
||
## 第十步 更新完成后的最小验证命令
|
||
|
||
建议对方服务器至少执行这组检查：
|
||
|
||
```bash
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexus rev-parse --short HEAD'
|
||
su -s /bin/bash www -c 'git -C /www/wwwroot/diff-maccms/SEONexusAdmin rev-parse --short HEAD'
|
||
su -s /bin/bash www -c 'cd /www/wwwroot/diff-maccms/SEONexusAdmin && npm run build'
|
||
php /www/wwwroot/diff-maccms/SEONexus/code/think plan:seed:video-metadata-missing
|
||
```
|
||
|
||
预期结果：
|
||
|
||
1. PHP 仓库已包含 `cec1fdbc`
|
||
2. Vue 仓库已包含 `2d18344`
|
||
3. Vue 构建通过
|
||
4. 缺字段计划任务已补齐
|
||
|
||
---
|
||
|
||
## 如果让其它 Codex 接手
|
||
|
||
建议把下面这段直接发给对方：
|
||
|
||
```text
|
||
请接手当前服务器的 GPT 模板 SEO 最新版本同步。
|
||
|
||
目标：
|
||
1. 更新 PHP 仓库 SEONexus 到包含提交 cec1fdbc 的版本
|
||
2. 更新 Vue 仓库 SEONexusAdmin 到包含提交 2d18344 的版本
|
||
3. 重新 build Vue 后台
|
||
4. 补齐视频缺字段计划任务
|
||
5. 登录后台验证以下页面是否存在并可打开：
|
||
- #/video/metadata/missing/workbench
|
||
- #/video/metadata/missing/task-pool
|
||
- #/system/config/seo-ai-rules
|
||
6. 验证首页是否出现“视频缺字段控制台”
|
||
7. 验证新域名导入成功后是否弹出“Codex继续 / OpenAI继续”
|
||
|
||
注意：
|
||
1. 仓库属主通常是 www，git 操作优先使用 www 执行
|
||
2. 本轮不是单仓库更新，而是 PHP + Vue 双仓库一起更新
|
||
3. PHP 现在主要提供接口与任务逻辑，后台页面入口以 Vue hash 路由为准
|
||
4. 不要把视频缺字段工作台继续做成 PHP 管理页直出
|
||
```
|
||
|
||
---
|
||
|
||
## 一句话结论
|
||
|
||
其它服务器更新时，核心不是“拉一次代码”，而是：
|
||
|
||
`SEONexus 更新 + SEONexusAdmin 更新 + Vue build + 计划任务补齐 + 后台入口验证`
|
||
|
||
这五步缺一不可。
|