AI 翻译 PO 文件：保留上下文、占位符与复数形式

展开本页目录

开始前准备什么

Python 3.13+ 与独立练习目录；默认离线重放不需要 Key。
发起新请求时使用自己的 apizt Key；先核对当前模型权限和价格，Key 不写入教材。
材料为原创合成样例；相关第三方项目仅作方法参考，真实执行范围以本页记录为准。

核对输入
保存响应
执行本地处理
验收文件和负例

下载本例完整实测资料包

原始输入、真实请求与响应、业务脚本、正反例检查及已生成的结果文件；不含 Key。

1. 准备这份输入，先确定不能猜的字段

翻译界面文案后仍能通过本地格式检查。先将下面的原创合成材料保存为 input.json；不要一开始接正式客户资料。

本例与已有教程的区别：已有i18n JSON占位符篇未覆盖PO复数/上下文/编译产物

input.json（较长时显示节选，完整文件在资料包）

json

{
  "entries": [
    {
      "context": "cart",
      "msgid": "%(count)d 件商品",
      "msgid_plural": "%(count)d 件商品"
    },
    {
      "context": "greeting",
      "msgid": "你好，%(name)s",
      "msgid_plural": null
    }
  ]
}

AI 翻译 PO 文件：保留上下文、占位符与复数形式：实际输入与请求参数 — 实际浏览器截图：原创合成输入及本次请求参数；不是第三方软件界面。
查看高清原图

2. 发送一次小请求，保留原始响应

下载并解压资料包，按 README 创建独立 Python 环境。python run.py 默认仅离线复核已保存回执；显式运行 python run.py --live 才发起新请求并可能计费。

模型阶段使用下面的任务约束。若存在预处理，prepared-input.json 是去重、分页收集或过滤后的真实输入；完整原始材料仍保留。识图任务发送实际 JPEG，不把人工真值放入提示词。

对应任务的请求参数说明；完整实际 request-N.json 见资料包

json

{
  "model": "gpt-4.1-mini",
  "messages": [
    {
      "role": "system",
      "content": "只处理给定的虚构演示材料。只输出JSON，字段translations，每项context、msgid、msgid_plural、msgstr数组。翻成英文，保留%(count)d和%(name)s。复数数组长度2。"
    },
    {
      "role": "user",
      "content": "{\n  \"entries\": [\n    {\n      \"context\": \"cart\",\n      \"msgid\": \"%(count)d 件商品\",\n      \"msgid_plural\": \"%(count)d 件商品\"\n    },\n    {\n      \"context\": \"greeting\",\n      \"msgid\": \"你好，%(name)s\",\n      \"msgid_plural\": null\n    }\n  ]\n}"
    }
  ],
  "temperature": 0,
  "max_tokens": 1024,
  "provider": {
    "sort": "success_rate"
  },
  "response_format": {
    "type": "json_object"
  }
}

3. 执行本例的本地处理，模型字段还要再验算

以下节选来自这次实际执行的 verify-task.py 分支。完整函数和辅助方法均在资料包；运行 python run.py 会使用原始回执重放这段业务操作，而不是让模型自己宣布成功。

翻译占位符完整：cart；翻译占位符完整：greeting；PO和MO均可实际回读

verify-task.py · po 分支节选，需在完整脚本上下文运行

python

import polib
po = polib.POFile()
po.metadata = {'Language': 'en', 'Content-Type': 'text/plain; charset=UTF-8', 'Plural-Forms': 'nplurals=2; plural=(n != 1);'}
for row in output['translations']:
    source = next(item for item in data['entries'] if item['context'] == row['context'])
    placeholders = set(re.findall(r'%\([a-z]+\)[sd]', source['msgid']))
    check('翻译占位符完整：' + row['context'], all(set(re.findall(r'%\([a-z]+\)[sd]', text)) == placeholders for text in row['msgstr']))
    item = polib.POEntry(msgctxt=row['context'], msgid=row['msgid'])
    if row['msgid_plural']:
        item.msgid_plural = row['msgid_plural']
        item.msgstr_plural = {index: text for index, text in enumerate(row['msgstr'])}
    else:
        item.msgstr = row['msgstr'][0]
    po.append(item)
