XUnityToolkit

XUnity 汉化一体化工具箱

---

📖 项目简介

XUnityToolkit 是一款基于 WinUI 3 开发的 XUnity 游戏汉化插件一体化桌面工具。

本工具集成了AI 翻译工具和插件自动化安装器两大核心模块，旨在简化 XUnity 插件的汉化流程，提升翻译效率和质量。

---

✨ 核心功能

🌐 AI 翻译模块

• 实时翻译监控：自动监控游戏翻译文件变化，实时翻译新增文本
• 多 API 负载均衡：支持多个翻译 API 端点配置，自动负载均衡和故障转移
• 高并发通道架构：Channel + 多消费者（最高 100 并发），优雅关闭无异常风暴
• 智能术语管理：
  • 支持多术语库文件管理
  • AI 智能术语提取功能
  • 术语库导入/导出（CSV 格式）
  • 实时术语应用和上下文引用（三阶段版本同步机制）
• 上下文感知翻译：支持翻译历史记录，提供更准确的上下文翻译

🔧 插件安装器模块

• 一键安装：自动检测 Unity 版本，智能选择适配的 BepInEx 版本
• 版本管理：
  • 支持 BepInEx 和 XUnity.AutoTranslator 版本切换
  • 本地缓存管理，避免重复下载
  • 支持 GitHub 和 WebDAV 镜像源
• 配置编辑器：可视化编辑 BepInEx 和插件配置文件
• 字体下载：一键下载并安装 TextMeshPro 字体，解决游戏中文显示问题
• 字体资产修改：一键替换 TextMeshPro 默认字体 “LiberationSans SDF”，同时支持 MonoBehaviour / Texture2D / Material 三类资产

---

💻 系统要求

• 操作系统：Windows 10 版本 17763 或更高
• 运行时：
  • .NET 9 桌面运行时 (10.0.26100.0 或更高)
  • Windows App SDK Runtime 1.8.x
• 平台支持：x64、x86、ARM64

---

🚀 快速开始

安装运行时（首次使用）

1. 下载并安装 .NET 9 桌面运行时
2. 下载并安装 Windows App SDK Runtime

下载与运行

1. 前往 Releases 页面
2. 根据系统架构下载对应的压缩包：
   • XUnityToolkit-x64.zip（64位系统，推荐）
   • XUnityToolkit-x86.zip（32位系统）
   • XUnityToolkit-arm64.zip（ARM64 系统）
3. 解压后直接运行 XUnityToolkit.exe

首次使用指引

1. 安装 BepInEx：在"安装插件"页面选择游戏目录，点击安装
2. 配置 API：在"API 配置"页面添加翻译 API 端点
3. 管理术语库：在"术语库"页面导入或创建自定义术语
4. 开始翻译：在"AI翻译"页面启用实时监控或发起后台预翻译

---

🔨 开发者指南

环境准备

• .NET 9.0 SDK
• Visual Studio 2022（推荐安装 WinUI 3 工作负载）
• Windows 10 SDK (10.0.26100.0)

克隆仓库

git clone https://github.com/HanFengRuYue/XUnityToolkit.git
cd XUnityToolkit

构建项目

注意：项目采用嵌套目录结构，需要进入内层目录

cd XUnityToolkit

# 调试构建
dotnet build

# 运行
dotnet run

发布版本

方式一：使用自动化脚本（推荐）

# 从仓库根目录运行
.\Build-Release.ps1

# 跳过清理步骤
.\Build-Release.ps1 -SkipClean

脚本会自动：

• 验证必要工具（dotnet CLI、7-Zip）
• 构建所有三个平台版本
• 创建压缩包
• 输出到 Releases/ 目录

方式二：手动发布

cd XUnityToolkit

# x64 平台
dotnet publish -c Release -r win-x64

# x86 平台
dotnet publish -c Release -r win-x86

# ARM64 平台
dotnet publish -c Release -r win-arm64

---

🛠️ 技术栈

• UI 框架：WinUI 3 (Windows App SDK 1.8.251003001)
• 运行时：.NET 9.0
• MVVM 工具：CommunityToolkit.Mvvm 8.3.2
• 依赖注入：Microsoft.Extensions.DependencyInjection 9.0.10
• Unity 资源解析：AssetsTools.NET 3.0.2（含 Cpp2IL、MonoCecil）
• 压缩处理：SharpCompress 0.41.0
• CSV 处理：CsvHelper 33.1.0
• WebDAV 客户端：WebDav.Client 2.9.0
• 数据加密：System.Security.Cryptography.ProtectedData 9.0.10
• UI 控件：CommunityToolkit.WinUI.UI.Controls.DataGrid 7.1.2
• 图像解码：StbImageSharp 2.27.13

---

📄 许可证

本项目采用 MIT License 开源协议。

---

🙏 致谢

本项目的开发离不开以下优秀的开源项目：

• BepInEx - Unity 游戏 Mod 框架
• XUnity.AutoTranslator - Unity 游戏自动翻译插件
• AssetsTools.NET - Unity 资源文件解析库
• SharpCompress - 压缩文件处理库
• CsvHelper - CSV 文件读写库
• CommunityToolkit - MVVM 和 UI 工具集

---

如果这个项目对你有帮助，请给它一个 ⭐ Star！

报告问题 • 功能建议