docs(readme): add docs entrypoint index

This commit is contained in:
root
2026-04-17 17:33:34 +08:00
parent 49d8e39773
commit 875c106908

View File

@@ -1,6 +1,73 @@
# SEONexus docs 同步说明
# SEONexus Docs 索引
- 当前目录用于承接外部 `/www/wwwroot/diff-maccms/docs`需要随仓库同步的关键文档。
- 现阶段优先同步多 Codex 协作总规则与老模板回灌执行文档。
- 原有 `SEONexus/doc` 目录暂不删除,避免影响项目内历史引用
- 后续若继续迁移,以 `SEONexus/docs` 作为正式协作文档入口。
当前目录用于承接需要随仓库同步的关键协作文档。
如果是新的 Codex 会话、人工接手,或跨机器继续排查,建议按下面顺序阅读
## 先看什么
### 1. 当前蜘蛛 / nginx 短摘要
先看:
- [2026-04-17-spider-nginx-运维摘要.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-17-spider-nginx-运维摘要.md)
适用场景:
1. 想快速知道当前蜘蛛恢复到什么阶段
2. 想知道当前推荐使用哪份前端 nginx 方案
3. 想知道哪些站已经验证通过
4. 想避免把旧日志误判成当前问题
### 2. 当前总交接文档
再看:
- [1270-SEONexus-Codex多版本协作交接总文档.md](/www/wwwroot/diff-maccms/SEONexus/docs/1270-SEONexus-Codex多版本协作交接总文档.md)
适用场景:
1. 需要完整时间线
2. 需要具体样本、URL、日志结论
3. 需要多人 / 多 Codex 协作边界
4. 需要正式服接手时的详细步骤
## 历史 / 专项文档
### 3. 老模板回灌执行文档
- [1269-SEONexus-老模板第一阶段回灌执行文档.md](/www/wwwroot/diff-maccms/SEONexus/docs/1269-SEONexus-老模板第一阶段回灌执行文档.md)
适用场景:
1. 回看老模板第一阶段执行过程
2. 对照历史回灌动作
3. 排查旧版本与新版本差异
### 4. Admin2 Spider Workbench 生产排障记录
- [2026-04-16-admin2-spider-workbench-production-fix.md](/www/wwwroot/diff-maccms/SEONexus/docs/2026-04-16-admin2-spider-workbench-production-fix.md)
适用场景:
1. 回看 admin2 正式服辅助排障
2. 查看 CORS / spider workbench / 生产辅助处理记录
## 当前协作规则
默认共识:
1. 先看当前线上复测,再看历史日志
2. 先确认真实路由,再判断是否异常
3. 前端排障先看:
- `X-Cache-Status`
- `X-Cache-Mode`
- `X-Managed-Spider`
4. 不要把旧路径残留误判成前端拦截
5. 不要在没有确认当前问题仍存在前就直接改代码或改 nginx
## 说明
1. 当前 `SEONexus/docs` 已作为正式协作文档入口
2. 原有 `SEONexus/doc` 目录暂不删除,避免影响历史引用
3. 后续新增交接、运维摘要、专项排障记录,优先落在这里