# 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 + 计划任务补齐 + 后台入口验证`

这五步缺一不可。