You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
virt/docs/USER_COPY_CATALOG.md

1.5 KiB

用户界面译文目录

用户界面译文采用稳定语义键、源码中文基线和管理员发布译文的模型。源码不得保存英文或其他目标语言译文。

web/resources/user-copy/manifest.php 是页面、scope、词条类型、中文安全基线、参数合同和安全等级的唯一源码定义。管理员草稿、发布版和历史版本属于数据库;普通用户运行时只读取管理员发布后编译的不可变目录,不能在缓存失效时回查翻译数据库。

entries 使用带 key 字段的列表,而不是以词条键作为 PHP 数组下标。这样合同校验能在加载阶段真实识别重复键,避免 PHP 解析关联数组时静默覆盖前一个同名词条。校验后的目录仍按键排序,摘要不会受源码排列顺序影响。

词条键必须是静态小写语义键,例如 instance.settings.hostname.help。禁止动态拼接词条键。带参数文案必须声明完整参数合同并使用 ICU 格式;支付、删除、重装、数据丢失和效果未知等高风险词条不能隐藏或留空。

覆盖扫描器当前只提供迁移报告。用户页面逐步接入目录后,最终门禁将禁止直接 Toast 文本、浏览器确认文本、固定 zh-CN 格式和未登记的用户可见中文。临时放行必须在同一行使用带原因的 user-copy: allow <reason>,最终迁移阶段会收紧放行范围。

页面内翻译预览、数据库草稿和发布目录将在后续独立提交中实现;本阶段不改变任何现有用户页面行为。