与协作者交换 XCstrings 译文

从实际目录导出

选择“导出交换表”，选取原始目录。

选择一个严格 UTF-8、无 BOM 的 XCstrings 1.0 或 1.3 原件，最多 5 MiB。导入另需一个返回 JSON File：完整表最多 16 MiB，显式部分补丁最多 5 MiB。整读前验证两个文件角色、全部参数、大小及最多 512 UTF-8 字节的 Unicode 标量文件名。

• 将 manual-exchange.json 交给协作者。在 JSON 编辑器中只改 value 和 state，保留保护字段及每一行。
• 选择“应用完整返回表”，选取逐字节相同的原件及完整返回 JSON；或选择“应用部分补丁”，显式提供原值。
• 检查计数及完整变更报告，下载更新目录，再让接收的 Xcode 项目验证。

保留表中的保护字段

完整返回表只能改 value 和 state；保留 format、sourceSha256、version、sourceLanguage、columns、所有行、行序、valuePath 和 sourceLocale。部分补丁为每项显式提供 valuePath、originalValue、originalState、value、state；未知/重复路径或原值冲突会使整个导入失败。

{
  "format": "neatbo-xcstrings-manual-exchange-v1",
  "sourceSha256": "b891764f343f28dec3340d0b75dab2590ba5bcf08b6ac81cab9330b473cb0d11",
  "edits": [
    {
      "valuePath": "/strings/Greeting/localizations/fr/stringUnit/value",
      "originalValue": "Bonjour",
      "originalState": "needs_review",
      "value": "Salut",
      "state": "translated"
    }
  ]
}

读取完整交付文件

导出交付原件和完整表；导入交付原件、更新目录与完整变更。失败为独立拒绝状态，保留原件和诊断。每个文件都可完整复制/下载，4,000 码点仅是预览。

准确理解拒绝范围

根、条目、本地化或单元层的任何 variations/substitutions、未知状态或未知本地化形态都会原子拒绝。失败界面保留逐字节 original.xcstrings 与完整 unsupported-shapes.json，均可完整复制/下载。结构前提非法时另给明确的非穷举诊断，不呈现为成功更新的目录。

最多 10,000 个条目、50,000 条本地化记录、50,000 个直接单元、64 层 JSON 容器及 1,000,000 个 JSON 树节点。成熟 scanner 在递归解析前计数：容器/字面量及 property 节点，键字符串也计数。重复键、非法 JSON、无效 UTF-8 或转义孤立代理项均原子失败。

• 已知变体/替换及未知直接单元状态/形态，以原件推导的 UTF-16 位置和条目/语言字典完整枚举。
• 结构前提非法时给出明确的非穷举致命验证诊断，不交付部分目录。

理解容量及保留字节

完整交换表或更新目录各最多 16 MiB。完整导入变更报告采用推导的 40 MiB 容量；全部交付文件字节合计最多 61 MiB。失败文件限于 5 MiB 原件加 16 MiB 诊断，不静默截短输出。

除选定 value/state 字符串 token 外，原 UTF-8 字节保持原样：存为元数据的注释、空格、CRLF、未知对象、小数和超安全整数的数字写法均保留。原件下载不经过 JSON 重序列化。

有效树诊断上界按每个五整数定位记录及分隔符共 31 字节：31 × 270,002 + 5,242,880 字典字节 + 1,024 固定字节 = 13,613,966，小于 16 MiB。这是被输入边界支配的保守推导，不是实际 exact 最大样本。变更报告由两个有界 16 MiB 表、每个最多 50,000 编辑的 128 字节额外开销及 16 KiB 元数据推导，小于 40 MiB；JSON 传输另设经过测试的 320 MiB guard，不降低公开文件限额。

停止后恢复相同任务

宿主 10 秒时限覆盖 File 读取、Worker 加载、ready、计算和完整结果校验。取消立即结束并终止活跃 Worker，忽略迟到的读取/回复。停止后可用相同原 File 和参数重试。预览最多 4,000 个 Unicode 码点，复制/下载保留每个文件的完整字节。

保留原件与完整拒绝诊断。变体需交给理解该目录的编辑器；修正绑定/语法问题，或拆分超限输入。取消或超时后，已选 File 可用于完整重试。