S1.05.3Localization context metadata设计
字符串需附带使用场景说明
别名: 字符串上下文 · 翻译注释 · developer comment
概念解释
本地化上下文元数据（localization context metadata）是随字符串进入翻译流程的结构化说明，用来回答谁会看到、出现在哪里、指什么、执行什么动作、结果如何，以及有哪些变量和空间约束。它不是把源文换一种说法，而是补充字符串外部、却会改变目标语言词义和语法形式的信息。
机制
翻译资源常脱离页面按 key 列表展示，译者看不到控件角色、前后状态或变量来源。短文案尤其欠定：Save 可能是动词按钮，也可能是名词；占位符 {name} 可能指人、文件或地点，并在目标语言中触发不同格与一致关系。稳定的上下文字段能把这些隐含条件显式化，使翻译决策可被复核；只在聊天中解释一次则无法随 key、版本和供应商持续传递。
边界
上下文说明不能替代清晰源文，也不能保证译者无需查看界面。写“首页文案”“请正确翻译”没有增加可行动信息；复制整段产品需求又会淹没关键条件。元数据还可能过时，特别是组件复用或流程改版后，因此它必须与 message key 和调用位置一起维护。涉及用户数据的真实示例需脱敏。
怎么落地
- 为字符串记录控件类型、页面/状态、说话者与接收者、词性、指称对象、动作后果、语气、变量含义及长度约束。
- 对每个占位符给出类型与示例，并说明它是否为人名、数量、日期或可变性别词项；不要只写“变量”。
- 让代码中的 developer comment、翻译平台说明和 key 使用位置保持可追踪关联；调用场景改变时触发上下文复核。
- 抽样隐藏源文之外的产品资料，让译者只凭资源包解释每条字符串用途；无法唯一判断的 key 退回补充，完成后在真实界面做语言验收。