po.save(str(folder / 'messages.po'))
po.save_as_mofile(str(folder / 'messages.mo'))
check('PO和MO均可实际回读', len(polib.pofile(str(folder / 'messages.po'))) == 2 and len(polib.mofile(str(folder / 'messages.mo'))) == 2)

4. 查看真实结果、文件与验收记录

本次 8/8 项通过。模型返回与最终业务结果分开保存；以下是本地处理后的 result.json。

最后一次实测时间：2026-10-24T15:05:38.117984+00:00；HTTP 200；请求型号 gpt-4.1-mini；返回型号 gpt-4.1-mini；本次返回用量 227。中断或超时不会补造用量，多个尝试不合并成一次成功。

实际产物：checks.json、messages.mo、messages.po、result.json。

检查项	本次结果
真实 apizt 响应 HTTP 200	通过
原始响应 content 可直接解析 JSON	通过
事实检查：translations	通过
事实检查：translations.0.msgstr	通过
明确错误的本地反例被验收规则拒绝	通过
翻译占位符完整：cart	通过
翻译占位符完整：greeting	通过
PO和MO均可实际回读	通过

检查项: 真实 apizt 响应 HTTP 200
本次结果: 通过

检查项: 原始响应 content 可直接解析 JSON
本次结果: 通过

检查项: 事实检查：translations
本次结果: 通过

检查项: 事实检查：translations.0.msgstr
本次结果: 通过

检查项: 明确错误的本地反例被验收规则拒绝
本次结果: 通过

检查项: 翻译占位符完整：cart
本次结果: 通过

检查项: 翻译占位符完整：greeting
本次结果: 通过

检查项: PO和MO均可实际回读
本次结果: 通过

verified/result.json（节选）

json

{
  "translations": [
    {
      "context": "cart",
      "msgid": "%(count)d 件商品",
      "msgid_plural": "%(count)d 件商品",
      "msgstr": [
        "%(count)d item",
        "%(count)d items"
      ]
    },
    {
      "context": "greeting",
      "msgid": "你好，%(name)s",
      "msgid_plural": null,
      "msgstr": [
        "Hello, %(name)s"
      ]
    }
  ]
}

AI 翻译 PO 文件：保留上下文、占位符与复数形式：真实业务结果 — 浏览器实拍执行报告；原始 API 响应与本地验收分别保存。
查看高清原图

5. 换自己的材料时，先检查失败分支

本地反例用于验证业务边界，已在检查表中明确标记；不能把本地构造的错误状态写成网关真实故障。原始回执及失败尝试不删除。

本例是小样验证；替换输入后必须重新检查字段、事实和实际费用。

只把本篇标注的任务作为本次验收范围。第三方软件、未测模型、工具调用能力和真实用户数据都需要另行验证；没有调用视频生成模型。

翻译占位符完整：cart
翻译占位符完整：greeting
PO和MO均可实际回读

解压目录中运行；第一条离线，第二条显式发起新请求

python run.py
# 安全设置自己的 tokenba_API_KEY 后，才执行下面这一条
python run.py --live

怎样确认已经完成

真实 apizt 响应 HTTP 200
原始响应 content 可直接解析 JSON
事实检查：translations
事实检查：translations.0.msgstr
明确错误的本地反例被验收规则拒绝
翻译占位符完整：cart
翻译占位符完整：greeting
PO和MO均可实际回读

常见问题

AI 翻译 PO 文件只看 HTTP200 就完成了吗？

还需要按本页独立规则检查事实、缺失项及最终文件。模型阶段成功与本地工作流成功分别记录。

可以不登录其他平台运行本例吗？

可以。本例使用 apizt API 和本地 Python 脚本；离线复核也无需 API Key。第三方软件的原生 UI、插件和账号权限不在本次验收范围。

更换输入后还能沿用本页的通过结果吗？

不能。原始事实断言只适用于本页合成材料。替换输入后必须同步调整 expected、业务规则与负例，再检查输出。

资料来源

