分步迁移

稳妥的迁移方式是循序渐进。在您于开发环境中连接并检查每个部分的同时，公开网站继续保持原样运行。

保证安全的规则

• 设计不得改变。 无论 Atlas 是否有对应内容，每个页面看起来都必须完全一致。
• 必须有回退。 如果 Atlas 无法访问，或某个页面没有已发布的内容，站点就提供其内置内容。
• 只用文本，不用 HTML。 CMS 的值以文本形式或通过您的组件渲染。
• 先在开发环境。 在发布版本通过检查并经人员批准之前，任何内容都不会进入生产环境。

阶段 1：连接一个页面（约一天）

1. 在 Studio 中创建站点，并起草一份只含一种页面类型的最小契约。
2. 按照连接 Next.js 网站操作。
3. 在开发环境中发布这一个页面，并与线上页面进行对比。

完成标准：该页面从 Atlas 渲染、外观相同，并且在关闭 Atlas 的情况下仍能正常工作。

阶段 2：为整个站点建模

1. 列出站点提供的每个路由，并将每个路由对应到一种页面类型。
2. 编写契约包：带类型化字段的组件、带区域的页面类型、集合、媒体配置以及页眉和页脚全局内容。将它作为 atlas/contract.bundle.json 保存在您的代码仓库中。
3. 验证并提出它。站点管理员在 Studio 中将其激活（Site setup）。
4. 重构每个页面组件，使内容的顺序和内容本身由 Atlas 区块决定，并以内置数据作为回退。

完成标准：Studio 显示网站与当前生效的契约保持同步（In sync with the active contract）。

阶段 3：迁移内容和图片

1. 使用正确的媒体配置上传图片。切勿拉伸或放大；请列出不符合要求的图片。
2. 为每个重复项创建条目，按资源 id 引用图片，并填写替代文本。
3. 用现有内容填写页眉和页脚全局内容。
4. 根据页面类型为每个路由创建页面，并调整其区块，直到草稿与现有页面一致。
5. 起草译文，并请母语人员审阅。

通过 MCP 连接的 AI 编程智能体可以将其中大部分工作以草稿形式完成。由人员使用 Preview on website 检查每个页面并发布。

阶段 4：刷新、SEO 和重定向

• 添加 Webhook 接收端，使发布后站点在数秒内更新。
• 从交付 API 读取 SEO 标题、描述和 noindex，并基于 /routes 构建站点地图。
• 加载 /redirects 并应用它们，使旧 URL 保持其排名。

阶段 5：上线

1. 培训编辑人员使用 Studio、草稿、预览和发布。
2. 构建一个发布版本。Atlas 会检查契约是否同步、是否存在发布问题、网站是否健康以及备份是否为近期备份。
3. 由具有审批权限的人员批准。站点管理员开启生产环境，然后您创建一个生产环境交付令牌。
4. 使用生产环境令牌部署您的网站。保持回退功能不变。

生产环境提供什么

生产环境提供其线上发布版本中的内容、表单、聊天机器人和搜索设置。预览仍然仅限开发环境。请按照上线中的确切步骤操作。

回滚

• 内容错误：回滚到较早的修订版本，或较早的生产环境发布版本。
• 代码错误：重新部署您之前的网站构建，与您现在的做法相同。
• Atlas 不可用：回退机制会提供内置内容，直到 Atlas 恢复。