AI 驱动增量同步 · 快速上手指南

引导式体验 · 理解工艺 · 感受好处
🎯 目标：15 分钟建立核心认知 👤 适用：新成员 / 文档工程师 / 决策者 📦 基于：Oxygen AI + DITA 增量同步工艺
核心思想
变更探测
差分翻译
合规校验
双版发布
①

核心思想：中文是唯一事实源，英文是受控镜像

建立心智模型

在开始操作之前，请先理解这条工艺的第一性原理——它决定了后续每一步为什么这样设计。

🇨🇳 中文 Master
唯一事实源
所有内容变更从这里发起
🪞 英文 en-US/
同构镜像投影
同名同 @id，逐点对齐
📐 元素级 Delta
不整篇重译
只翻“变更段”
🔑 Key 层统一
中英共用同一 Key
术语不漂移
📦 一次装配双版
同一脚本跑中/英
EV/ICE 正交分流
💡
你感受到的好处：不需要再维护两套“互相复制的孤岛”。中文改版后，英文只补差异，而不是重新翻译整本手册。这直接省掉 50% 以上的重复劳动。
②

变更探测：从 Git diff 到元素级变更集

让机器找人眼难扫的差异

中文 1.0 已经发布，现在 1.1 改了 3 个 topic。系统如何自动定位到具体哪些段落变了？

🔍 工艺机制

  • 打 tag：release/CN-1.0 → release/CN-1.1
  • 执行 git diff CN-1.0..CN-1.1 -- topics/*.dita 获得变更文件清单
  • Oxygen Compare 逐 topic 做 XML 元素级比对，输出精确到“段落/句子”的 delta 节点
  • 结果写入 en_mirror_mapping.csv，每行标记 up_to_date / changed_zh / new_en
🖱️ 试试点这个按钮，模拟一次变更探测：
$ git diff --name-only release/CN-1.0..release/CN-1.1 -- topics/ topics/peps_overview.dita topics/door_lock_operation.dita topics/charging_settings.dita $ oxygen-compare topics/peps_overview.dita CN-1.0 CN-1.1 [DELTA]

— 新增段落 [DELTA]

  • — 文本变更 [UNCHANGED] 其余 47 个节点 — 自动跳过 → en_mirror_mapping.csv 更新： peps_overview.dita, changed_zh, 2 delta nodes, pending_translation
    • 🎯
    你感受到的好处：不用人眼通读全文找差异。机器告诉你“就这 2 个节点变了”，翻译范围从整篇收窄到几段。
    ③

    差分翻译：只把“变更段”喂给 AI

    AI 增量 · 未变 CopyForward

    确定了 delta 之后，真正精彩的来了：只翻译变化的那几个节点，其余全部沿用 1.0 已定稿的英文。

    🤖 工艺机制

    • XSLT 抽取：delta_en_generator.xsl 将 delta 节点从中文 topic 中框选出来
    • AI 翻译：仅将 delta 节点送入 Oxygen AI action.translate.to.english，保留 DITA 标签与 Key
    • CopyForward：未变节点直接继承 en-US/topics/peps_overview.dita 中 1.0 的英文译文
    • 成果：英文 1.1 = 1.0 原文（94%）+ AI 只翻的 6% delta
    🖱️ 点一下，模拟“只翻 delta”的对比效果：
    ┌─ 变更段 1（新增段落）─────────────────────── 中文：本车型支持远程启动，通过手机 App 即可操作。 AI 英译：This model supports remote start via the mobile app. ┌─ 变更段 2（警告文本更新）─────────────────── 中文：请勿在充电时打开前舱盖。 AI 英译：Do not open the front hood while charging. ┌─ 未变内容（94%）──────────────────────── ✅ CopyForward 直接沿用 1.0 英文——零成本、零风险。 📊 成本对比： 整篇重译：~2,400 词，预计 4 小时人工 差分翻译：~120 词，AI 30 秒 + 10 分钟审校
    ⚡
    你感受到的好处：翻译成本与“变更量”成正比，而不是与“文档总量”成正比。1.1 的英文版成本 ≈ 只翻 6% 内容，同时保证未变部分零风险沿用。
    ④

    合规校验：术语不漂移 + XML 合法性

    保存前强制门禁

    AI 翻译完成后，不能直接发版。系统在保存前执行两道自动门禁，确保英文版与中文版同样“干净”。

    🛡️ 自动检查项

    • 术语 Key 校验：英文中每个 term/keyref 必须与中文版对应同一 Key，且英译词必须取自 keydef-termbase.ditamap 的唯一术语源
    • XML Well-formed 校验：所有 tag 闭合、属性合法、@id 与中文一致
    • 受控属性校验：product / trim / region 等属性值符合 subjectscheme 定义
    • 任何不过的项 → 阻断保存 → 弹出修复建议
    🖱️ 模拟执行合规检查：
    [CHECK 1/4] Term Key 一致性 ......... ✅ PASS - "remote_start" 中英同 Key，英译词取自 termbase ✓ [CHECK 2/4] XML Well-formed ......... ✅ PASS - 所有 tag 闭合，无孤立节点 ✓ [CHECK 3/4] 受控属性值 ............... ✅ PASS - product="pt-bev" trim="high" region="cn" ✓ [CHECK 4/4] Delta 标记一致性 ......... ✅ PASS - 仅 2 个 delta 节点有 data-delta-translate 标记 ✓ 📋 结论：全部通过，允许写入 en-US/ 并进入发布队列。
    🔒
    你感受到的好处：术语不漂移、XML 不残缺、属性不错乱——这些问题在保存前就被拦住，而不是等到客户拿到 PDF 才发现英文把“EV”写成了“ICE”。
    ⑤

    双版发布：一次装配，中英同窗产出

    闭环最后一公里

    所有 topic 就位并通过校验后，中、英两个装配册共用同一个 Key 层和同一套发布脚本，分别产出各自 PDF/HTML。

    📦 发布装配结构

    • 中文：h2_user_manual_keys_fuel.ditamap —— 引用中文 topics + Key 层
    • 英文：en-US/h2_user_manual_keys_fuel_en.ditamap —— 引用英文镜像 topics + 同一个 Key 层
    • DITA OT 发布命令基本相同，仅修改 args.input 与 args.xml.lang
    • 发布完成后打 release/EN-1.1 tag，回写 csv 版本列，闭环。
    🖱️ 模拟执行双版发布：
    [CN] h2_user_manual_keys_fuel.ditamap → 输出：PDF_CN_1.1.pdf (48 topics) [EN] h2_user_manual_keys_fuel_en.ditamap → 输出：PDF_EN_1.1.pdf (48 topics) 📊 发布统计： 中文版：48 topics / 312 页 / 6.8 MB 英文版：48 topics / 305 页 / 6.5 MB 英文版中 47 topics 为 CopyForward（1.0 原译文），仅 1 topic 含 delta 更新。 ✅ 发布完成 → 打 tag release/EN-1.1 → 回写版本闭环。
    🏁
    你感受到的好处：中英文版同步产出，不会再出现“中文已经 1.1 了，英文还停在 1.0”的尴尬。市场窗口不错过，客户拿到的永远是配对版本。

    © 2026 镭内容出色中心 · AI 驱动中英文增量同步工艺 · 快速上手指南 v1.0