CLI v0 键控制与手动编辑
在旧版文本目录中,明确区分由源内容控制的值、由人工维护的译文和常规修正。
常规手动修正与保留键的有效期不同。只要源内容未变,v0 通常会保留现有目标值。保留键则将该值留给人工维护,即使源文本发生变化也不例外。
修正常规译文 #
直接编辑目标值,并提交确认后的措辞。如果源内容未变,常规增量处理可以保留该值。源内容的校验和一旦变化,该键就可以再次被翻译;即使源内容未变,强制执行也可以替换该值。
如果一处修正需要在源内容变化后重新审视其含义,请使用这种方式。对于必须由人工维护的内容,请选择保留,并建立源内容变更的审核流程。
明确指定维护归属 #
| 控制方式 | 旧版输出行为 |
|---|---|
lockedKeys | 复制源值,可能覆盖对目标值的编辑。 |
ignoredKeys | 将选定内容排除在翻译和输出之外。 |
preservedKeys | 先用源值填充缺失值,再保留目标值,交由人工维护。 |
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
}
}
}在这个示例中,品牌名称保持一致,内部条目不再输出,法律条款仍由人工维护。新保留的源语言占位文本仍需在发布前完成翻译。如果应用依赖某个被忽略的键,请提供回退方案,或调整应用对该键的依赖。
请检查相互重叠的控制模式,不要假定存在文档未说明的优先级。v0 的这一行为与当前的目标值保留控制不同。
定位嵌套键与字面键 #
旧版路径使用斜杠逐层定位。brand/name 选择 brand 内的 name;modules/ai.translation 选择 modules 内名称包含点号的字面键。通配符遵循旧版匹配器的规则,应在预期的层级深度进行测试。当前的点号和方括号语法不能与旧版语法互换。
重命名时复用译文 #
旧版增量处理可以在同一处理路径上下文中,将新键的源值哈希与已移除键的先前哈希进行匹配。如果文本保持一致,现有目标值就可以迁移到重命名后的键,无需重新翻译。
同时更改键和源内容会产生新的翻译工作。跨独立路径移动或使用重复的相同字符串时,需要检查匹配结果;这种匹配并不等同于可无限制复用的翻译记忆。当前 JSON 标识基于路径,不沿用这一行为。
需要主动替换译文时,请使用 重新翻译;需要提供上下文指引时,请使用 译者备注。但无论使用哪一种,都仍需明确输出值由谁维护。