双语内容生产：zh 主稿、en 改写与一致性核对

双语知识库有一个隐蔽的成本结构：每篇文章其实是两篇——zh 版与 en 版共享事实，但面向完全不同的读者与搜索引擎。把 en 版当成 zh 版的翻译，是最常见也最昂贵的起点错误。本文给出 GPTMap 在双语生产上的完整流程：哪些字段共享、哪些独立、内链为什么必须用目标语言标题、en 稿长度超限的系统性解法，以及收尾的三重核对。规则均来自本站 80 篇双语文章的实际生产（2026-09-04 核对）。

1. 定位：en 是改写，不是翻译

翻译思维产出的是"zh 句子的英语对应物"；改写思维产出的是"同一组事实的英语表达"。两者的差异集中在三处：

• SEO 字段完全重造：seoTitle、seoDescription、keywords 按英语用户的搜索词与长度习惯独立撰写，不是 zh 字段的译码；
• 案例与引用本地化：面向 en 读者引用的案例、对比对象、背景铺垫可以不同，只要事实数字同源；
• 信息密度不同：同一事实，en 表述普遍更长（见第 4 节），结构上要主动压缩而非逐点对应。

不变的只有事实本身：每个数字、日期、版本号、引用 URL 在两个语言版中必须严格一致——这也是收尾核对的重点。

2. 字段二分：共享与独立

以本站 frontmatter 为例，字段分成两组：

# 双语 frontmatter 对照示意（同一篇文章的两个语言版）
slug:            mcp-oauth-2-1          ← 共享
category:        mcp                    ← 共享
publishedAt:     2026-09-03             ← 共享
title (zh):      MCP 授权机制拆解：…      ← 独立
title (en):      MCP Authorization Explained: …   ← 独立
tldr (zh/en):    事实一致、语言与长度各自达标
officialReferences: URL 列表一致          ← 共享（title 文本可各语言）

3. 内链一致性：目标语言标题逐字比对

双语内链有两条对称的规则：

1. zh 文章内链另一篇文章时，链接文本 = 目标文件 zh 版的 title，用《》包裹全称；
2. en 文章内链时，链接文本 = 目标文件 en 版的 title，不加书名号。

en 链接最危险的坑是拿 zh 标题翻译充当——两版标题本就不同（zh 的"完全指南"与 en 的 "complete guide" 措辞、结构、标点各异），任何"翻译式链接文本"都会与目标页 H1 失配。解法是脚本化逐字比对：提取每条内链的文本与目标文件 title 对照，不一致即报错。本站此规则已脚本化，zh 与 en 各跑一遍。

4. 语言特有陷阱

zh 稿的陷阱：frontmatter 双引号值内的英文双引号会打碎 YAML 解析（报错信息隐晦，见第 3 节经验）；全角引号（''""）无此问题，行文可放心用。

en 稿的陷阱：长度超限是系统性而非偶发的——同样信息 en 字符量普遍多 30%-100%（经验值），seoTitle ≤60 与 tldr ≤400 的上限几乎必然触发。系统性解法是"候选择优"：

# en 字段收紧：准备递减候选，长度断言自动择优（写作流程中的真实做法）
candidates = [long_draft, trimmed_v2, trimmed_v3]
value = next(c for c in candidates if len(c) <= 400)

配合两条手艺：第一轮收紧改结构（删修饰从句、合并子句、砍并列），第二轮才砍内容点；不要一上来删事实——事实删了就没有了。

撇号：en 稿注意直（'）曲（'）撇号统一；引用他人原话带曲撇号时，字段值的双引号包裹不受影响，但复制进代码块时会带入不可见差异。

5. 收尾三核对

每对文章写完、每批封板前，三件事必须脚本化过一遍：

1. 双语 frontmatter parity：身份字段逐字段相等；措辞字段条数相等（keyPoints / faqs / officialReferences 的条目数 zh = en）；
2. 内链标题逐字比对：zh 与 en 各跑一遍比对脚本（见第 3 节）；
3. 自指统计收尾值：批次会改变"本站共 N 篇"这类数字——全部文件写完后重跑命令，用最终值落笔（本篇写作当日为 80 篇）。

# 内链标题逐字比对（收尾第 2 项的脚本化形态）
python3 - <<'PYEOF'
import re, glob, os
titles = {f[:-6]: re.search(r'^title: "(.*)"', open(f, encoding='utf-8').read(), re.M).group(1)
          for f in glob.glob('*.zh.md')}
# …对每条内链：链接文本与目标 title 逐字比对，不一致即报错
PYEOF

6. 常见错误与排查

• en 标题直译 zh 标题：产出英语读者不会搜索的 seoTitle，且与 en 内链体系对不上。
• 只改 zh 忘了 en：事实修订只落在 zh 版，en 版带着旧数字上线。修订必须双版本同步，收尾 parity 核对兜底。
• en 超限字段反复手数：字符数靠感觉必错，交给长度断言自动择优。
• tags 直译：zh 的"模型对比"直译成 "model comparison" 不一定是 en 用户的搜索词——tags 按语言独立拟。
• 内链只在 zh 里补：新增回链时只改了 zh 版，en 版漏加——parity 核对时把内链数量也纳入比对。

7. 下一步

• 事实层面的核验流程（双语共用的上游）：《来源核验与对源复审：AI 内容的事实核查流程》。
• 与本流程配套的一致性管理：《多作者知识库的设定一致性：world-state 模式》。
• 双语流程的完整清单视图：《GPTMap 编辑手册：写一篇高质量 OpenAI 文章的 12 步清单》。