洞察
本地化一致性：AI Agent 应如何翻译网站
Locale parity（本地化一致性）是区分一个网站只是被翻译，还是已经被本地化的标准。如果 AI 编码 Agent 要负责多语言工作，它需要的是这套标准，而不是一句“把网站翻译成西班牙语”的提示词。
一句话测试：对于每一个有意上线的语言版本，真人和爬虫都应该体验到源语言的连贯孪生版本：同样的待办任务页面、正确的语言信号、适配后的搜索语言、完整的结构，以及没有发生漂移的证据。
大多数团队止步于字符串。Agent 会让这个失败更快发生。本文端到端定义本地化一致性，并说明 Agent 应该如何翻译网站而不破坏 SEO。
为什么“翻译过”的网站仍然失败
在 en.json 旁边发布一个 zh.json 会让人感觉任务完成了。用户和 Google 不会同意。
常见失败模式：
- 缺少孪生页面。 英文有
/pricing；中文 404。Hreflang 指向不存在的页面。 - “本地化”页面上仍有英文界面。 导航、Cookie 或 CTA 仍然写着 Book a call，而 hero 区已经是中文。
- 文档语言错误。 每个语言版本都用
<html lang="en">；og:locale停留在en_US。 - 抓取身份损坏。 两个 sitemap 入口、相对 hreflang，或者在 noindex 占位页上输出 hreflang。
- 直译关键词。 法语加拿大页面的标题是英文直译，错过了当地人真实的搜索方式。
- 结构漂移。 德语里丢了
{name}占位符；阿拉伯语没有dir="rtl"；schema 的inLanguage与 URL 矛盾。
翻译覆盖率可以显示为绿色，而本地化一致性仍然是红色。键计数器抓不到模板漂移、SERP 语言或互相对应的 alternate。
狭义的“一致性”工具已经覆盖了其中一些部分，比如目录键差异，或针对货币和电话 schema 的国际化信号检查。有用，但不完整。本地化一致性才是 Agent 驱动的网站本地化应达到的完整标准。
如果没有标准，为什么 AI Agent 会让问题更糟
编码 Agent 很擅长快速产生大规模 diff。这恰恰就是风险所在。
如果没有工作手册，Agent 往往会：
- 一次性机器翻译所有字符串。
- 用词典把英文标题复制到其他语言版本。
- “出于好意”添加
Accept-Languagemiddleware。 - 为包括
/404和草稿在内的每条路径输出 hreflang。 - 因为 TypeScript 构建仍然通过，就跳过验证。
没有完成定义的速度会制造看起来像进展的多语言债务。本地化一致性就是那条完成定义。
如果你想要这套工作手册的打包版本，包括清单、翻译指南和离线 HTML 检查器，可以获取免费的 MIT i18n Agent GitHub package，并克隆到 Cursor 或 Claude Code。
本地化一致性的五层
| 层 | 它回答的问题 | 失败时的样子 |
|---|---|---|
| 路由与内容 | 有意上线的页面是否作为孪生版本存在？ | 软 404、孤立的英文链接、不完整的赚钱页面集合 |
| 文档与抓取 | 爬虫是否信任这个语言集群？ | 错误的 lang、损坏的 hreflang、双 sitemap |
| 语义 | 文案是否符合该市场的语言和搜索方式？ | 生硬直译、语气错位、未使用的本地查询 |
| 结构 | 这个孪生版本是否仍然能正常工作？ | 丢失占位符、缺少复数形式、LTR 阿拉伯语、错误的 schema URL |
| 验证 | 回归能否让构建失败？ | 下一个 Agent PR 之后静默漂移 |
1. 路由与内容一致
先决定每个语言版本中哪些页面是有意上线的：赚钱页面、insights、法律页面、工具。默认语言不加前缀，或所有语言都加前缀；选择一种策略并保持一致。
Agent 应遵守的规则：
- 为每个语言版本构建相同的有意路由树；如果某个页面确实不存在，就不要把它放进 hreflang。
- 内部链接保持在当前语言内（中文页面使用
/zh/about，而不是/about）。 - 对孪生页面应用相同的 noindex 策略（
/coffee、占位页、Agent markdown 镜像）。 - 优先使用稳定 slug，让 alternate 映射保持清晰。
内容集合（MDX/Markdown）、部门数据文件和 UI 界面文案是彼此独立的翻译层。Agent 必须盘点全部三层，而不只是 messages/*.json。
2. 文档与抓取一致
这是多语言 SEO 的基本卫生。做错了，Google 就不会信任这个集群。
每个可索引语言 URL 的最低信号：
- 指向自身的绝对 canonical
- 匹配的
og:url - 本地化的标题和描述
- 来自语言注册表的
<html lang>与dir（适当使用 BCP47） - 互相对应的
hreflang集合，使用 BCP47 代码（fr-CA、zh-CN），并带有指向默认语言 URL 的x-default - noindex 页面上不要输出 hreflang（或
og:locale:alternate） - 一个公开 sitemap 入口，其 xhtml alternate 与
<head>保持一致 - 结构化数据使用正确的
inLanguage和符合语言版本的实体 URL
反模式：Geo-IP 强制重定向、双 sitemap 身份、相对 hreflang、发明不在注册表中的 locale 代码。
3. 语义一致
语义一致是本地化不再只是替换字符串的地方。
Agent 应该：
- 维护一份术语表（产品名、锁定 URL、不得翻译的术语）。
- 遵循每个市场的风格指南（加拿大法语 ≠ 法国法语；中性拉美西语 ≠ 只适用于西班牙的习语）。
- 为本地 SERP 适配关键词，每个 URL 一个主要意图，而不是逐字翻译英文关键词地图。
- 为本地清晰度和 CTR 重写 H1、标题和 meta；保持品牌实体一致。
- 拒绝会在 Search Console 中变成软 404 的浅薄机器翻译。
语义一致也是 AI 搜索所奖励的：用用户语言呈现清晰实体和答案，而不是在西语 URL 下放英文段落。
4. 结构一致
渲染出垃圾内容的孪生页面不是孪生页面。
检查：
- 插值 / ICU 占位符与源语言匹配（
{count}、<0>…</0>标签）。 - 复数和 select 分支满足目标语言的需要（CLDR），而不是照抄英文形式。
- RTL 语言获得
dir="rtl"和可读字体；CJK 使用合适的排版。 - 显示日期、数字和货币时使用感知语言环境的格式化。
- JSON-LD 不要在每个页面硬编码英文路径或
en语言。
只检查目录的一致性脚本在这里有帮助。它们必要但不充分；要搭配对 dist/ 中 HTML 和 schema 的检查。
5. 验证一致
如果 Agent 可以在没有证据的情况下合并，漂移就一定会发生。
验证一致意味着：
- 对生成 HTML 的构建期闸门：标题、描述、H1、canonical、
og:url、lang、hreflang 完整性、noindex 规则。 - 语言版本清单测试：每个有意上线的赚钱页面都存在于每个 live 语言版本中（或被明确排除）。
- 部署后的生产抽查：线上 head 标签、sitemap 身份、analytics
page_locale、RTL 样本。 - Agent 可读报告，让下一次运行修复发现的问题，而不是盲目重新翻译。
Rank & Beyond 在自己的多语言网站上运行这一类检查。可复用的技能包把同样的纪律编码进其他仓库。
Agent 反模式（不要上线这些）
| 反模式 | 为什么有害 |
|---|---|
Geo-IP 或 Accept-Language 硬重定向 |
缓存碎片化、爬虫困惑、用户被困住 |
| 在 noindex / 404 / 草稿上输出 hreflang | 污染语言集群 |
| 双 sitemap 入口 | 拆分抓取身份 |
| 把英文关键词直译当作“本地化” | 错过本地需求语言 |
| 没有术语表的一次性机器翻译转储 | 语气和产品术语漂移 |
| 翻译锁定品牌或预约 URL | 破坏转化和信任 |
| 没有路由孪生就宣布某语言 live | hreflang 指向 404 |
当 Agent 为了“方便”提出其中任何一种做法时，拒绝这项变更。
AI Agent 应如何翻译网站
把本地化当作分阶段的工程工作流，而不是单条提示词。
阶段 A — 发现
- 检测框架、路由、i18n 库和内容来源。
- 盘点当前语言版本、默认语言和 URL 策略。
- 区分赚钱页面、insights/blog、法律内容和 noindex 工具页。
- 记录不得被发明的锁定外部 ID（预约链接、analytics ID）。
阶段 B — 计划
- 编写或更新语言注册表（代码、标签、
htmlLang、dir、OG locale、BCP47）。 - 设定市场优先级（先加深主要市场，再扩展每个 spoke × 每个语言版本）。
- 起草每个语言版本的关键词地图，使用适配查询，而不是英文直译。
- 标记风险：RTL、CJK、法律文案、薄页面。
阶段 C — 实施技术 SEO
- 接入 helper：
localizePath、alternatePath、locale-from-pathname。 - 输出 canonical、OG、hreflang、sitemap i18n、schema URL。
- 在 UI 中保留语言选择；不要强制重定向。
- 对齐
robots.txt、sitemap URL 和 Agent 索引（llms.txt、agent.json）。
阶段 D — 翻译与创译
- 将 UI 界面文案、结构化数据文案和长篇内容作为不同轮次本地化。
- 应用术语表和风格指南；为 SERP 语言适配标题和 meta。
- 保留代码、占位符和锁定字符串。
- 对优先市场的 H1、title、meta 和 FAQ 优先进行人工审核。
阶段 E — 验证
- 在
dist/或 URL 列表上运行 HTML auditor。 - 对缺失 hreflang、lang 不匹配、og/canonical 漂移、noindex alternate 等问题让 CI 失败。
- 部署后抽查生产环境。
- 记录剩余内容中哪些是有意债务，哪些是阻塞项。
这就是作为运行循环的本地化一致性。只做阶段 D 的 Agent 是翻译器。完成 A–E 的 Agent 才是本地化执行者。
可以粘贴到 PR 的实用清单
把它作为任何多语言 PR 的完成定义：
- 语言注册表是代码和
dir的唯一事实来源 - 每个 live 语言版本都有有意上线的路由（或 alternate 省略缺失页面）
- 内部链接保持在当前语言内；非英文页面没有意外英文泄漏
- 每个可索引孪生页面上 canonical ===
og:url - 只在可索引页面输出完整互相对应的 BCP47 hreflang +
x-default - 标题/描述已本地化且唯一；关键词已适配而非直译
- 占位符/复数/RTL/schema 结构完整
- 只有一个 sitemap 入口；noindex 路由被排除
- 构建闸门会在回归时失败
- 至少完成一个非英文赚钱页面的生产抽查
获取 i18n Agent GitHub package
如果你希望 Agent 默认遵循这套工作手册，安装技能包，而不是每个 sprint 重新发明清单。
获取免费的 MIT i18n Agent package —— 打开公开 GitHub 仓库，克隆到 Cursor 或 Claude Code，并让 AGENTS.md / CLAUDE.md 指向 SKILL.md。
其中包含：分阶段 Agent 工作流、多语言 SEO 清单、翻译工作手册，以及用于检查 hreflang、canonical/og:url、lang 不匹配和 noindex alternate 错误的离线 Python 检查器。
对于需要更广泛营收系统的创始人，而不只是本地化，请了解 BeyondOS™，以及 Website、SEO 和 Content 部门如何在同一个计划下共享记忆。
本地化一致性 FAQ
本地化一致性只适用于 SEO 吗？
不。SEO 是抓取层。本地化一致性还覆盖 UX 完整性、结构完整性和 CI 证明。一个站点可以在翻译后的查询上排名，同时仍因为 RTL、CTA 或占位符错误而让用户失败。
第一天就需要每篇 insight 都有每种语言版本吗？
不需要。需求不清晰时可以先发布英文 spoke；对赢家内容再本地化优先市场（例如先加拿大法语，再西班牙语）；其他语言只为明确赢家或既有一致性维护。没有有意上线的页面时，绝不要在 hreflang 中宣布某语言 live。
一个 Agent 提示词能取代 TMS 吗？
对许多产品营销网站来说，一个拥有严格工作手册、术语表和 CI 闸门的 Agent 已经足够，尤其是当翻译保存在仓库中时。对于有大量人工译者的大型持续项目，TMS 仍然有帮助。无论采用哪种方式，本地化一致性都是质量门槛。
最快的开始方式是什么？
盘点语言版本和赚钱页面，修正文档/抓取信号，然后用适配后的 SERP 文案翻译界面和最高优先级 URL。安装 i18n Agent package，让下一次 Agent 运行先审计，再重写。