十二种语言的界面文案，从三周压到一个下午

一个绕不开的坎

独立开发者做浏览器插件，几乎都会遇到同一个节点：产品在 Chrome 商店里有了几百个海外用户，评论区开始出现英文、日文、葡语的留言，你才意识到——插件的 messages.json 里，只有中文。

我上个月就卡在这里。一个效率类插件，界面文案散落在 40 多个 key 里，包括按钮、提示语、设置页说明、错误信息。要支持 12 种语言，理论上有 480 条文案要翻译。找了翻译平台报价，也考虑过外包，但很快发现问题不只是「翻译」：

• 上下文丢失。 同一个「打开」，在按钮上是 "Open"，在设置项里可能是 "Enable"，直接丢给机器翻译会得到一堆不伦不类的结果。
• 占位符容易被破坏。 文案里有 {count}、{url} 这类变量，粗暴翻译经常把占位符改坏，插件直接报错。
• 长度约束。 浏览器插件的按钮空间有限，德语和芬兰语经常翻译得比原文长一倍，界面直接撑爆。

手工处理这些细节，我估算了一下：每种语言认真校对一遍要半天，12 种语言加上来回修改，三周起步。对一个人做产品的人来说，这三周意味着新功能全部停摆。

换个思路：让 AI 当「懂插件的本地化工程师」

大模型恰好擅长这类「翻译 + 理解上下文 + 保持格式」的混合任务。我的做法不是把文案一股脑丢进去，而是搭了一个小流程，把 AI 的角色固定下来。

第一步：整理源文案，附上使用场景

先把 zh-CN/messages.json 里的每个 key 补充一条「场景说明」，比如：

"btn_open_panel": {
  "value": "打开面板",
  "desc": "工具栏按钮文案，空间受限，目标长度不超过12字符"
}

这一步花了我 40 分钟，但它是后面所有质量的来源——AI 有了场景，就不再需要猜。

第二步：用结构化提示词批量生成

核心提示词模板如下，可直接复制改造：

你是一名资深的浏览器插件本地化工程师。请将下面的界面文案从简体中文翻译成 {目标语言}。

要求：
1. 保留 JSON 的 key 和结构，只翻译 value 字段，原样返回完整 JSON。
2. 严格保留 {占位符}，例如 {count}、{url}，不得翻译或改动。
3. 每条文案后附有 desc 字段，说明其使用场景（按钮/提示/设置说明/错误信息），
   请根据场景选择该语言中最地道的表达，而不是字面直译。
4. 按钮类文案控制在 12 个字符以内；如原文很短，译文也应简短有力。
5. 错误信息需完整可读，可适当加长，但语气保持克制、不恐吓用户。
6. 对技术术语（如 token、API、cookie）保留英文原文，除非该语言有通行的译法。
7. 输出前自检：占位符是否完整、JSON 是否合法、是否有多余的逗号。

以下是源文案：
{粘贴整理好的 JSON}

12 种语言，我按 4 种一批分三次跑完，每批之后抽查占位符和按钮长度。AI 对「打开面板」这类短词会主动区分场景：按钮上给 "Open"，菜单里给 "Show panel"——这是我自己做机器翻译时从来得不到的结果。

第三步：写个五分钟的校验脚本

用 Node 写了 20 行脚本，检查三件事：JSON 可解析、占位符与源文件一一对应、按钮 key 的译文字符数。跑完发现 3 处占位符丢失、2 处德语按钮超长，把报错原文贴回给 AI 让它修复，一轮就过了。

前后对比：时间账和钱账

成本方面，整个流程的 API 调用消耗的 token 量很小——480 条短文案加上上下文，总量远低于处理一篇长文档。具体费用以你所选模型官网价格页为准，但我可以说：这个量级基本不会在账单上留下存在感，尤其是通过聚合网关调用时还能按需切换更便宜的模型处理这种「短文本 + 低风险」任务。

更重要的隐性收益是迭代速度。上线后我改了 6 条文案，重新生成 12 种语言只花了 10 分钟。放在以前，一次文案修改就意味着再走一轮三周流程——这就是为什么很多插件的多语言版本永远停留在 v1.0。

三个踩过的坑

1. 别一次塞 12 种语言。 让模型一次输出全部语言，后期质量明显下滑、JSON 容易截断。分批是稳的。
2. desc 字段是质量的杠杆。 我对比过：没写场景的翻译，按钮文案约三成需要返工；写了场景后，返工率降到个位数。
3. 校验必须是程序做的，不是人做的。 占位符问题肉眼根本看不出来，脚本 5 分钟写完，一劳永逸。

写在最后

多语言支持曾是独立开发者「知道该做但一直拖着」的典型事项，因为它贵、慢、枯燥。现在这套流程把它变成了一个下午的事——省下的不只是三周时间，更是把产品推向全球市场的那道心理门槛。

如果你也在做类似的事，可以先注册一个 API 中转账号，把这套提示词跑一遍试试：https://api.thistoken.ai/register

---

想直接跑通示例？访问 https://api.thistoken.ai/register 注册 ThisToken.AI，获取 API Key 后即可开始。