admin/SEONexus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e568577ce0fed9d1593d6fcc471bc1733c04116e
SEONexus/docs/2026-04-18-PHP与Vue收口交付总结.md
www 2b2b822631 feat: secure storage artifact preview
2026-04-19 21:29:51 +08:00

7.8 KiB
Raw Blame History

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 两个仓库，就能拿到同一套后台能力和执行规则。

Reference in New Issue View Git Blame Copy Permalink