XUnity.AutoTranslator 版本演进全解析:从 CHANGELOG 追溯 2.0.0 到 5.6.1 的技术脉络
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 在源码中都有明确落点:
- 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阻止该端点被选中。 XUAIGNORETREE标签:允许把整个 GameObject 子树排除在翻译之外。此前只支持XUAIGNORE(仅忽略命中的 GameObject 本身)。实现见 ComponentExtensions.cs:两个常量XuaIgnore = "XUAIGNORE"、XuaIgnoreTree = "XUAIGNORETREE",组件遍历时先检查名称是否包含XUAIGNORE(天然覆盖XUAIGNORETREE),命中XUAIGNORETREE时递归跳过其子级。注意该检查发生在组件创建阶段,运行时改名不会生效(README 的“XUAIGNORE”一节有同样警告)。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-5xDLL,避免加载冲突。 - 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 的 GETfrom/to/text协议)、Watson 升到 v3、romaji输出语言、支持批处理的端点全面 batching;{GameExeName}变量进入配置路径;GameLogTextPaths专门处理“持续追加文本的日志型组件”。 - 3.1.0:
EnableExperimentalHooks支持netstandard2.0API 面(新版 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。