返回的译文需要完全相同的原始目录
在协作翻译交接前，理解原件哈希、保护行及字节保留。
协作需求有明确的交接终点
来源作者希望朋友协助编辑 XCstrings，Windows 协作者使其倾向在线入口。公开提问没有附实际目录，因此浏览器工具需要声明所支持的形态，不能假定所有目录都是直接单元。
空格也属于原件身份
返回翻译表绑定原始字节哈希。只改排版可能保留解析值，但哈希已变。原件变化后应重新导出；仅键名相同不能证明译者编辑的是哪一版。
"opaqueRevision": 9007199254740993,
"opaqueFraction": 0.125既有直接单元和变体有不同审核要求
直接 value/state 交换可以明确绑定。复数、设备和替换分支需要理解目录的语义；把它们压平为单条译文可能丢掉必需分支。应保留完整原件和拒绝诊断，交给合适的编辑器。
| 字段 | 处理 |
|---|---|
| value / state | 编辑既有直接单元 |
| valuePath / sourceLocale | 保留每行及行序 |
| sourceSha256 / version / sourceLanguage / columns | 保留精确绑定与表头 |
完整报告和预览的用途不同
短预览让大文件结果可用，但不能替代完整原件、更新目录、表或拒绝诊断。读取全部变更清单，再让接收 Xcode 项目验证回填目录及语言要求。
- 保留导出翻译表时使用的完全相同的目录原件。
- 请协作者只编辑既有 value/state 单元，保留保护字段、行序和表头。
- 把返回表应用到该原件，查看完整修改报告，再在接收 Xcode 项目验证更新目录。
- 目录含被拒绝的变体时，保留原件和完整诊断，交给能理解目录语义的编辑器。
参考资料
- 协作编辑 XCstrings 的用户提问
作者希望朋友协助编辑，部分使用 Windows，因此倾向在线入口。作者未提供实际目录；证据支持任务，不证明所有形态或需求量。
- Apple 字符串目录文档
字符串目录可包含变体；本工具拒绝该类形态，仅交换既有直接单元。
本分类工具使用说明
展开工具，查看操作步骤、可调选项和支持范围，再直接进入工作区。
XCstrings 人工翻译交换与回填导出既有直接译文及状态交给协作者，再将完整返回表或绑定 SHA 的部分补丁回填；未编辑的目录字节保持原样。
导出既有直接译文及状态交给协作者，再将完整返回表或绑定 SHA 的部分补丁回填；未编辑的目录字节保持原样。
操作步骤
- 选择“导出交换表”，选取原始目录。
- 将 manual-exchange.json 交给协作者。在 JSON 编辑器中只改 value 和 state，保留保护字段及每一行。
- 选择“应用完整返回表”，选取逐字节相同的原件及完整返回 JSON；或选择“应用部分补丁”，显式提供原值。
- 检查计数及完整变更报告，下载更新目录，再让接收的 Xcode 项目验证。
可调选项
- 任务
- 导出完整交换表 · 应用完整返回表 · 应用显式部分补丁
能力与限制
- 选择一个严格 UTF-8、无 BOM 的 XCstrings 1.0 或 1.3 原件，最多 5 MiB。导入另需一个返回 JSON File：完整表最多 16 MiB，显式部分补丁最多 5 MiB。整读前验证两个文件角色、全部参数、大小及最多 512 UTF-8 字节的 Unicode 标量文件名。
- 导出所有既有直接 stringUnit 的 value 与 state。支持状态为 new、needs_review、translated。语言键作为固定的不透明键，不证明其在 Xcode 中合法。可以保留空条目/本地化对象，但不创建新语言或单元。
- 完整返回表只能改 value 和 state；保留 format、sourceSha256、version、sourceLanguage、columns、所有行、行序、valuePath 和 sourceLocale。部分补丁为每项显式提供 valuePath、originalValue、originalState、value、state；未知/重复路径或原值冲突会使整个导入失败。
- 根、条目、本地化或单元层的任何 variations/substitutions、未知状态或未知本地化形态都会原子拒绝。失败界面保留逐字节 original.xcstrings 与完整 unsupported-shapes.json，均可完整复制/下载。结构前提非法时另给明确的非穷举诊断，不呈现为成功更新的目录。
- 最多 10,000 个条目、50,000 条本地化记录、50,000 个直接单元、64 层 JSON 容器及 1,000,000 个 JSON 树节点。成熟 scanner 在递归解析前计数：容器/字面量及 property 节点，键字符串也计数。重复键、非法 JSON、无效 UTF-8 或转义孤立代理项均原子失败。
- 完整交换表或更新目录各最多 16 MiB。完整导入变更报告采用推导的 40 MiB 容量；全部交付文件字节合计最多 61 MiB。失败文件限于 5 MiB 原件加 16 MiB 诊断，不静默截短输出。
- 除选定 value/state 字符串 token 外，原 UTF-8 字节保持原样：存为元数据的注释、空格、CRLF、未知对象、小数和超安全整数的数字写法均保留。原件下载不经过 JSON 重序列化。
- 宿主 10 秒时限覆盖 File 读取、Worker 加载、ready、计算和完整结果校验。取消立即结束并终止活跃 Worker，忽略迟到的读取/回复。停止后可用相同原 File 和参数重试。预览最多 4,000 个 Unicode 码点，复制/下载保留每个文件的完整字节。