272 lines
7.8 KiB
Markdown
272 lines
7.8 KiB
Markdown
# 2026-04-18 PHP 与 Vue 收口交付总结
|
|
|
|
## 本轮目标
|
|
|
|
本轮收口的目标不是只补一个页面，而是把以下三条线真正闭环：
|
|
|
|
1. `Vue 后台` 成为视频缺字段工作台/任务池的正式入口，不再依赖错误的 PHP 后台页面直出。
|
|
2. `PHP 后端` 提供完整的数据接口、计划任务、工作台产物、任务池产物、缺字段扫描与安全补全能力。
|
|
3. `公共 AI 规则` 与 `视频元数据缺失处理规则` 提升为全项目共享规则，后续无论哪个模板、哪个 Codex 接手，都必须先读这条主线。
|
|
|
|
---
|
|
|
|
## 交付范围
|
|
|
|
### 1. Vue 后台侧
|
|
|
|
已迁移到 `SEONexusAdmin` 的后台能力：
|
|
|
|
- 视频缺字段控制台首屏卡片
|
|
- 视频缺字段工作台页
|
|
- 视频缺字段任务池页
|
|
- 视频缺字段状态总览页
|
|
- 视频缺字段运维总览页
|
|
- 系统配置页中的 `SEO AI 规则` 专属入口
|
|
- 新域名导入成功后的“下一步选择”弹窗
|
|
- `Codex继续`
|
|
- `OpenAI继续`
|
|
- 一键复制 Codex 提示词
|
|
|
|
### 2. PHP 后端侧
|
|
|
|
已补齐或增强的能力：
|
|
|
|
- 视频缺字段工作台接口
|
|
- 视频缺字段任务池接口
|
|
- 视频缺字段计划任务状态接口
|
|
- 视频缺字段批次状态保存接口
|
|
- 视频缺字段批次提示词接口
|
|
- 视频缺字段批次历史接口
|
|
- 视频缺字段工作台/任务池命令行命令
|
|
- 视频缺字段计划任务种子
|
|
- 视频元数据空字段安全补全 helper
|
|
- 采集器回填逻辑
|
|
- 仅在现有字段为空时，用新采集到的真实字段回填
|
|
- 不覆盖已有非空值
|
|
- 站点导入后自动生成基础产物
|
|
- SEO state
|
|
- manifest
|
|
- site positioning
|
|
- sitemap 入队
|
|
- starter published copy
|
|
|
|
### 2.1 运行产物存储口径补充
|
|
|
|
从 `2026-04-19` 开始，新增一条更严格的后端存储口径：
|
|
|
|
1. 后台运行产物
|
|
2. 工作台快照
|
|
3. 任务池快照
|
|
4. 手工导入中间文件
|
|
5. Search Console 模板
|
|
6. 站外 SEO latest / snapshot 摘要
|
|
|
|
以上这类数据，统一视为：
|
|
|
|
- 私有数据
|
|
- 运行时数据
|
|
- 不应默认纳入 Git 的数据
|
|
|
|
所以默认都应落在：
|
|
|
|
- `code/storage/...`
|
|
|
|
而不是：
|
|
|
|
- `code/public/...`
|
|
- `code/app/public/...`
|
|
|
|
当前已完成的收口包括：
|
|
|
|
1. `domain-seo-external latest / snapshot / snapshot-validate` 已迁到 `storage/external-seo/...`
|
|
2. `video-metadata-missing-workbench` 已迁到 `storage/video-metadata-missing/workbench`
|
|
3. `video-metadata-missing-task-pool` 已迁到 `storage/video-metadata-missing/task-pool`
|
|
4. `domain-seo-external/manual-import` 已迁到 `storage/external-seo/manual-import`
|
|
5. `domain-seo-external/search-console` 模板目录已迁到 `storage/external-seo/search-console`
|
|
6. `Vue 后台` 打开 `external-seo/*`、`video-metadata-missing/*` 这类产物时，不再假设文件直接暴露在 `public`，而是通过后台鉴权预览入口读取 `storage` 文件
|
|
|
|
以后如果再新增类似后台产物目录，优先原则是：
|
|
|
|
1. 先想能不能放 `storage`
|
|
2. 默认不要放 `public`
|
|
3. 只有明确需要前台公开访问的静态资源，才考虑进入 `public`
|
|
|
|
补充一条执行口径：
|
|
|
|
1. 如果后台页面需要“打开 HTML / JSON / CSV / prompt / payload”
|
|
2. 优先保留文件在 `storage`
|
|
3. 不要因为前台要看，就把私有运行产物重新搬回 `public`
|
|
4. 应优先补 `后台鉴权读取接口 + Vue 打开工具函数`
|
|
|
|
### 3. 公共规则侧
|
|
|
|
已确立为全项目公共主线的内容：
|
|
|
|
- AI 文案最高指令
|
|
- 详情摘要规则
|
|
- 详情正文规则
|
|
- 缺失字段处理规则
|
|
- 电影 / 剧集 / 综艺 / 动漫 / 短剧 细分风格规则
|
|
- 视频元数据缺失扫描与派单原则
|
|
|
|
---
|
|
|
|
## 重要路径说明
|
|
|
|
### Vue 后台真实入口
|
|
|
|
以下页面应从 `SEONexusAdmin` 的 `hash 路由` 进入：
|
|
|
|
- `#/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 这边现在主要负责：
|
|
|
|
- 数据接口
|
|
- 工作台产物生成
|
|
- 任务池产物生成
|
|
- 计划任务
|
|
- 命令行工具
|
|
|
|
不再把视频缺字段后台页面直接渲染成 PHP 管理页。
|
|
|
|
---
|
|
|
|
## 更新其它源时要同步的重点
|
|
|
|
### PHP 仓库必须同步
|
|
|
|
重点包含：
|
|
|
|
- `app/admin/controller/Video.php`
|
|
- `app/admin/controller/Site.php`
|
|
- `app/admin/controller/SystemConfig.php`
|
|
- `app/admin/config/router.php`
|
|
- `app/task/module/PlanTask.php`
|
|
- `config/console.php`
|
|
- `database/seeders/PlanTaskSeeder.php`
|
|
- `app/common/helper/SeoCopyAiRuleConfigHelper.php`
|
|
- `app/common/helper/VideoMetadata*`
|
|
- `app/command/VideoMetadata*`
|
|
- `app/model/VideoModel.php`
|
|
- `app/model/DomainModel.php`
|
|
- `app/services/SiteContext.php`
|
|
- 各采集器 `VideoInfoPage.php` 中的空字段回填逻辑
|
|
|
|
### Vue 仓库必须同步
|
|
|
|
重点包含：
|
|
|
|
- `src/views/video/metadataMissing/index.vue`
|
|
- `src/views/home/index.vue`
|
|
- `src/views/home/index.scss`
|
|
- `src/views/system/config/seoAiRules.vue`
|
|
- `src/views/system/config/index.vue`
|
|
- `src/views/system/config/drawer.vue`
|
|
- `src/views/site/index.vue`
|
|
- `src/api/modules/video/list.ts`
|
|
- `src/api/interface/video/list.ts`
|
|
- `src/api/modules/system/config.ts`
|
|
- `src/api/interface/system/config.ts`
|
|
- `src/api/interface/site/list.ts`
|
|
- `src/assets/json/authMenuList.json`
|
|
|
|
---
|
|
|
|
## 运行逻辑说明
|
|
|
|
### 1. 导入新域名后
|
|
|
|
系统现在会：
|
|
|
|
1. 注册域名
|
|
2. 初始化 SEO copy 基础状态
|
|
3. 初始化 site positioning
|
|
4. 把 sitemap 生成加入队列
|
|
5. 返回导入探测结果
|
|
6. 在 Vue 后台弹出“下一步选择”
|
|
|
|
系统不会再偷偷自动触发 OpenAI。
|
|
|
|
### 2. 运营继续
|
|
|
|
如果由运营继续：
|
|
|
|
1. 先看导入探测摘要
|
|
2. 确认页面无明显错误
|
|
3. 再点击后台 AI 功能，显式触发 OpenAI 队列
|
|
|
|
### 3. 技术继续
|
|
|
|
如果由技术继续：
|
|
|
|
1. 直接复制后台给出的 Codex 提示词
|
|
2. 在 VS Code 中打开当前工作区
|
|
3. 把提示词发给 Codex
|
|
4. 由 Codex 接管优化、复测、记录、收口
|
|
|
|
---
|
|
|
|
## 视频元数据空字段处理原则
|
|
|
|
这部分是公共规则，不只属于 GPT 模板：
|
|
|
|
1. 如果采集回来的演员、导演、语言、地区、年份、备注、简介等字段为空，先记录并进入缺字段工作台/任务池。
|
|
2. 如果后续同一资源再次采集到真实非空字段，只允许在“原字段为空”的前提下回填。
|
|
3. 不允许用采集结果覆盖已有真实非空值。
|
|
4. 不允许静默编造结构化事实字段。
|
|
5. 本地安全补全仅允许补：
|
|
- `v_description`
|
|
- `v_remarks`
|
|
6. 本地安全补全只能基于已有真实字段组织资料型文案，不能编造演员、导演、年份、剧情。
|
|
|
|
---
|
|
|
|
## 计划任务与自动触发
|
|
|
|
当前安全边界是：
|
|
|
|
1. 可以自动刷新工作台和任务池
|
|
2. 可以自动扫描空字段
|
|
3. 可以自动归档待处理批次
|
|
4. 不自动调用远程 AI 去补结构化事实
|
|
5. 不自动联网搜索演员/导演等真实资料
|
|
|
|
也就是说：
|
|
|
|
- `自动扫描` 可以开
|
|
- `自动派单` 可以开
|
|
- `自动 OpenAI 补事实字段` 当前不建议默认开启
|
|
|
|
---
|
|
|
|
## 后续建议
|
|
|
|
### 建议继续保留的执行节奏
|
|
|
|
1. 每日先看蜘蛛日志
|
|
2. 再看视频缺字段控制台
|
|
3. 先处理高流量、高抓取、高优先级资源
|
|
4. GPT 模板专属 SEO 文档继续写在 `docs/gpt-template-seo/`
|
|
5. 公共规则、公共机制、公共流程统一汇总在 `docs/` 根目录
|
|
|
|
### 下一批接手 Codex 必看
|
|
|
|
接手人至少先读：
|
|
|
|
- `docs/2026-04-18-AI文案与视频元数据公共规则主线.md`
|
|
- `docs/Codex启动提示词模板.md`
|
|
- `docs/2026-04-18-视频缺失字段工作台V1说明.md`
|
|
- `docs/2026-04-18-PHP与Vue收口交付总结.md`
|
|
|
|
---
|
|
|
|
## 一句话结论
|
|
|
|
这轮收口后，`视频缺字段工作台`、`任务池`、`公共 AI 规则`、`导入后继续分流` 已经形成一套可以复制到其它源的完整方案；后续其它服务器只要同步 `PHP + Vue` 两个仓库，就能拿到同一套后台能力和执行规则。
|