diff --git a/docs/README.md b/docs/README.md
index ebaa842..c6a96b9 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -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. 后续新增交接、运维摘要、专项排障记录，优先落在这里