XUnity.AutoTranslator 版本演进全解析:从 CHANGELOG 追溯 2.0.0 到 5.6.1 的技术脉络

原创2026-10-15 15:59:211,877 阅读
文章标签:NLP人工智能国际化插件系统游戏开发

XUnity.AutoTranslator 版本演进全解析:从 CHANGELOG 追溯 2.0.0 到 5.6.1 的技术脉络

本篇基于仓库根目录的 CHANGELOG.md 展开,完整梳理 XUnity.AutoTranslator 从 2.0.0 初始发布到当前 5.6.1 的全部版本迭代,逐条解读其中的 FEATURE、BREAKING CHANGE 与 BUG FIX 条目,并结合 UIElementsHooks.cs、UnityInput.cs、YandexTranslateEndpoint.cs 等仓库源码印证各版本的实际实现。读完后你可以快速判断:该插件当前支持哪些翻译端点与文本框架、IL2CPP 支持到什么程度、哪些版本升级会破坏已有翻译文件,以及如何根据目标游戏的运行时选择正确的安装包。

一、如何阅读这份版本历史

CHANGELOG.md 采用“版本号倒序 + 标签分类”的结构,每个版本下的条目以标签开头:

标签 含义
FEATURE 新增功能
BUG FIX 缺陷修复
MISC 杂项:性能改进、配置调整、日志变化等
CHANGE 行为变化,通常伴随兼容性影响
BREAKING CHANGE 破坏性变更,升级时必须阅读
REGRESSION 明确说明的能力移除/回退
MISC - README 等 文档类更新

版本按语义化版本号组织:当前最高版本为 5.6.1,历史可回溯到 2.0.0(Initial release)。阅读时建议结合 README.md 中的“Translators”“Text Frameworks”“Configuration”章节——CHANGELOG 中的许多条目(如某个配置项的引入时间)都能在 README 的默认配置文件示例中找到对应项。

以下章节按时间线由近及远展开:先逐条深入最近几个版本(5.5.0~5.6.1)并结合源码验证,再分段回顾 5.x、4.x、3.x、2.x 各系列的关键节点,最后汇总破坏性变更与完整版本时间线。

二、最新版本线(5.6.1 ~ 5.5.0):IL2CPP 打磨与新版框架支持

5.6.1:修复 IL2CPP 下的热键无响应与字体资源加载

