选择项目配置文件
确认中文仓库、英文仓库、手册和基线标签。
预期 · 配置文件 通过预检
00 / 先读这一页
这是一张时间 × 分工的操作图
它按时间排列，说明每个阶段由谁负责、做什么、完成后看到什么。右侧可横向滚动。
输入
中文仓库 与 英文仓库；各自的基线标签；项目/手册；配置文件 文件。
执行
DeltaRepo.exe 依次列出改动、翻译、自动检查、提交；不生成过程脚本。
输出
英文增量分支、改动清单、合并对比、检查报告；人工发起合并请求后发布。
ACT 动作预期结果门禁/阶段
第一次读：00 → 01 → 03；评审时看：02 → 04 → 05；出问题时：06。
00a / 术语
先认识几个词
| 词 | 在这里指什么 |
|---|---|
| 仓库 | 存放受版本控制的项目文件的目录。 |
| 基线 | 已确认、不再随意改动的版本。 |
| 增量 | 两个基线之间发生变化的段落、表格或图片说明。 |
| 配置文件 | 写明中英文仓库、版本标签、内容路径和输出分支的文件。 |
| 改动清单 | 本次需要处理的变更主题列表。 |
| 自动检查 | 提交前检查引用、结构、版本和未改动内容是否一致。 |
| 试运行 | 不调用真实翻译服务，只验证输入、输出和检查流程。 |
| 分支 | 从基线拉出的独立工作线，用于提交本次结果。 |
| 合并请求 | 请求把分支合入主线的评审入口。 |
| 发布标签 | 合并后给版本打上的固定标记。 |
| 工作副本 | 处理过程中生成的副本，不是源文件。 |
01 / 时间轴
工作流阶段定义
T0准备选择 配置文件
T1冻结基线中英文基线标签
T2中文升级CN 新版本
T3生成改动清单git diff
T4增量翻译Delta run
T5门禁复核gate + review
T6英文分支提交
T7合并发布合并请求 / 标签
02 / 分工图
分工：谁在什么时候做什么
横向是时间，纵向是角色。空白格表示该角色在这个阶段不介入。
角色 / 阶段ROLE / TIME
T0
准备
准备
T1
冻结
冻结
T2
中文升级
中文升级
T3
计划
计划
T4
翻译
翻译
T5
复核
复核
T6
英文分支
英文分支
T7
合并发布
合并发布
本地化负责人选择 配置文件 / 批准
批准进入英文分支
看改动清单、检查结果、差异和遗留问题，确认可提交。
预期 · 审批记录
Git / 发布管理员标签、分支、合并
冻结中英文基线
确认两个仓库的基线标签，不移动已发布标签。
预期 · 中英文基线可复现
创建英文增量分支
从英文基线创建 l10n 分支，提交通过检查的主题文件。
预期 · 英文分支 + 提交
合并请求 / 合并 / 版本标签
推送分支，发起合并请求，合并后创建英文版本标签。
预期 · 合并记录 + 标签
中文文档工程师中文内容与版本
提交中文升级
只改目标段落/表格，更新版本载体，提交 CN 新标签（中文编辑在 Oxygen 中完成）。
预期 · release/CN 新版本
Delta 执行器AI / 离线翻译
生成变更计划
比较两个 CN 标签，只列出有变更的主题文件。
预期 · 改动清单
执行增量翻译
只翻译变更节点，合并进冻结 EN，跑六项检查。
预期 · 检查通过 / 英文增量
英文审校 / 评审内容确认
审阅增量与门禁
在 Oxygen 中查看改动内容、合并对比和报告；确认未变英文未动。
预期 · 审阅记录
研发 / 专家技术事实
确认技术变更
确认中文新增/修改内容的技术事实和适用条件。
预期 · 内容确认记录
确认英文技术含义
只确认技术含义，不替翻译做语言审校。
预期 · 技术确认
客户支持 / 发布使用与反馈
使用发布版本
按客户/型号使用英文版，把问题反馈到下一轮。
预期 · 发布 + 反馈
门禁 / 结果
G0 配置仓库/标签/入口文件齐全
G1 基线中英文标签可复现
G2 变更只含目标文件
G3 计划变更主题明确
G4 翻译检查通过 / 还原一致
G5 复核审校批准
G6 分支提交可追溯
G7 发布合并请求 / 版本标签
横向滚动可查看全部阶段；移动端不压缩泳道，保持角色与时间的对应关系。
03 / 逐项说明
每个动作的做法与结果
0.1
选择配置文件
告诉工具中文仓库、英文仓库、手册入口文件和两个基线标签。工具按配置文件匹配，不会自己去磁盘找仓库。
完成后：预检通过；有缺项时停止。
1.1
确认基线
检查中文基线、英文基线两个版本标签都存在。工具只读取标签，不读取工作区里未提交的内容。
完成后：中文和英文基线都能重复取得。
2.1 / 2.2
中文升级
中文文档工程师只改目标段落或表格；研发确认技术内容；提交并打中文新标签。
完成后：两个中文标签之间的差异只包含目标内容。
3.1
生成改动清单
运行 DeltaRepo.exe --profile 配置文件 --mode plan。只列出有改动的主题文件，不翻译。
完成后：清单中的文件数量与版本差异一致。
4.1
翻译改动部分
运行 --mode run --no-ai 先做试运行；正式翻译需要配置试用密钥或额度代理。
完成后：每篇文件检查通过，还原一致，改动范围符合要求。
5.1 / 5.2 / 5.3
复核与批准
英文审校看改动内容、合并对比和报告；研发确认技术含义；本地化负责人据此批准。
完成后：审阅记录、批准记录和遗留问题清单。
6.1
提交英文分支
运行 --mode commit。只有全部文件通过检查，才创建英文分支并提交。
完成后：英文分支和提交记录；有文件未通过则拒绝提交。
7.1 / 7.2
合并与发布
人工推送分支、发起合并请求、审批并合并；合并后才创建英文版本标签；客户支持使用并反馈问题。
完成后：合并记录、版本标签和反馈。
04 / 必须知道
前置条件与安全边界
前置条件
- 中文仓库 / 英文仓库可访问；
- 两个仓库都有已批准的基线标签；
- 配置文件写明入口文件、起始标签和目标标签；
- 英文基线是真实批准版本，不是临阶段器翻译；
- 真实 AI 模式需要试用密钥或额度代理；
- Git 凭据只从环境变量或凭据管理器读取。
安全边界
- 不移动已发布标签；
- 不直接提交到主分支（main）；
- 不把模拟结果（SIMULATED）英文提交到正式分支；
- 任一主题文件检查未通过时，拒绝提交；
- 不自动声称合并请求或发布完成；
- 不在配置文件中保存密码或令牌（token）。
复杂项目先按本说明做单篇试运行，再扩展到整本。
不在本说明书范围：AI 模式参数、发布构建参数、合并请求平台配置。
05 / 当前限制
目前能做到什么，做不到什么
| 限制 | 原因 | 怎么做 |
|---|---|---|
| 改动位置可能判断错 | 工具按“第几个段落”定位改动。主题文件里有行内引用时，新增一个段落会让后面的位置整体后移，可能被当成“删除再新增”。 | 先用简单改动试点；改动复杂时人工复核。 |
| 单篇检查可能误报 | 检查时只看到一篇文件，看不到手册的入口文件和公共资源，跨文件引用会找不到目标，连没有改动的文件也可能检查不通过。 | 检查未通过就停止，不提交，查看检查报告后人工确认。 |
| 合并只处理确定的位置 | 合并要保证没改动的英文保持原样。位置对不上或行内标记无法保留时，工具会拒绝合并，不会猜测。 | 把改动缩小到文字替换或段落末尾追加，或改为人工处理。 |
| 只能逐篇处理 | 目前一次处理一篇文件，不能整本批量执行。例如 78 篇的手册要执行 78 次。 | 先选一部分文件试点，再扩大范围。整本全自动暂不对外承诺。 |
要解除这些限制，需要升级工具本身：用稳定编号定位、读取整本手册上下文、合并时保留行内标记、提供整本批量入口。在此之前，遇到检查未通过就停止，复杂内容交给人工。
06 / 故障排除
下一步
| 现象 | 含义 | 下一步 |
|---|---|---|
PRECHECK_FAILED | 仓库、标签、入口文件缺失 | 补全配置文件，或先把仓库克隆到本地 |
plan.count = 0 | 两个 CN 标签没有变更主题 | 确认目标标签和改动是否已提交 |
| 检查结果非 0 | 引用或结构无法验证 | 停止；查看检查报告；不要提交 |
strict merge refused | 工具无法安全定位改动位置 | 缩小改动到文本替换或末尾追加，或人工复核 |
NOT_ALL_TOPICS_PASSED | 有主题文件未通过 | 不提交；修复后重跑 |
WORKTREE_FAILED | 英文分支或工作目录冲突 | 换分支名或清理旧工作目录 |