# 第一步：审计可翻译内容

• 渲染布局和动作脚本的固定文案使用 tools.tr("原文", params)；
• 动态字符串区分“保存的最终文本”和“读取时生成的翻译”；
• 保留 {count}、HTML 标签、资源 ID 和脚本结构；
• AI 生成并保存的历史文本不会自动随语言切换重译。

# 第二步：建立翻译契约

在词表与翻译建议中记录：

• 人名、地名、职业和玩法术语；
• 按钮语气、叙述人称和标点风格；
• 必须保留原文的品牌、Skill 与代码名；
• 不可翻译的占位符、HTML 和动态协议；
• 同一概念禁止出现的其他译法。

词表随项目保存，应在翻译前维护，而不是翻译完后逐条纠错。

# 第三步：运行翻译 Agent

在 AI 助手 -> 设置 -> 翻译 选择目标语言，保存词表，再启动翻译。Agent 会读取当前可翻译 key、分批生成内容并写入目标语言包；已经从源码移除的 key 会随整理清除。

# 第四步：实际切换语言验收

不要只看语言包文件。逐个检查：

• 导航、按钮、弹窗和错误提示；
• 变量插值、复数和数字格式；
• 长文本换行、窄屏按钮和表格列宽；
• RTL 语言的方向和图标位置；
• 动态字符串、AI 输出和对象详情；
• 未翻译 key 的原文回退。

# 保存文本的语言策略

玩家昵称、自由输入和 AI 输出通常保存最终文本，不强制翻译。系统生成的长期记录如果需要切换语言，应保存业务 key/参数或结构化数据，在显示时调用 tools.tr。

# 验收清单

• 所有固定玩家文案都能从源码 key 收集。
• 占位符和 HTML 结构在各语言中保持一致。
• 术语在场景、脚本和平台页面中一致。
• 目标语言实际预览没有溢出或截断。
• 删除/新增 key 后语言包能正确同步。

继续阅读：文本、图标与动态字符串 和 编辑器 AI 功能。