一套以中文为主、面向长期学习、网站建设与实际 SEO 工作的系统化知识库。
项目以 Markdown 作为内容源,通过轻量 index.html 阅读器统一展示,不依赖 npm、构建流程或远程 CDN,可直接部署到 GitHub Pages,也适合长期保存为个人 / 团队 SEO 知识资产。
当前稳定版本:v1.0.0
内容规模:26 个核心章节 + 3 个知识导航 + 4 个体系规范 + 2 个维护模板
将仓库部署到 GitHub Pages 后,直接打开根目录的 index.html 即可进入完整知识阅读器。
阅读器采用三栏结构:
左侧:知识目录
中间:Markdown 正文
右侧:当前章节 H2 目录
如果第一次使用本仓库,建议从 **N1《SEO 知识总索引》**开始,而不是从第 01 章一路读到第 26 章。
由于浏览器对 file:// 的安全限制,直接双击 index.html 可能无法通过 JavaScript 读取 Markdown 文件。
在项目根目录启动一个简单的 HTTP 服务即可:
python -m http.server 8000Windows 也可以使用:
py -m http.server 8000然后访问:
http://localhost:8000
停止服务:
Ctrl + C
本项目不是某一款 SEO 工具的使用手册,也不以工具菜单作为知识目录。
它试图建立的是一条完整的 SEO 工作链:
搜索需求
↓
关键词、搜索意图与 SERP
↓
页面与网站规划
↓
内容、体验与内部链接
↓
抓取、渲染、索引与结构化数据
↓
外部认可与品牌信号
↓
Search Console / Analytics / CRM 验证
↓
SEO Audit
↓
Regression Monitoring
↓
持续优化
因此,这个仓库更接近一套:
SEO 知识体系 + 工作方法 + 审计框架 + 长期维护规范
- 网站建设与网站运维人员;
- WordPress / WooCommerce 开发与维护人员;
- 企业官网、外贸网站和 B2B 网站负责人;
- SEO 从业者与内容团队;
- 希望从零散技巧升级为系统 SEO 认知的人;
- 希望把 SEO 工作变成可验证、可复盘、可长期维护流程的团队。
项目案例优先使用企业官网、产品网站、WordPress、WooCommerce、国际站和 B2B 场景,但大多数方法同样适用于其他网站类型。
SEO 很容易被拆成大量孤立技巧:
关键词
Title
外链
Schema
速度
GSC
AI Search
……
真正工作时,它们却并不是彼此独立的。
例如一个页面没有流量,原因可能来自:
没有真实搜索需求
→ 搜索意图判断错误
→ 页面类型错误
→ 页面没有进入正确网站结构
→ Canonical / noindex 异常
→ JavaScript 渲染失败
→ 内容缺乏可信证据
→ 内部链接不足
→ SERP 竞争环境变化
本项目的目标,就是把这些知识重新组织成一个可以顺着问题追查根因的系统。
整个仓库分为三个层级。
解决“我现在应该查什么、按什么顺序做”。
| 编号 | 文档 | 作用 |
|---|---|---|
| N1 | SEO 知识总索引 | 按问题、任务、角色和数据来源定位章节 |
| N2 | SEO 知识主链与工作流地图 | 把章节组织成新站、旧站、迁移、电商、国际等工作流 |
| N3 | SEO 总检查表 | 用统一入口完成跨领域 SEO 验收 |
负责统一全库的表达与判断标准。
| 编号 | 规范 | 作用 |
|---|---|---|
| S1 | SEO 知识体系术语规范 | 统一中文、英文、缩写与正式写法 |
| S2 | E1~E5 证据与结论规范 | 区分官方规则、本站证据、测量、第三方数据与假设 |
| S3 | P0~P3 优先级与问题管理规范 | 统一 Issue、Risk、Opportunity 与排期方式 |
| S4 | 章节写作、B2B 案例与跨章节引用规范 | 统一案例、职责边界、去重与内部链接方式 |
| 部分 | 章节 | 核心主题 |
|---|---|---|
| 01 基础与方法 | 01~03 | SEO 全景、搜索处理链、证据与验证 |
| 02 搜索市场研究 | 04~09 | 关键词、意图、SERP、竞争、聚类、信息架构 |
| 03 页面与内容 | 10~13 | SXO、内容质量、On-page、内部链接 |
| 04 技术基础 | 14~17 | 技术 SEO、JavaScript SEO、CWV、结构化数据 |
| 05 权威与数据 | 18~21 | 外链与品牌、SEO 数据、Audit、Regression |
| 06 场景与未来 | 22~26 | 国际、电商、本地、程序化、AI Search / Agent |
- 01 SEO 全景与工作闭环
- 02 搜索引擎的发现、抓取、渲染、索引与排名
- 03 SEO 证据、假设、判断与验证
- 04 关键词研究
- 05 搜索意图
- 06 SERP 与页面类型分析
- 07 SEO 竞争对手研究
- 08 关键词聚类与主题规划
- 09 内容与网站信息架构
- 10 搜索体验优化与用户任务
- 11 内容质量与 E-E-A-T
- 12 页面 SEO
- 13 内部链接与主题网络
- 14 技术 SEO
- 15 JavaScript SEO 与渲染
- 16 页面性能与 Core Web Vitals
- 17 结构化数据
- 18 权威、外链与品牌信号
- 19 Search Console、Analytics 与 SEO 指标
- 20 SEO 审计、优先级与持续优化
- 21 SEO 变更监控与回归检查
- 22 国际 SEO 与多语言网站
- 23 电商、产品与 WooCommerce SEO
- 24 本地 SEO
- 25 程序化 SEO
- 26 AI 搜索、GEO/AEO 与 Agent
不建议把这套知识体系当成一本必须从头读到尾的电子书。
更推荐从真实问题进入。
想做关键词研究
→ 04 → 05 → 06 → 07 → 08 → 09
网站页面不收录
→ 02 → 14 → 15 → 20
流量突然下降
→ 19 → 20 → 21
WooCommerce 筛选 URL 太多
→ 09 → 14 → 23 → 25
准备做国际站
→ 04 → 05 → 09 → 14 → 22
AI 搜索中几乎没有引用
→ 11 → 17 → 18 → 19 → 26
更多问题入口与完整工作流请查看 N1~N3。
根目录的 index.html 是整套知识体系的统一阅读入口。
主要特性:
- 左侧按知识导航、体系规范和 01~26 章节分组;
- 分类支持展开 / 收起;
- 当前章节自动高亮;
- 中间区域渲染 Markdown 正文;
- 右侧只显示当前文章 H2,避免超长目录膨胀;
- 页面滚动时自动高亮当前 H2;
- Markdown 内部章节链接继续在阅读器中打开;
- N1~N3、S1~S4、01~26 分别保持独立的上一篇 / 下一篇序列;
- 桌面端使用三栏布局,移动端使用抽屉式导航;
- Task List、表格、代码块、引用等样式已统一处理;
- Markdown 解析器
marked.min.js保存在本地,不依赖远程 CDN。
seo-knowledge-system/
├── .nojekyll
├── index.html
├── README.md
│
├── assets/
│ ├── css/
│ │ └── style.css
│ └── js/
│ ├── app.js
│ ├── docs.js
│ └── vendor/
│ └── marked.min.js
│
├── docs/
│ ├── 01-seo-overview.md
│ ├── 02-search-engine-basics.md
│ ├── ...
│ └── 26-ai-search.md
│
├── guides/
│ ├── 01-knowledge-index.md
│ ├── 02-workflow-map.md
│ └── 03-master-checklist.md
│
├── standards/
│ ├── 01-terminology.md
│ ├── 02-evidence-levels.md
│ ├── 03-priority-levels.md
│ └── 04-writing-and-cases.md
│
└── templates/
├── article-template.md
└── checklist-template.md
项目无需构建,可直接使用 GitHub Pages。
上传仓库后进入:
Settings
→ Pages
→ Build and deployment
→ Deploy from a branch
→ main / root
→ Save
部署完成后,GitHub Pages 会直接使用根目录中的 index.html 作为阅读入口。
项目包含 .nojekyll,用于避免 GitHub Pages 对静态目录执行不必要的 Jekyll 处理。
直接编辑对应 Markdown 文件:
docs/xx-xxxx.md
只修改正文时,不需要调整阅读器代码。
如果未来确实需要新增文档:
- 新建 Markdown 文件;
- 在
assets/js/docs.js中登记标题、描述、路径、状态和标签; - 按 S4 规范补充职责边界和相关章节;
- 检查相对路径、代码块与内部链接;
- 本地预览确认阅读器正常。
v1.0.0之后,新增主题应优先判断是否能归入现有 26 个核心章节,避免再次形成无限扩章。
为了避免把经验判断描述成官方规则,全项目统一使用以下证据等级:
| 等级 | 含义 |
|---|---|
| E1 | 官方机制与标准 |
| E2 | 本站直接证据 |
| E3 | 可重复测量 |
| E4 | 间接与第三方证据 |
| E5 | 经验规则与待验证假设 |
完整定义见 S2《E1~E5 证据与结论规范》。
证据等级不是简单的“E1 永远高于 E2”,还需要结合问题的相关性、直接性、范围、新鲜度与可重复性判断。
全项目只维护一套 SEO 问题优先级:
| 等级 | 含义 |
|---|---|
| P0 | 立即处理,存在严重搜索或业务阻断 |
| P1 | 高影响,应在近期优先处理 |
| P2 | 重要问题,进入正常排期 |
| P3 | 低风险、优化机会或继续观察 |
它是本项目内部的工作管理模型,不是 Google 官方 Severity 等级。
完整定义见 S3《P0~P3 优先级与问题管理规范》。
- 先解释机制,再介绍工具;
- 区分官方事实、本站证据、第三方数据和经验假设;
- 不把 DR、DA、Authority Score、SEO Score 等第三方指标当作 Google 内部评分;
- 不把内部 Quality Gate 或经验阈值描述成 Google 官方标准;
- 重要建议尽可能说明证据、影响、行动与验证方法;
- 通用机制只在主责章节完整解释,场景章节只保留具体应用;
- 优先使用真实企业官网、WordPress、WooCommerce、B2B 和外贸场景;
- 中文能够准确表达时优先使用中文,必要的标准术语保留英文;
- 高变化主题优先重新核验官方资料,而不是沿用旧 SEO 教程;
- 以长期可维护性优先,不为了增加“技巧数量”无限扩张体系。
本知识体系最初参考了两个开源 SEO 项目的部分方法:
- OpenSEO —— 主要参考 SEO 数据组织与工作流思想;
- Claude SEO —— 主要参考审计、验证、漂移监控和 Quality Gate 思想。
项目不会照搬它们的目录、评分规则或工具结构,而是将其中具有长期价值的观点重新整理为通用 SEO 方法。
涉及 Google 搜索机制、结构化数据、国际 SEO、Core Web Vitals、Spam Policies 等高变化主题时,以官方资料为首要依据:
各章节正文中保留了更具体的参考资料与证据边界。
| 版本 | 主要内容 |
|---|---|
| v0.2.0 | 完成基础与搜索市场研究 |
| v0.3.0 | 完成页面、内容与技术基础 |
| v0.4.0 | 完成权威、数据、审计与回归监控 |
| v0.5.0 | 26 个核心章节全部形成正式正文 |
| v0.6.0 | 建立术语、证据、优先级、案例与写作规范 |
| v0.7.x | 完成 01~26 章统一回填与跨章职责整理 |
| v0.8.0 | 建立知识总索引、工作流地图与总检查表 |
| v0.9.0 | 完成全量内容与阅读器 QA |
| v0.9.1 | 更换并定稿三栏 Markdown 阅读器 |
| v1.0.0 | 26 章、知识导航、体系规范与阅读器正式封版 |
v1.0.0 是本项目首个正式稳定版本。
26 / 26 核心章节
3 / 3 知识导航
4 / 4 体系规范
后续维护优先级:
官方规则变化
→ 事实修正
→ 案例补充
→ 内部链接优化
→ 阅读体验改进
原则上不再以“继续增加章节数量”为目标,而是持续提高现有知识体系的 准确性、一致性、可验证性和可维护性。