返回

gt-next@6.11.0

Ernest McCarter avatarErnest McCarter
gt-next6.11.0maxcharscharacter-limits

概览

gt-next@6.11.0 在翻译函数中新增了对 $maxChars 参数的支持，基于在 generaltranslation@8.1.0 中引入的 formatCutoff() 功能进行扩展。

用法

$maxChars 参数适用于任何字符串翻译函数调用：

gt('Welcome to our application', { $maxChars: 20 })
// AI 尝试在 20 个字符内进行翻译:"Bienvenido a app"

字符数上限处理

$maxChars 参数会触发两种不同的机制：

  1. AI 翻译优化：AI 会接收字符数上限，并尝试生成长度不超过该上限的译文。

  2. 库级截断：如果任意翻译结果（来自 AI 或缓存）超过字符数上限，库会执行遵循语言环境规则的截断以强制满足该上限。

gt('Long description text', { $maxChars: 15 })
// AI 尝试简洁翻译："Texto breve"
// 如果结果超出限制："Texto de desc…"(已截断)

集成

兼容现有的翻译方案：

gt('User notification', {
  $context: 'mobile-alert',
  $maxChars: 30
})
// AI 尝试在 30 字符内完成翻译："Notificación usuario"
// 库会在必要时进行截断："Notificación del usuario…"

该参数会参与翻译哈希的计算，确保不同的字符数上限会生成各自独立的翻译条目。