www.gnu.org · 官方规范或项目文档

展开本页目录

开始前准备什么

Python 3.13+ 与独立练习目录；默认离线重放不需要 Key。
发起新请求时使用自己的 apizt Key；先核对当前模型权限和价格，Key 不写入教材。
材料为原创合成样例；相关第三方项目仅作方法参考，真实执行范围以本页记录为准。

核对输入
保存响应
执行本地处理
验收文件和负例

下载本例完整实测资料包

原始输入、真实请求与响应、业务脚本、正反例检查及已生成的结果文件；不含 Key。

1. 准备这份输入，先确定不能猜的字段

翻译界面文案后仍能通过本地格式检查。先将下面的原创合成材料保存为 input.json；不要一开始接正式客户资料。

本例与已有教程的区别：已有i18n JSON占位符篇未覆盖PO复数/上下文/编译产物

input.json（较长时显示节选，完整文件在资料包）

json

{
  "entries": [
    {
      "context": "cart",
      "msgid": "%(count)d 件商品",
      "msgid_plural": "%(count)d 件商品"
    },
    {
      "context": "greeting",
      "msgid": "你好，%(name)s",
      "msgid_plural": null
    }
  ]
}

2. 发送一次小请求，保留原始响应

下载并解压资料包，按 README 创建独立 Python 环境。python run.py 默认仅离线复核已保存回执；显式运行 python run.py --live 才发起新请求并可能计费。

对应任务的请求参数说明；完整实际 request-N.json 见资料包

json

{
  "model": "gpt-4.1-mini",
  "messages": [
    {
      "role": "system",
      "content": "只处理给定的虚构演示材料。只输出JSON，字段translations，每项context、msgid、msgid_plural、msgstr数组。翻成英文，保留%(count)d和%(name)s。复数数组长度2。"
    },
    {
      "role": "user",
      "content": "{\n  \"entries\": [\n    {\n      \"context\": \"cart\",\n      \"msgid\": \"%(count)d 件商品\",\n      \"msgid_plural\": \"%(count)d 件商品\"\n    },\n    {\n      \"context\": \"greeting\",\n      \"msgid\": \"你好，%(name)s\",\n      \"msgid_plural\": null\n    }\n  ]\n}"
    }
  ],
  "temperature": 0,
  "max_tokens": 1024,
  "provider": {
    "sort": "success_rate"
  },
  "response_format": {
    "type": "json_object"
  }
}

3. 执行本例的本地处理，模型字段还要再验算

翻译占位符完整：cart；翻译占位符完整：greeting；PO和MO均可实际回读

verify-task.py · po 分支节选，需在完整脚本上下文运行

python

import polib
po = polib.POFile()
po.metadata = {'Language': 'en', 'Content-Type': 'text/plain; charset=UTF-8', 'Plural-Forms': 'nplurals=2; plural=(n != 1);'}
for row in output['translations']:
    source = next(item for item in data['entries'] if item['context'] == row['context'])
    placeholders = set(re.findall(r'%\([a-z]+\)[sd]', source['msgid']))
    check('翻译占位符完整：' + row['context'], all(set(re.findall(r'%\([a-z]+\)[sd]', text)) == placeholders for text in row['msgstr']))
    item = polib.POEntry(msgctxt=row['context'], msgid=row['msgid'])
    if row['msgid_plural']:
        item.msgid_plural = row['msgid_plural']
        item.msgstr_plural = {index: text for index, text in enumerate(row['msgstr'])}
    else:
        item.msgstr = row['msgstr'][0]
    po.append(item)
po.save(str(folder / 'messages.po'))
po.save_as_mofile(str(folder / 'messages.mo'))
check('PO和MO均可实际回读', len(polib.pofile(str(folder / 'messages.po'))) == 2 and len(polib.mofile(str(folder / 'messages.mo'))) == 2)

4. 查看真实结果、文件与验收记录

本次 8/8 项通过。模型返回与最终业务结果分开保存；以下是本地处理后的 result.json。

实际产物：checks.json、messages.mo、messages.po、result.json。

