SEONexus/docs/Codex启动提示词模板.md

# Codex 启动提示词模板

这份模板给你在“新开一个 Codex 会话”时直接复制使用。

目标：

1. 让新会话先看对文档
2. 先遵守协作边界
3. 不要一上来就误判旧日志、旧路径、缓存问题

---

## 模板 1：蜘蛛 / nginx 分析接手

```md
你先不要自由发挥，先按这个顺序接手：

1. 先看 `/www/wwwroot/diff-maccms/SEONexus/docs/README.md`
2. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md`
3. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md`
4. 如需汇报，按 `/www/wwwroot/diff-maccms/SEONexus/docs/接手检查清单模板.md` 填写

当前任务：
- 继续分析国内蜘蛛（优先 baiduspider / sogou）恢复情况

工作边界：
- 先看当前线上复测，再看历史日志
- 先确认真实路由，再判断是否异常
- 前端排障先看 `X-Cache-Status / X-Cache-Mode / X-Managed-Spider`
- 不要把旧路径残留误判成前端拦截
- 没确认是当前问题前，不要直接改代码或改 nginx

优先输出：
1. 当前主结论
2. 当前复测证据
3. 当前仍未确认的点
4. 下一步建议
```

## 模板 2：正式服 / 生产辅助排障接手

```md
你先按固定顺序接手，不要直接自由排查：

1. 先看 `/www/wwwroot/diff-maccms/SEONexus/docs/README.md`
2. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md`
3. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md`
4. 如涉及 admin2 生产问题，再看：
   `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-16-admin2-spider-workbench-production-fix.md`

当前任务：
- 辅助正式服定位当前线上问题，但先做复测，不要先假设根因

边界：
- 先确认当前线上是否真实复现
- 先区分“旧日志残留 / 旧路径残留 / 缓存误判 / 当前真实异常”
- 未确认前，不要随意改生产规则

输出格式：
1. 是否复现
2. 当前真实路径
3. 当前响应头 / 状态码
4. 根因归类
5. 最小改动建议
```

## 模板 3：只做文档收口

```md
你这次只负责文档整理，不负责改业务代码。

请按顺序阅读：

1. `/www/wwwroot/diff-maccms/SEONexus/docs/README.md`
2. `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md`
3. `/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md`

当前任务：
- 把本轮新结论补进文档
- 保持短摘要、长文档、README、检查清单之间的引用一致

要求：
- 不要重写已有结论
- 只增量整理
- 提交前确认 README 仍能作为入口索引使用
```

## 模板 4：视频元数据 / 重采队列接手

```md
你这次先不要自由发挥，先按这个顺序接手：

1. 先看 `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-18-AI文案与视频元数据公共规则主线.md`
2. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-18-视频元数据缺失处理公共执行规则.md`
3. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/17-GPT模板AI文案最高规则-2026-04-18.md`
4. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/18-GPT模板演员导演缺失重采Top50执行单-2026-04-18.md`
5. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/19-GPT模板演员导演缺失Top20现场执行单-2026-04-18.md`
6. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/20-GPT模板演员导演缺失Top21-50现场执行单-2026-04-18.md`
7. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/21-GPT模板演员导演缺失重采结果回填模板-2026-04-18.md`
8. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/22-GPT模板第一轮重采实战复盘记录单-2026-04-18.md`
9. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/25-GPT模板第一二轮重采对比复盘-2026-04-18.md`
10. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/26-GPT模板第三轮短剧演员放量验证复盘-2026-04-18.md`
11. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/27-GPT模板第四轮短剧演员主线确立复盘-2026-04-18.md`
12. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/28-GPT模板第五轮短剧演员批处理复盘-2026-04-18.md`
13. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/29-GPT模板短剧演员双源重采SOP-2026-04-18.md`
14. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/30-GPT模板第六轮短剧演员复盘与解析容错修复-2026-04-18.md`
15. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/31-GPT模板字段补齐对7天SEO收益链路说明-2026-04-18.md`
16. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/32-GPT模板第七轮短剧演员尾部样本复盘-2026-04-18.md`
17. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/34-GPT模板第八轮短剧演员新鲜样本复盘-2026-04-18.md`
18. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/35-GPT模板第九轮现代都市新样本复盘-2026-04-18.md`
19. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/gpt-template-seo/36-GPT模板第十轮样本边界验证复盘-2026-04-18.md`
20. 再看 `/www/wwwroot/diff-maccms/SEONexus/code/storage/video-metadata-audit/latest.md`
21. 再看 `/www/wwwroot/diff-maccms/SEONexus/code/storage/video-metadata-recrawl-queue/latest.md`

当前任务：
- 继续推进视频库元数据优化
- 重点处理 `v_actor / v_director` 缺失

先记住：
- `AI文案规则` 和 `视频参数缺失处理规则` 现在属于全项目公共规则，不再只是 GPT 模板规则
- GPT 目录里的文档主要是“这条支线已经跑出来的实战结果与样本经验”
- 当前“视频缺字段工作台 / 任务池 / 状态 / 运维”页面入口已经迁到 `SEONexusAdmin` 这个 Vue 后台
- `PHP /admin/video/...` 主要看作数据接口，不再看作最终后台页面入口
- 当前正确的后台页面路径应优先走：
  - `#/video/metadata/missing/workbench`
  - `#/video/metadata/missing/task-pool`
  - `#/video/metadata/missing/task-pool/status`
  - `#/video/metadata/missing/task-pool/ops`

