docs(handoff): add must-read rules for new codex sessions

This commit is contained in:
root
2026-04-17 17:32:42 +08:00
parent 72cc7cb504
commit 49d8e39773
2 changed files with 35 additions and 0 deletions

View File

@@ -1,5 +1,29 @@
# 1270-SEONexus Codex 多版本协作交接总文档
## 接手前必读 5 条
任何新的 Codex 或人工在继续本项目前,先默认遵守这 5 条:
1. 先看当前线上复测,再看历史日志
- 历史 `403/444/301` 只能当趋势线索
- 不能直接当成“当前问题仍在发生”
2. 先确认真实路由,再判断是否异常
- 不要把旧路径残留直接当成当前拦截
- 典型如 `hyjssb` 的旧 `/shipinfenlei-...` 路由
3. 前端排障先看响应头
- 先看 `X-Cache-Status`
- 再看 `X-Cache-Mode`
- 再决定是否需要清缓存或加 `?__nocache=1`
4. 先把问题归类,再决定是否改代码
- 可能是旧日志残留
- 可能是旧路由失效
- 可能是前端缓存未刷新
- 只有确认仍是当前问题,才进入代码或 nginx 调整
5. 多人 / 多 Codex 协作时,先看短摘要,再看本总文档
- 先读:
[2026-04-17-spider-nginx-运维摘要.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md)
- 再回到本文看详细证据与时间线
## 正式服接手极简版
如果新的 Codex 会话是在正式服或其他机器上接手,而且当前目标是继续追回 GPT 模板深页 `seo_copy` 资产,先直接执行这一段,不要先大范围自由发挥。

View File

@@ -1,5 +1,16 @@
# 2026-04-17 Spider / Nginx 运维摘要
## 接手前必读 5 条
任何新的 Codex / 运维 / 人工接手这一段工作前,先遵守这 5 条:
1. 先看当前线上复测,再看历史日志
2. 先确认真实路由,再判断是否还存在问题
3. 前端排障先看 `X-Cache-Status / X-Cache-Mode / X-Managed-Spider`
4. 不要把旧路径残留误判成前端蜘蛛拦截
5. 如果需要完整证据链,再去看:
[1270-SEONexus-Codex多版本协作交接总文档.md](/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md)
## 1. 当前结论
截至 `2026-04-17` 晚间,这轮前端 nginx 优化已经从“问题排查期”进入“效果验证期”。