CHANGELOG 5.6.1 记录了两个 BUG FIX:

  • 修复 IL2CPP 环境下的热键无响应和 GUI unstrip 错误(#834);
  • 修复 IL2CPP 环境下字体 asset bundle 加载失败(#831)。

前者与输入系统抽象层直接相关。从源码结构看,热键检测统一走 UnityInput.cs,它按优先级探测可用的输入系统:IL2CPP 构建下优先尝试 Il2CppLegacyInputSystem,Mono 构建下优先 LegacyInputSystem(基于 UnityEngine.Input),失败时回退到 NewInputSystem(基于 UnityEngine.InputSystem),全部失败则降级为 NullInputSystem。IL2CPP 中“GUI unstripping”问题正是因为 legacy Input API 未被正确保留,抽象层的探测/回退机制正是 5.5.1 引入、5.6.1 修复的目标场景。

后者对应字体加载逻辑,实现位于 FontHelper.cs 与 FontCache.cs,负责 UGUI/TMP 的字体覆盖(OverrideFont/OverrideFontTextMeshPro/FallbackFontTextMeshPro 配置项)与 asset bundle 加载。

5.6.0:UIElements 支持与 Papago 端点修复

  • FEATURE - Added UIElements support (#818):新增对 Unity 新版 UI 框架 UIElements(VisualElement 体系)文本组件的翻译支持。对应实现为 UIElementsHooks.cs,其 TextElement_text_Hook 以 HookPriority.Last 优先级钩住 TextElement.text 属性的 setter:MANAGED 构建同时提供 Harmony Postfix 与 MonoMod Detour 两种实现,IL2CPP 构建下先通过 Il2CppUtilities.CreateProxyComponentWithDerivedType 把指针包装为代理组件,再交给 AutoTranslationPlugin.Current.Hook_TextChanged 统一处理。README 默认配置中已出现 EnableUIElements=True 这一开关项。
  • BUG FIX - Fix Papago translator JS chunk pattern (#820):Papago 端点需要从主页 HTML 中解析出带哈希的 JS chunk 文件地址,再从中解析版本信息。PapagoTranslateEndpoint.cs 第 32 行的 PatternSource = /main\.[a-f0-9]+\.chunk\.js 即 5.6.0 更新后的匹配模式,用于适配 Papago 站点当前的构建产物结构。
  • MISC:README 将第三方翻译器 AutoPollinationTranslator 加入列表(#823)。

5.5.2 / 5.5.1:DeepL 认证方式与双输入系统

  • 5.5.2 - BUG FIX - Use Authorization header instead of legacy query/body params for DeepL API auth:DeepL 官方 API 已废弃旧的 auth_key 查询/正文参数。当前实现位于进程外执行器 ExtDeepLTranslateLegitimate.cs(第 138、189 行),请求统一携带 Authorization: DeepL-Auth-Key {key} 头部。注意 DeepL 认证端点(DeepLTranslateLegitimate)本身就是以 ExtProtocol 进程外方式运行的,见 DeepLTranslateLegitimate.cs 中 ExtProtocolEndpoint 的继承关系。该版本同时修复了 IL2CPP 下“字体覆盖一段时间后失效”的问题。
  • 5.5.1 - Use UnityInput to support both legacy and new input systems:引入前述 UnityInput.cs 抽象层(注释中说明其借鉴自 BepInEx 的同类组件),使 ALT+0/ALT+1/ALT+T 等热键在新旧两套 Unity 输入系统并存的游戏里都能工作,这是 5.6.1 热键修复的铺垫。

5.5.0:Yandex v2、XUAIGNORETREE 与初始化完成事件

这是 5.x 系列中特性密度最高的一个版本,三项 FEATURE 在源码中都有明确落点:

  1. Yandex Translate API v2 support:YandexTranslateEndpoint.cs 第 21 行显示请求地址已切换为 https://translate.api.cloud.yandex.net/translate/v2/translate,采用 POST + JSON 正文,并在第 64 行以 Authorization: Api-Key {key} 头传递密钥;SupportedLanguages 集合与 FixLanguage 方法负责把 zh-CN/zh-Hans 归一化为 zh,源/目标语言不在支持列表时会抛出 EndpointInitializationException 阻止该端点被选中。
  2. XUAIGNORETREE 标签:允许把整个 GameObject 子树排除在翻译之外。此前只支持 XUAIGNORE(仅忽略命中的 GameObject 本身)。实现见 ComponentExtensions.cs:两个常量 XuaIgnore = "XUAIGNORE"、XuaIgnoreTree = "XUAIGNORETREE",组件遍历时先检查名称是否包含 XUAIGNORE(天然覆盖 XUAIGNORETREE),命中 XUAIGNORETREE 时递归跳过其子级。注意该检查发生在组件创建阶段,运行时改名不会生效(README 的“XUAIGNORE”一节有同样警告)。
  3. AutoTranslatorState.PluginInitialized 属性与 PluginInitializationCompleted 事件:面向外部插件的初始化时序 API。AutoTranslatorState.cs 中两者均为 public static 成员,内部方法 OnPluginInitializationCompleted() 保证事件只触发一次,且订阅者抛出的异常会被 XuaLogger.AutoTranslator 捕获记录而不会拖垮宿主;调用点位于 AutoTranslationPlugin.cs。其他插件(如需要等翻译缓存就绪后再注册资源的 Mod)可以依赖该事件做“非常早期的初始化后动作”。

三、5.x 系列回顾(5.0.0 ~ 5.4.6):IL2CPP 落地与稳定性加固

5.0.0:IL2CPP 与 MelonLoader 首次支持

  • FEATURE - Basic IL2CPP support through BepInEx 6 and MelonLoader:这是整个项目的一次重大平台扩展。配套证据在仓库中随处可见:libs/BepInEx 6.0 BE-704/ 目录(含 BepInEx.IL2CPP.dll、Il2CppInterop 相关程序集)、XUnity.AutoTranslator.Plugin.BepInEx-IL2CPP 与 XUnity.AutoTranslator.Plugin.MelonMod 项目、以及各处 #if IL2CPP 条件编译。README 明确记载该 IL2CPP 构建基于 BepInEx bleeding edge build 704 与 MelonLoader v0.6.1 Open-Beta 构建。
  • FEATURE - FallbackFontTextMeshPro:作为 OverrideFontTextMeshPro 的推荐替代,仅对缺失字符生效,降低整字体替换的风险。
  • FEATURE - ClipboardDebounceTime:控制文本显示到真正写入剪贴板的延迟,配合 Translation Aggregator 使用。
  • MISC - BepInEx 插件包由 BepIn-5x 更名为 BepInEx:升级时必须手动删除旧 BepIn-5x DLL,避免加载冲突。
  • MISC - UTAGE 支持完全重写:为重写后的 IL2CPP 兼容做准备。

5.1.0 ~ 5.4.6:破坏性变更与端点生态

  • 5.1.0(BREAKING CHANGE):翻译文件中 = 的转义方式由 %3D 改为 \=(读取时仍兼容 %3D 作为换行)。这是手动翻译项目升级 5.x 时最需要核对的格式问题。同版引入“被正则替换的翻译从标准输出文件自动剪枝”(不适用于 splitter 正则)。
  • 5.2.0:新增 Lingo Cloud(彩云)端点,对应 LingoCloudTranslateEndPoint.cs(X-Authorization: token {key} 头);修复 IL2CPP 下 BepInEx 未 unhone 路径问题。
  • 5.3.0:跟进 MelonLoader/BepInEx bleeding edge 构建(仅 IL2CPP;Mono 请用稳定包),并移除对旧版加载器的支持;新增 PersistRichTextMode 控制富文本解析结果按 Fragment(逐段)还是 Final(整串)持久化——Final 模式不支持 substitutions;REGRESSION:IL2CPP 因新 interop 问题放弃 2017 年以前的 Unity 版本。
  • 5.4.0 ~ 5.4.6:围绕稳定性的收尾:更新到 BepInEx 6.0 BE-704 修复 IL2CPP 崩溃(5.4.0)、TMP 字体覆盖时保留 outline 样式、NGUI 基础 resizer 支持(5.4.5)、NGUI 接入 TextGetterCompatibilityMode(5.4.4)、CustomTranslateEndpoint 新增 EnableShortDelay/DisableSpamChecks(5.4.3)、翻译 scoping 失败时回退到当前场景 id(5.4.2)、修复 culture 敏感的字符串操作在土耳其语等区域设置下出错(5.4.6)。

四、4.x 系列(4.0.0 ~ 4.21.0):资源重定向、UI 缩放与手动翻译工具链

4.x 是功能密度最高的系列,奠定了当前 README 文档中“Resource Redirection”“UI Font Resizing”“Translation Scoping”等章节的功能基础。

4.0.0:架构重构与资源重定向 API

  • BREAKING CHANGE - 内部与部分公开 API 重构,ITranslateEndpoint 不受影响;
  • BREAKING CHANGE - Translators 目录结构变更,升级时应整体替换该目录;
  • FEATURE - Resource Redirection API:即仓库中独立的 XUnity.ResourceRedirector 项目,可重定向游戏加载的任意资源(插件自带 TextAsset 重定向器);
  • FEATURE - 翻译处理可重定向到外部进程:即 ExtProtocol 机制,对应 ExtProtocolEndpoint.cs,至今 DeepL 等端点仍通过它进程外运行。

4.1 ~ 4.3:正则拆分、作用域与 UI 缩放

  • 4.1.0:引入 splitter 正则(sr:),可先把“编号 + 文本”之类组合串拆开再分别查翻译表——README“Splitter Regex”一节给出的 sr:"^([0-9]{2}) ([\S\s]+)$"=$1 $2 示例即出自这条特性。
  • 4.2.0:CHANGE ——splitter 正则的配置方式重构以支持 scopes。
  • 4.3.0:FEATURE - UI resize,手动调整已翻译文本组件字号/行距等,实现位于 UIResize 目录(ChangeFontSize、AutoResize、UGUI_ChangeLineSpacing、TMP_Overflow 等命令均在该系列逐步补全:4.18.0 给 AutoResize 增加 min/max 字号,4.20.0 增加 TMP_Overflow/TMP_Alignment)。

4.4 ~ 4.9:翻译文件体系与防滥用

  • 4.4.0:允许翻译“任意被发现的文本”,配合 OutputUntranslatableText 等配置;
  • 4.5.0(CHANGE):默认目录路径全部调整;{Lang}/{lang} 占位符进入所有配置路径,翻译/缩放/贴图文件支持 ZIP;
  • 4.6.0:重定向资源目录支持 ZIP;首次启动时若存在贴图目录则自动启用贴图翻译;
  • 4.7.0:text preprocessors(PreprocessorsFile):发往翻译端点前对文本做替换;
  • 4.8.0:TMP 字体可改为从外部 asset bundle 加载;移除 BepInEx 4.x 安装包;
  • 4.8.1:Google 兼容端点(进程外)首次以实验形式出现;
  • 4.9.0:面向 TextAsset 手动翻译的公开 API;贴图“按需加载、不常驻内存”选项;中文变体(zh-CN/zh-TW/zh-Hans/zh-Hant/zh)作为源/目标语言的全端点支持。

4.10 ~ 4.16:DeepL、V2 端点与批量

  • 4.10.0:通过 Ehnd 原生支持 ezTransXP(对应 ezTransXP.ExtProtocol 与 Lec.ExtProtocol 两个本地库加载器);Linux + BepInEx 5.x 支持改进;
  • 4.11.0:文本解析递归(默认关闭,MaxTextParserRecursion)与 FairyGUI 支持(现对应 FairyGUIHooks.cs 与 FairyGUITextComponentManipulator.cs);
  • 4.12.0:插件专属翻译(Plugins 子目录 + TranslationRegistry 注册 API);Unity 2018/2019+ 的正式 IMGUI 支持;
  • 4.13.0:OutputTooLongText、MaxCharactersPerTranslation 上限由 1000 提升到 2500、面向外部插件的翻译控制 API;
  • 4.14.0:GoogleTranslateV2 端点(对应 GoogleTranslateEndpointV2.cs);
  • 4.15.0:DeepL 端点(对应 DeepLTranslate.cs)、自动 fallback 端点、ITranslateEndpoint 扩展以传递上下文翻译信息;
  • 4.16.0:两个 BREAKING CHANGE——Text 目录加载顺序改为 ZIP 最低优先级(与重定向资源行为一致)、IMGUI 数字处理变化(可能导致旧翻译失效);同版引入 TemplateAllNumbersAway、ReloadTranslationsOnFileChange(热重载,底层是 SafeFileWatcher.cs);
  • 4.17.0:默认端点改为 GoogleTranslateV2;
  • 4.18 ~ 4.21:RegexPostProcessing 配置(4.19.0)、_Postprocessors.txt 后处理文件与按分辨率控制翻译/缩放的翻译文件指令(4.18.0,对应 RegexPostProcessing 相关实现 与 TextTranslationInfo.cs)、面向离线翻译器的防滥用/延迟控制(4.21.0,对应 SpamChecker.cs)。

五、3.x 系列(3.0.0 ~ 3.8.1):多框架、多端点、多加载器的成型期

  • 3.0.0:一次大版本——游戏内 UI(ALT+0)、会话中动态切换翻译器、BingTranslate 与 LEC Offline Power Translator 15、自定义翻译器(CustomTranslate,即 CustomTranslateEndpoint.cs 的 GET from/to/text 协议)、Watson 升到 v3、romaji 输出语言、支持批处理的端点全面 batching;{GameExeName} 变量进入配置路径;GameLogTextPaths 专门处理“持续追加文本的日志型组件”。
  • 3.1.0:EnableExperimentalHooks 支持 netstandard2.0 API 面(新版 Unity 常见);Utage hook 重写。
  • 3.2.0:BepInEx 5.x 插件支持;内部大规模重构;UI 交互时屏蔽游戏输入。
  • 3.3.0:翻译文件支持 TARC 正则格式;空白/换行处理大幅改进(TrimAllText 移除)。
  • 3.4.0 ~ 3.5.0:同名贴图资源检测(FromImageNameAndScene 策略的前身);Harmony 2.0 预发布支持(配合 BepInEx 5.0.0-RC1)。
  • 3.6.0:Translation Aggregator 视图(ALT+1)、substitutions 替换表(_Substitutions.txt,私は{{A}}=I am {{A}} 形式的参数化)、Papago 端点;移除对 UnityEngine.UI 的硬依赖以兼容老引擎。3.6.1/3.6.2 补充 GenerateStaticSubstitutionTranslations、GeneratePartialTranslations(滚动字幕)与 OverrideFontTextMeshPro。
  • 3.7.0:3D TextMesh 钩子(默认关闭);查询翻译的公开 API(AutoTranslator.Default.TranslateAsync / TryTranslate,README“Integrating with Auto Translator”章节的示例源码即对应此版本);Experimental 钩子被 MonoMod 钩子取代。
  • 3.8.0:TARC 指令(#set exe/#unset exe/#set level/#unset level,需 EnableTranslationScoping=True);空白处理彻底重构;移除 Delay、WhitespaceRemovalStrategy 两个配置;CacheWhitespaceDifferences 默认值 True→False。
  • 3.8.1:EnableSilentMode、IMGUI 窗口黑名单(BlacklistedIMGUIPlugins)。

六、2.x 系列(2.0.0 ~ 2.18.0):端点生态与防滥用机制的起源

  • 2.0.0:Initial release。
  • 2.1.0:文本框架开关(EnableUGUI 等);其他翻译插件把本插件作为 fallback 的集成能力。
  • 2.2.0 ~ 2.3.0:请求级防滥用(已认为翻译过的文本不再重翻);内部 HTTP 从 .NET WebClient 切换到 Unity WWW;SSL 支持。
  • 2.4.0:BREAKING CHANGE - 配置整体重组;BaiduTranslate(需 AppId/AppSecret);强制按换行拆分译文。
  • 2.5.0:复制到剪贴板功能;多套限速模式。
  • 2.6.0 ~ 2.8.0:连续三轮 gtrans(Google 在线接口)抓取修复(持久连接、cookie、TKK 重算);IMGUI 数字文本支持与 hook 覆盖;EnableIMGUI=True 开启后其他 Mod 的 IMGUI 界面也可被翻译。
  • 2.9.0:UnityInjector 安装方式;Excite 端点(后于 3.0.0 移除)。
  • 2.10.0:YandexTranslate 与 WatsonTranslate(需 key);batching(支持批量端点的端点显著提速);实验性 Utage 支持;TrimAllText/EnableBatching/EnableUIResizing 配置;翻译文件中 = 的转义修复。
  • 2.11.0:Google Cloud Translate 正规 API(需 key);内置约 10000 条日→英静态翻译(UseStaticTranslations),即 StaticTranslations.txt 的来源。
  • 2.12.0:UGUI/Utage 的富文本(rich text)通用支持;UGUI 自定义字体实验;NGUI 缩放行为大幅改进。
  • 2.13.0 ~ 2.14.0:老版本 Unity 引擎支持;NGUI 静态元素的文本捕获能力显著提升。
  • 2.15.0:手动钩取(ALT+U);允许其他插件声明“不要翻译某文本”。
  • 2.16.0:贴图 dump/加载能力(默认关闭,非自动翻译),开启贴图翻译体系的起点。
  • 2.17.0:BingTranslateLegitimate(Azure,需 key);IgnoreTextStartingWith 配置;README 大幅扩充。
  • 2.18.0:Text Getter Compatibility Mode(骗过“读取显示文本做逻辑判断”的游戏,即 TextGetterCompatibilityMode 配置,实现见 TextGetterCompatModeHelper.cs);Live2D 与 SpriteRenderer 贴图支持;插件重启热键。

七、破坏性变更汇总(升级前必读)

以下条目在 CHANGELOG.md 中带有 BREAKING CHANGE/REGRESSION/CHANGE 标记,是对现有翻译包有实际影响的变更:

版本 变更 影响与应对
2.4.0 配置整体重组 旧配置需迁移
3.8.0 空白处理重构;移除 Delay、WhitespaceRemovalStrategy;CacheWhitespaceDifferences 默认 False 手动翻译的空格行为变化(向后兼容)
4.0.0 内部/公开 API 重构(ITranslateEndpoint 不变);Translators 目录结构变化 升级时整体替换 Translators 目录
4.2.0 splitter 正则配置方式变化(支持 scopes) 已有 sr: 配置需按新格式检查
4.5.0 所有默认目录路径变化(新配置文件) 旧翻译包注意路径占位符 {Lang}/{GameExeName}
4.16.0 Text 目录加载顺序:ZIP 最低优先级、ZIP 内文件按字母序;IMGUI 数字处理变化 可能改变同名文件优先级与旧 IMGUI 翻译命中
5.1.0 翻译文件 = 转义由 %3D 改为 \= 含 = 的手动翻译条目需按新转义核对(读取仍兼容 %3D 换行语义)
5.3.0 IL2CPP 跟进 bleeding edge 加载器、放弃更早版本;IL2CPP 放弃 2017 年前的 Unity IL2CPP 用户必须使用新加载器/新构建包

八、完整版本时间线(2.0.0 → 5.6.1 摘要)

为便于检索,这里把 CHANGELOG.md 中全部版本压缩为单行摘要(详细信息见上文各系列章节与原文档):

版本 关键条目摘要
5.6.1 IL2CPP 热键/GUI unstrip 修复(#834)、IL2CPP 字体 asset bundle 修复(#831)
5.6.0 UIElements 支持(#818);Papago JS chunk 模式修复(#820)
5.5.2 DeepL 认证改用 Authorization 头;IL2CPP 字体覆盖失效修复
5.5.1 引入 UnityInput,兼容新旧输入系统
5.5.0 Yandex v2;XUAIGNORETREE;PluginInitialized/PluginInitializationCompleted
5.4.6 ResizeUI 空引用修复;culture 敏感字符串操作改为 invariant/ordinal
5.4.5 NGUI 基础 resizer 支持
5.4.4 NGUI 接入 TextGetterCompat;CallOrigin 程序集检测修复
5.4.3 CustomTranslate 增加 EnableShortDelay/DisableSpamChecks
5.4.2 scoping 失败回退场景 id;Android 配置可读;XZipper 迁移到 SharpCompress
5.4.1 前字体为 null 时换字崩溃修复
5.4.0 TMP 字体覆盖保留 outline;BepInEx 6.0 BE-704;DeepL 语言列表更新
5.3.1 IL2CPP 与 DeepL 端点批量修复
5.3.0 bleeding edge 加载器(IL2CPP);PersistRichTextMode;弃用 2017 前 Unity(IL2CPP)
5.2.0 Lingo Cloud 端点;IL2CPP unhollowed 路径修复
5.1.0 \= 转义(BREAKING);正则替换翻译自动剪枝
5.0.0 IL2CPP(BepInEx 6/MelonLoader);MelonLoader;FallbackFontTextMeshPro;ClipboardDebounceTime;包更名 BepInEx
4.21.0 离线翻译器防滥用/延迟控制;ExtProtocol 端点关闭修复
4.20.1 IMGUI 翻译性能改进
4.20.0 TMP_Overflow / TMP_Alignment 缩放命令
4.19.0 RegexPostProcessing 配置
4.18.1 hook 回调未处理异常修复
4.18.0 AutoResize min/max 字号;按分辨率的翻译文件指令;_Postprocessors.txt
4.17.0 SimpleTextTranslationCache API;默认端点改 GoogleTranslateV2
4.16.3 MaxConcurrency 虚化;未选端点时的异常刷屏修复
4.16.2 DeepLLegitimate 未配置 key 时不可选
4.16.1 DeepL 免费 developer key;解析缓存问题修复
4.16.0 翻译文件加载顺序(BREAKING);IMGUI 数字处理(BREAKING);fallback 端点 UI
4.15.0 DeepL 端点;自动 fallback 端点;ITranslateEndpoint 上下文扩展;HTML 实体解码
4.14.0 GoogleTranslateV2 端点;剪贴板行为调整
4.13.0 外部翻译控制 API;OutputTooLongText;MaxCharactersPerTranslation 上限 2500
4.12.1 Harmony detour bridge 选项;ForceUIResizing 改进
4.12.0 插件专属翻译;2018/2019+ IMGUI 正式支持
4.11.4 Google 备用服务地址;场景扫描修复
4.11.3 程序化翻译的作用域 API;Baidu 日语(ja)修复
4.11.2 Aggregator UI 开关;google/bing/papago 支持 "auto" 源语言
4.11.1 命名/可选捕获组支持;NGUI 钩子空引用修复
4.11.0 文本解析递归;FairyGUI;富文本开关
4.10.0 ezTransXP 原生支持(Ehnd);Linux 改进
4.9.0 TextAsset 手动翻译 API;贴图按需加载;中文变体语言全面支持
4.8.3 ShimejiEngine.dll 支持
4.8.2 UnityInjector 包改用 Harmony 2.0-beta
4.8.1 Google 兼容(进程外)实验端点
4.8.0 TMP 字体经外部 asset bundle 加载;移除 BepInEx 4.x 包
4.7.1 Translators 目录位置规则明确(各安装方式)
4.7.0 文本 preprocessor;SilentMode 默认 true
4.6.4 OutputFile 优先级修复
4.6.3 源语言与目标语言相同时禁用全部端点
4.6.2 Baidu 限速(不超过 1 QPS)
4.6.1 空格差异导致重复翻译修复
4.6.0 重定向资源目录支持 ZIP;自定义启动器路径修复
4.5.1 HTTPS 证书检查默认值修正;Passthrough 端点;上限 1000
4.5.0 默认路径变更(CHANGE);{Lang} 占位符;ZIP 翻译文件
4.4.0 可翻译任意文本;batch 错误冷却 240s→60s
4.3.1 富文本处理修复
4.3.0 UI resize 功能首发
4.2.0 splitter 正则配置重构(CHANGE)
4.1.0 splitter 正则(sr:)首发
4.0.1 日文全角数字转 ASCII 后处理选项
4.0.0 API 重构(BREAKING);Resource Redirection API;进程外翻译
3.8.1 SilentMode;IMGUI 窗口黑名单
3.8.0 TARC 指令;空白处理重构(CHANGE)
3.7.0 3D TextMesh;翻译查询公开 API;MonoMod 取代 Experimental 钩子
3.6.2 全量加载翻译文件;TMP 字体覆盖;老引擎(4.5)支持
3.6.1 部分翻译(GenerateStaticSubstitutionTranslations)
3.6.0 Translation Aggregator(ALT+1);substitutions;Papago
3.5.0 Harmony 2.0 预发布支持
3.4.0 同名贴图资源检测
3.3.1 正则/空格差异缓存选项
3.3.0 TARC 正则格式;空白/换行处理大改
3.2.0 BepInEx 5.x;内部大重构
3.1.0 netstandard2.0 面支持(EnableExperimentalHooks)
3.0.2 UnityInjector 目录结构修复;DisableCertificateValidation 选项
3.0.1 ServicePoint 关闭时机修复;队列上限 3500→4000
3.0.0 游戏内 UI(ALT+0);BingTranslate;LEC 15;自定义翻译器;romaji;batching
2.18.0 TextGetterCompatibilityMode;Live2D/SpriteRenderer 贴图
2.17.0 BingTranslateLegitimate;IgnoreTextStartingWith
2.16.0 贴图 dump/加载(默认关闭)
2.15.4 ForceUIResizing / ResizeUILineSpacingScale
2.15.3 字体覆盖改为作用于所有发现的 Text
2.15.2 外部插件覆盖钩子时不失效
2.15.1 TKK 获取逻辑更新
2.15.0 手动钩取 ALT+U;“不翻译某文本”协作能力
2.14.1 富文本稳定检查前禁止排队
2.14.0 NGUI 静态文本捕获大幅改进
2.13.1 TMP 富文本启用
2.13.0 老 Unity 引擎支持
2.12.0 UGUI/Utage 富文本;NGUI 缩放改进
2.11.0 Google Cloud 正规 API;内置约 1 万条静态翻译
2.10.1 UGUI 大组件文本溢出修复
2.10.0 Yandex/Watson 端点;batching;Utage 实验支持
2.9.1 配置自动迁移
2.9.0 UnityInjector 安装方式;Excite 端点
2.8.0 SSL 随端点能力而定;IMGUI 数字文本
2.7.0 ReiPatcher 独立安装指引;NGUI 修复
2.6.0 新版 Unity(CoreModule 拆分)支持
2.5.0 复制到剪贴板
2.4.1 IMGUI 钩子临时禁用
2.4.0 配置重组(CHANGE);BaiduTranslate
2.3.1 钩子被覆盖时退出游戏的问题修复
2.3.0 SSL 支持
2.2.0 请求级防滥用;HTTP 改用 Unity WWW
2.1.0 文本框架开关;作为其他插件 fallback
2.0.1 配置路径避免与其他 Mod 冲突
2.0.0 Initial release

九、四条贯穿版本史的技术主线

1. 翻译端点生态。从 2.x 的 Google/Bing/百度,到 3.0.0 的自定义端点与 4.0.0 的进程外(ExtProtocol)机制,再到 4.15.0 DeepL、5.2.0 Lingo Cloud、5.5.0 Yandex v2,仓库 src/Translators 目录下每个子项目就是一个端点实现(均实现 ITranslateEndpoint,见 ITranslateEndpoint.cs)。4.0.0 确立的 ITranslateEndpoint 契约在后续所有大版本中保持稳定,这是第三方翻译插件(如 LLM 类端点)能独立演进的原因。

2. 文本框架覆盖。2.1.0 的框架开关 → 2.12.0 富文本 → 4.11.0 FairyGUI → 4.12.0 新版 IMGUI → 5.6.0 UIElements,与 Hooks 目录一一对应(UGUIHooks、NGUIHooks、IMGUIHooks、TextMeshProHooks、TextMeshHooks、FairyGUIHooks、UIElementsHooks、UtageHooks)。每个新框架的接入都遵循同一模式:钩住组件的文本 setter/字段 → 交给统一的 Hook_TextChanged 流水线。

3. IL2CPP 平台线。5.0.0 起步、5.2.0/5.3.0 修路径与跟进加载器、5.4.0 锁定 BE-704、5.5.1/5.6.1 修输入与字体——CHANGELOG 中 IL2CPP 条目密度远高于 Mono,说明它仍是“部分支持”(README 的 IL2CPP Support 一节列出了未覆盖能力,如 TextGetterCompatibilityMode、IMGUI 等)。

4. 手动翻译与再分发工具链。4.x 起,{Lang} 路径(4.5.0)、插件专属翻译(4.12.0)、scoping 指令(3.8.0/4.18.0)、resizer 文件(4.3.0 起)共同构成手动翻译套件;CHANGELOG 中反复出现的“never redistribute with ...”类限制(贴图 dump、OutputUntranslatableText 等)与 README“Regarding Redistribution”章节互为印证——版本历史是理解这些再分发红线何时、为何引入的最直接证据。

十、实践建议

  • 选择安装包:Mono 游戏用 XUnity.AutoTranslator-BepInEx 稳定包;IL2CPP 游戏用 BepInEx-IL2CPP/MelonMod-IL2CPP 包,且加载器必须为 BepInEx bleeding edge 704 一类的新版构建(5.3.0 起旧加载器不再受支持)。
  • 升级翻译包:跨 5.1.0 检查 = 转义(\= vs %3D);跨 4.16.0 检查 ZIP 内文件优先级;跨 4.0.0 整体替换 Translators 目录。
  • 排查问题:按“端点/框架/平台”三轴检索 CHANGELOG,例如“IL2CPP 热键失灵”应同时查 5.5.1 与 5.6.1 两条;“TMP 字体不生效”应查 4.8.0(asset bundle)、5.4.0(outline)、5.5.2(IL2CPP 持久性)与 5.6.1(#831)。
  • 二次开发:实现自定义端点参考 ITranslateEndpoint 与 ITranslationContext.cs;等待插件就绪请用 5.5.0 引入的 AutoTranslatorState.PluginInitializationCompleted;需要整树跳过翻译用 XUAIGNORETREE 命名 GameObject。
登录后查看全文
XUnity.AutoTranslator