使用 Codex 进行 SEO 优化全记录:从建站到落地的 AI 协作实践

背景

个人技术博客站 hydeh.com 基于 Hexo 框架搭建。在本次 SEO 优化中全程使用 Codex CLI(AI 编程助手) 以对话协作的方式完成。

本文重点不仅在于具体修复了什么,更在于——选择正确的技术栈,决定了 AI 能帮你做到什么程度


Hexo vs WordPress:AI 协作场景下的框架选择

在开始 SEO 工作之前,必须要理解:不同的框架对 AI 的”友好程度”天差地别。以下对比基于同一个任务——让 AI 帮你的网站做 SEO 优化:

Hexo vs WordPress AI 协作流程对比

维度 Hexo(静态站点生成器) WordPress(动态 CMS)
内容存储方式 纯文本文件(.md / .ejs / .styl) MySQL 数据库 + PHP 文件
AI 操作方式 直接读写文件(AI 最擅长的能力) 需要 SQL 语句或 REST API + 认证 Token
操作风险 低——文件操作可回滚、可 diff 中高——数据库误操作影响面大
本地开发环境 hexo server 一条命令,无需数据库 需要 PHP + MySQL + Web 服务器完整环境
部署流程 hexo generate 生成纯静态文件 → 上传服务器 导出数据库 + 迁移文件 + 配置环境变量
版本管理 全文件可纳入 Git:文章、配置、模板、样式 只能跟踪 PHP 文件,数据库内容无法 Git 管理
AI 能做的事 全生命周期管理:增删改查文章、配置、模板、样式、构建、部署涉及的所有文件 受限:只能改 PHP 模板;文章内容需通过 API 或 SQL
多人 AI 协作 多个 AI 会话可同时操作不同文件,无冲突 需考虑数据库连接锁、事务隔离等
安全性 纯文件操作,敏感数据(Token/密码)写在配置文件,可控可审查 数据库注入、API 认证、Session 管理等额外安全隐患

核心差异总结

Hexo 的一切都是文件。AI 最核心、最擅长的能力就是读写文件。这意味着:

  • 只需给 AI 一个文件路径,它就能增删改查任何内容
  • 从文章正文、配置文件、模板逻辑到样式表,全部用自然语言描述即可
  • 构建结果也是静态文件,无需运行时环境,发布就是文件上传
  • 整个建站 + 优化 + 运营流程,AI 可以全链路参与

WordPress 的内容在数据库里。AI 要操作内容需要:

  • 要么通过数据库客户端执行 SQL(风险高、需要权限)
  • 要么通过 WordPress REST API(需要额外配置认证、API 密钥)
  • 部署时需要处理数据库迁移、环境差异、PHP 版本兼容等问题
  • AI 能参与的环节有限,大部分数据库层面的操作仍需人工介入

结论:如果你计划大量使用 AI 辅助建站、SEO 优化和日常内容运营,Hexo 这类基于文件的静态站点生成器是更高效、更安全的选择。AI 可以全程管理从内容编写、技术优化到部署发布的每一个环节,而 WordPress 的数据库依赖让 AI 的参与变得复杂且受限。


SEO 需要做什么——以及 AI 如何用自然语言完成

以下按 SEO 工作类型分类,每个类别都说明了需要做什么,以及AI 如何通过自然语言输入来生成详细内容

1. 基础 Meta 配置

需要做

  • 每页设置唯一的 titledescriptionkeywords
  • 配置 robots 标签(index/follow)
  • 添加 canonical 规范链接
  • 设置 Open Graph / Twitter Card 社交标签

AI 如何完成:只需告诉 AI “给所有页面加上规范化的 meta 标签”,AI 会自行扫描模板文件、批量注入标签、提取文章摘要作为 description,并按照 SEO 规范生成完整的标签结构。

2. 结构化数据(Schema)

需要做

  • JSON-LD:Person、WebSite、Article、BreadcrumbList
  • 每篇文章自动生成 Article schema
  • 非文章页面生成 BreadcrumbList

AI 如何完成:描述业务场景和要求(如”我是个人技术博客的作者,需要添加个人信息结构化数据”),AI 自动编写 EJS 模板逻辑、读取文章元数据、动态渲染 JSON-LD 并验证语法正确性。

3. 性能优化

需要做

  • 压缩/移除大文件(字体、图片、JS)
  • 非关键 JS 加 defer / async
  • 优化关键渲染路径
  • 移除渲染阻塞资源