工作边界：
- 不允许用 AI 猜演员、导演、年份、地区、语言、发布日期
- 结构化字段优先走重采 / 补源 / 人工校正
- 文案型字段只补空，不覆盖已有内容
- `内详 / 未知 / 不详 / 待补充 / 暂无 / 未知演员 / 未知导演` 这类占位值一律按缺失处理
- 每次执行后必须复跑审计，确认缺口是否真实下降
- 已验证主线：`现代都市短剧 + 双源 + v_actor`
- 当前已验证结果：
  - 第二轮 `5/5` 演员补齐
  - 第三轮 `8/10` 演员补齐
  - 第四轮 `10/10` 演员补齐
- 第五轮 `10/10` 演员补齐
- 第六轮 `8/10` 演员补齐
- 第七轮 `6/10` 演员补齐
- 第八轮 `10/10` 演员补齐
- 第九轮 `8/10` 演员补齐
- 第十轮 `5/10` 演员补齐
- 当前导演字段三轮连续 `0` 补齐，不要再把 `v_director` 当作短期主 KPI
- 当前已修复 `youzhi` 未知分类 `type_id=95` 导致整轮中断的问题，后续这类样本允许“正常失败”，不允许“整批崩溃”
- 当前阶段要认识到：越往后进入尾部样本，单轮成功率会回落，但只要 `v_actor` 仍持续净下降，这条线依然值得推进
- 第八轮已经再次证明：第七轮的回落主要来自尾部样本池，不是主线失效；当前应坚持“新鲜短剧样本优先、低收益尾部样本降级”
- 第九轮进一步证明：换到另一批现代都市新样本后依然能拿到 `8/10`，当前主线已经具备连续复现性
- 第十轮进一步证明：主线不能无限泛化；一旦混入 `短剧大全 / 古风替嫁 / 玄门侧`，收益会明显回落，因此核心批处理必须重新收窄到 `现代都市新鲜样本`
- 要理解当前动作的 SEO 目标：先看 `31-GPT模板字段补齐对7天SEO收益链路说明-2026-04-18.md`

优先输出：
1. 当前主缺口是什么
2. 当前 Top 队列准备怎么执行
3. 本轮执行后哪些字段下降了
4. 哪个源站更有效
5. 下一轮优先补哪一批

优先命令：
1. `php think video:metadata:recrawl-queue --limit 50`
2. `php think video:metadata:recrawl-run --limit 10 --dry-run`
3. `php think video:metadata:recrawl-run --v-ids=156037 --sources=douban,youzhi`
4. `php think video:metadata:audit --sample 10`
```

## 使用建议

1. 新会话如果是“分析型任务”，优先用模板 1
2. 新会话如果是“线上辅助排障”，优先用模板 2
3. 新会话如果只是“整理文档 / 收口”，优先用模板 3
4. 新会话如果是“视频库字段补全 / 重采队列执行”，优先用模板 4
5. 如果任务混合，可以把模板 1、3、4 按需合并后再发

## 模板 5：公共规则极简接手

```md
你先不要自由发挥，先按这个顺序接手：

1. 先看 `/www/wwwroot/diff-maccms/SEONexus/docs/README.md`
2. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-18-AI文案与视频元数据公共规则主线.md`
3. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-18-视频元数据缺失处理公共执行规则.md`
4. 再看 `/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-19-私有运行产物存储与发布公共规则.md`
5. 如果任务涉及多人协作或老时间线，再看：
   `/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md`

先记住：
- `AI文案规则` 和 `视频元数据缺失处理规则` 现在属于全项目公共规则
- 所有后台运行产物、工作台快照、调试结果、中间文件默认放 `storage`
- 只要不是公网发布资产，就不要放 `public`
- Vue 后台打开私有产物时，走后台鉴权预览接口，不要直接拼 `public` URL
- 结构化字段不能靠 AI 猜
- 文案型字段只能在真实性边界内补空
- 所有补齐结果优先写回视频库

然后你再判断任务是：
1. GPT 模板支线
2. 蜘蛛 / nginx / 缓存排障
3. 视频元数据重采
4. 文档收口

优先输出：
1. 当前主结论
2. 当前任务属于哪条线
3. 当前适用的是哪套公共规则
4. 下一步建议
```