背景
个人技术博客站 hydeh.com 基于 Hexo 框架搭建。在本次 SEO 优化中全程使用 Codex CLI(AI 编程助手) 以对话协作的方式完成。
本文重点不仅在于具体修复了什么,更在于——选择正确的技术栈,决定了 AI 能帮你做到什么程度。
Hexo vs WordPress:AI 协作场景下的框架选择
在开始 SEO 工作之前,必须要理解:不同的框架对 AI 的”友好程度”天差地别。以下对比基于同一个任务——让 AI 帮你的网站做 SEO 优化:
| 维度 | 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 配置
需要做:
- 每页设置唯一的
title、description、keywords - 配置
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 + 人协作的优势
- 效率:原本需要 2 天的工作量,约 2 小时完成
- 全面性:AI 扫描不会遗漏任何文件,比人工检查更彻底
- 可复现:相同的 SEO 策略可以快速应用到其他项目
- 低风险:纯文件操作,每一步都可以通过 Git diff 审查,出错可回滚
- 持续迭代:日常的内容更新、新增文章的 SEO 优化,都可以通过 AI 持续维护,无需每次都手动操作
结语
对于 Hexo 这类基于文件的静态站点,AI 几乎可以包办从建站到 SEO 优化的所有技术工作。人类只需要把控方向、审核结果、处理敏感信息——然后写好内容本身。
关键洞察是:技术栈的选择决定了 AI 的参与深度。Hexo 的纯文件架构让 AI 的全流程介入成为可能,而 WordPress 的数据库依赖则设定了参与上限。
如果你的站点也计划大量借助 AI 进行运营和维护,选对框架比学会某个工具更重要。在 AI 时代,”这个技术栈是否对 AI 友好”已经成为一个关键的选型考量因素。