检查项	本次结果
真实 apizt 响应 HTTP 200	通过
原始响应 content 可直接解析 JSON	通过
事实检查：translations	通过
事实检查：translations.0.msgstr	通过
明确错误的本地反例被验收规则拒绝	通过
翻译占位符完整：cart	通过
翻译占位符完整：greeting	通过
PO和MO均可实际回读	通过

检查项: 真实 apizt 响应 HTTP 200
本次结果: 通过

检查项: 原始响应 content 可直接解析 JSON
本次结果: 通过

检查项: 事实检查：translations
本次结果: 通过

检查项: 事实检查：translations.0.msgstr
本次结果: 通过

检查项: 明确错误的本地反例被验收规则拒绝
本次结果: 通过

检查项: 翻译占位符完整：cart
本次结果: 通过

检查项: 翻译占位符完整：greeting
本次结果: 通过

检查项: PO和MO均可实际回读
本次结果: 通过

verified/result.json（节选）

json

{
  "translations": [
    {
      "context": "cart",
      "msgid": "%(count)d 件商品",
      "msgid_plural": "%(count)d 件商品",
      "msgstr": [
        "%(count)d item",
        "%(count)d items"
      ]
    },
    {
      "context": "greeting",
      "msgid": "你好，%(name)s",
      "msgid_plural": null,
      "msgstr": [
        "Hello, %(name)s"
      ]
    }
  ]
}

5. 换自己的材料时，先检查失败分支

本地反例用于验证业务边界，已在检查表中明确标记；不能把本地构造的错误状态写成网关真实故障。原始回执及失败尝试不删除。

本例是小样验证；替换输入后必须重新检查字段、事实和实际费用。

只把本篇标注的任务作为本次验收范围。第三方软件、未测模型、工具调用能力和真实用户数据都需要另行验证；没有调用视频生成模型。

翻译占位符完整：cart
翻译占位符完整：greeting
PO和MO均可实际回读

解压目录中运行；第一条离线，第二条显式发起新请求

python run.py
# 安全设置自己的 tokenba_API_KEY 后，才执行下面这一条
python run.py --live

怎样确认已经完成

真实 apizt 响应 HTTP 200
原始响应 content 可直接解析 JSON
事实检查：translations
事实检查：translations.0.msgstr
明确错误的本地反例被验收规则拒绝
翻译占位符完整：cart
翻译占位符完整：greeting
PO和MO均可实际回读

常见问题

AI 翻译 PO 文件只看 HTTP200 就完成了吗？

还需要按本页独立规则检查事实、缺失项及最终文件。模型阶段成功与本地工作流成功分别记录。

可以不登录其他平台运行本例吗？

可以。本例使用 apizt API 和本地 Python 脚本；离线复核也无需 API Key。第三方软件的原生 UI、插件和账号权限不在本次验收范围。

更换输入后还能沿用本页的通过结果吗？

不能。原始事实断言只适用于本页合成材料。替换输入后必须同步调整 expected、业务规则与负例，再检查输出。

资料来源

www.gnu.org · 官方规范或项目文档

AI 翻译 PO 文件：保留上下文、占位符与复数形式

先看结论

开始前准备什么

1. 准备这份输入，先确定不能猜的字段

2. 发送一次小请求，保留原始响应

3. 执行本例的本地处理，模型字段还要再验算

4. 查看真实结果、文件与验收记录

5. 换自己的材料时，先检查失败分支

怎样确认已经完成

常见问题

资料来源

先用这份输入，确认自己的第一份结果

1. 下载完整样例

2. 离线检查业务结果

3. 需要新结果时，再调用 API

AI 翻译 PO 文件：保留上下文、占位符与复数形式

先看结论

开始前准备什么

1. 准备这份输入，先确定不能猜的字段

2. 发送一次小请求，保留原始响应

3. 执行本例的本地处理，模型字段还要再验算

4. 查看真实结果、文件与验收记录

5. 换自己的材料时，先检查失败分支

怎样确认已经完成

常见问题

资料来源

先用这份输入，确认自己的第一份结果

1. 下载完整样例

2. 离线检查业务结果

3. 需要新结果时，再调用 API