AI 如何完成:告诉 AI “页面加载太慢,分析一下瓶颈在哪”,AI 会自动扫描文件体积分布、识别最大的资源、给出替换建议并执行修改。比如发现 10MB 自定义字体后,AI 直接替换为系统字体栈并对比前后体积变化。

4. 网站可访问性

需要做

  • Viewport 允许缩放
  • 添加 ARIA 地标(main、nav 等)
  • 文字对比度达标(WCAG AA ≥ 4.5:1)

AI 如何完成:告诉 AI “网站需要符合无障碍标准”,AI 自动扫描 CSS 颜色值、计算对比度、调整色值、验证通过标准,同时修复 viewport 和 ARIA 属性。

5. URL 结构优化

需要做

  • 避免中文路径
  • 配置 URL 别名 / 重定向
  • 确保永久链接结构清晰
  • 处理分类/标签页面的 URL

AI 如何完成:只需要说”把分类 URL 改成拼音”,AI 自动配置 category_map、批量替换所有内部链接、验证所有路径的可访问性。

6. 搜索引擎验证与提交

需要做

  • Google Search Console / 百度资源平台注册
  • 添加验证 meta 标签
  • 生成并提交 sitemap
  • 主动推送链接(百度 API)

AI 如何完成:提供验证代码,AI 自动嵌入到模板中、配置 sitemap 生成规则、导出所有 URL 列表、构造推送请求。敏感 Token 等由人工控制在配置文件中,AI 引用而非硬编码。

7. 内容优化

需要做

  • 每篇文章 120-160 字的 meta description
  • 合理的关键词布局
  • 内部链接网络
  • 文章间相互引用

AI 如何完成:告诉 AI “给所有文章写 SEO 描述,每篇 150 字左右,包含核心关键词”,AI 会逐篇阅读文章内容、提取关键信息、生成符合 SEO 规范的描述文本,并自动写入文章 front-matter。内容修改、增加内部链接、调整文章结构等,都可以通过自然语言一句话完成。

8. SPA 单页应用 SEO

需要做

  • 预渲染页面添加正确 head 信息
  • 注入 title / description / canonical
  • 确保搜索引擎可抓取

AI 如何完成:描述 SPA 的结构,AI 自动找到预渲染文件位置、批量读取、注入完整 head 标签、添加 canonical 链接。对于 65 个预渲染页面,AI 几分钟完成全部修复。


本次优化的实际效果

指标 优化前 优化后
关键路径资源 ~1,000KB(含 973KB 字体) ~77KB
页面标题 undefined-undefined 正常
结构化数据 4 种 Schema
预渲染页面 65 页空 head 完整 meta 标签
分类 URL 中文路径 拼音
移动端缩放 禁止 支持
对比度 多处不达标 WCAG AA
搜索引擎验证 未配置 Google + Baidu
sitemap 提交 未提交 两端提交

整个优化流程从诊断、编码、构建到验证,耗时约 2 小时——其中大部分时间是 AI 在执行,人工主要负责方向确认和审核。


AI 协作要点总结

人的职责

  • 提出目标和策略方向
  • 确认技术方案可行性
  • 审核代码安全性(Token 脱敏)
  • 最终决策与部署

AI 的职责

  • 全量文件扫描与问题定位
  • 代码编写与批量修改
  • 构建验证与错误排查
  • 重复性任务自动化

AI + 人协作的优势

  1. 效率:原本需要 2 天的工作量,约 2 小时完成
  2. 全面性:AI 扫描不会遗漏任何文件,比人工检查更彻底
  3. 可复现:相同的 SEO 策略可以快速应用到其他项目
  4. 低风险:纯文件操作,每一步都可以通过 Git diff 审查,出错可回滚
  5. 持续迭代:日常的内容更新、新增文章的 SEO 优化,都可以通过 AI 持续维护,无需每次都手动操作

结语

对于 Hexo 这类基于文件的静态站点,AI 几乎可以包办从建站到 SEO 优化的所有技术工作。人类只需要把控方向、审核结果、处理敏感信息——然后写好内容本身。

关键洞察是:技术栈的选择决定了 AI 的参与深度。Hexo 的纯文件架构让 AI 的全流程介入成为可能,而 WordPress 的数据库依赖则设定了参与上限。

如果你的站点也计划大量借助 AI 进行运营和维护,选对框架比学会某个工具更重要。在 AI 时代,”这个技术栈是否对 AI 友好”已经成为一个关键的选型考量因素。