本案例演示如何通过 Codex 优化现有站点的 SEO 结构,包括 TDK 元标签优化、Sitemap 生成及搜索引擎友好度提升。

1. 任务背景

一个刚上线的静态教程站,首页内容已初步完成,但搜索引擎抓取效果不佳:标题过短、缺失 Description、且没有 Sitemap 供爬虫索引。

2. 第一步:SEO 现状只读分析

在修改前,先让 Codex 评估当前页面的 SEO 水平。

Prompt 示例:

``text

请先只读分析当前项目首页文件(如 docs/index.md),不要修改。

请评估:

  1. 当前的 Title, Description, Keywords (TDK) 是否完整。
  2. 2. 页面 H1, H2 标题层级是否合理。

    3. 图片是否有 alt 属性。

    4. 项目中是否已配置 sitemap 生成工具。

    `

    3. 第二步:制定 SEO 优化计划

    根据分析结果,给 Codex 下达具体的结构化指令。

    Prompt 示例:

    `text

    请帮我优化首页的 SEO 结构。

    目标:

    1. 优化 TDK 元标签:Title 设置为“Codex 喂饭级教程 | 面向中文开发者的 AI 编程指南”,Description 包含核心关键词。
    2. 2. 确保首页有且仅有一个 H1 标签。

      3. 为首页所有 image 标签补充描述性的 alt 属性。

      4. 在项目中配置 sitemap 生成插件(如果是 VitePress,请修改 config.mjs)。

      限制:

      1. 只修改首页文件和全局配置文件,不要动具体的教程内容页。
      2. 2. 严禁引入不兼容的第三方 SEO 插件。

        `

        4. 第三步:生成与验证 Sitemap

        对于静态站点,Sitemap 的自动化生成是关键。

        Prompt 示例:

        `text

        请为我的 VitePress 项目配置 sitemap 插件。

        1. 检查 package.json 是否有 vite-plugin-sitemap 或类似依赖。
        2. 2. 如果没有,请先告诉我需要执行的安装命令。

          3. 如果已有,请在 config.mjs 中配置生成逻辑,确保生成的 URL 包含正确的 hostname。

          `

          5. 结果验收

          • 查看构建后的 dist 目录,确认是否存在 sitemap.xmlrobots.txt
          • 使用浏览器开发者工具查看首页源码,确认 <code> 和 </code><meta name="description">` 已更新。</li> </ul> <p>---</p> <p><strong>下一篇推荐</strong>:<a href="/tutorial/cases/write-readme.html">实战案例:让 Codex 补 README 或使用说明</a> —— 提升项目文档的专业度与易读性。</p> <p></TutorialIntegration></p> </div> </div> </article> <nav class="article-nav"> <a href="/tutorial/cases/release-notes.html" class="article-nav-item article-nav-prev"> <span class="article-nav-label">上一篇</span> <span class="article-nav-title">实战案例:利用 Codex 自动生成版本发布说明</span> </a> <a href="/tutorial/cases/spring-boot-api.html" class="article-nav-item article-nav-next"> <span class="article-nav-label">下一篇</span> <span class="article-nav-title">实战案例:利用 Codex 新增 Spring Boot 接口</span> </a> </nav> </div> </section> </main> <footer class="footer"> <div class="container footer-grid"> <div class="footer-about"> <div class="footer-title">AI教程网</div> <p class="footer-desc">AI教程网(aijcw.cc)是专业的AI人工智能教程与资讯平台,提供ChatGPT教程、DeepSeek应用指南、Midjourney绘画技巧、Stable Diffusion入门等热门AI工具教程与最新AI资讯。</p> </div> <div> <h4 class="footer-heading">分类</h4> <div class="footer-links"> <a href="/category/教程/index.html" class="footer-link">教程</a> <a href="/category/专题/index.html" class="footer-link">专题</a> <a href="/token/index.html" class="footer-link">Token</a> </div> </div> <div> <h4 class="footer-heading">工具教程</h4> <div class="footer-links"> <a href="/tutorials.html" class="footer-link">全部教程</a> <a href="/tutorial/codex/codex-tutorial.html" class="footer-link">ChatGPT (Codex)</a> <a href="/tutorial/claude-code/claude-code-tutorial.html" class="footer-link">Claude Code</a> <a href="/tutorial/opencode/opencode-tutorial.html" class="footer-link">OpenCode</a> </div> </div> <div> <h4 class="footer-heading">链接</h4> <div class="footer-links"> <a href="/tags.html" class="footer-link">标签</a> <a href="/about.html" class="footer-link">关于</a> <a href="/sitemap.xml" class="footer-link">网站地图</a> </div> </div> </div> <div class="container footer-bottom"> <p>AI教程网|AI资讯网 aijcw.cc - 专业AI教程与资讯平台</p> </div> </footer> <script charset="UTF-8" id="LA_COLLECT" src="//sdk.51.la/js-sdk-pro.min.js"></script> <script>LA.init({id:"3PyVGnBLYtw1XgDX",ck:"3PyVGnBLYtw1XgDX"})</script> </body> </html>