Codex Sites：把站点上下文交给 Codex 前要注意什么

适用场景

这篇手册适合希望让 Codex 理解网站、文档站或内部站点上下文的用户。对内容站来说，站点上下文能帮助 Codex 理解栏目、URL、设计规范和发布边界。

OpenAI 官方 Sites 页面介绍了相关能力。具体使用入口以当前官方文档为准。

步骤 1：先确定站点用途

站点类型不同，给 Codex 的上下文也不同。

常见类型：

• 文档站。
• 产品官网。
• 内部运营后台。
• 博客或资讯站。
• API 参考站。

例如当前项目是中文 Codex 资讯与教程站，重点是内容结构、SEO、文章来源和阅读体验。

步骤 2：整理站点规则

建议写清：

• URL 结构。
• 栏目分类。
• SEO 要求。
• 图片规则。
• 内容来源。
• 发布流程。
• 不要修改的 slug。

这些规则最好放进 AGENTS.md 或 docs/design-system.md。

步骤 3：提供真实页面或截图

如果任务涉及视觉判断，应使用真实页面或官方截图。

不要使用：

• 抽象概念图。
• AI 生成示意图。
• 非产品截图。
• 无关风格参考。

对教程内容，截图应来自真实软件界面；没有合适截图时可以无图发布。

步骤 4：把站点验证写清楚

常见验证：

• next build。
• sitemap 生成。
• RSS 生成。
• 搜索接口。
• 移动端布局。
• 图片路径是否存在。

给 Codex 任务时直接说明验证命令。

步骤 5：保护内部内容

如果站点包含内部页面，要注意：

• 不暴露账号。
• 不暴露 token。
• 不暴露客户数据。
• 不把内部 URL 写进公开文章。
• 截图前遮挡敏感信息。

常见错误

不要让 Codex 只凭营销描述猜网站结构。

不要用概念图替代真实截图。

不要忽略移动端和 SEO。

不要把内部页面内容发布到公开站点。

小结

Codex Sites 的价值是让 Codex 更懂站点上下文。要用好它，需要整理站点规则、提供真实页面或截图、明确验证方式，并保护内部内容。