docs: add php and vue rollout guide

docs/2026-04-18-其它服务器更新操作单-PHP加Vue.md

@@ -0,0 +1,303 @@
+# 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 + 计划任务补齐 + 后台入口验证`
+
+这五步缺一不可。