XUnityToolkit-WebUI

面向 Unity 游戏汉化 / 翻译工作流的 Windows 桌面工具

一键安装 BepInEx 与 XUnity.AutoTranslator，集成云端大模型、本地 llama.cpp、实时 AI 翻译、字体处理，并提供插件智能诊断 / 自动修复和可直接执行工具箱操作的对话智能体。

下载发布版 · 报告问题 · 功能建议

项目简介

XUnityToolkit-WebUI 适合需要给 Unity 游戏做实时机翻增强、术语约束、翻译记忆、字体修复和插件分发的用户。发布版面向 Windows 10 / 11 x64，开箱即可运行；当你需要从源码开发时，也保留了完整的前后端项目结构。

下载与版本选择

• Full：自包含，附带本地 AI 运行时与常用资源，适合大多数用户。
• No-LLAMA：自包含，只使用云端 API，不附带本地模型运行时。
• Lite：体积最小，需要先安装 .NET 10 运行时。
• 本地 AI 适用环境：NVIDIA 推荐 CUDA，AMD / Intel 推荐 Vulkan；没有独显也可走 CPU。

三分钟快速上手

1. 在 游戏库 中添加游戏目录，工具会检测 Unity 版本、Mono / IL2CPP、架构与可执行文件。
2. 打开 游戏详情页，使用 一键安装 自动部署 BepInEx、XUnity.AutoTranslator、AI 端点与推荐配置。
3. 进入 AI 翻译 页面，配置云端端点，或切换到 本地 AI 使用 llama.cpp 和本地 GGUF 模型。
4. 直接启动游戏开始实时翻译；出现缺字时可使用 字体替换 / 字体生成，已有译文可在 译文编辑器 中校对。
5. 在提供商列表下方统一选择 工具箱智能体使用的提供商，再从左侧打开 工具箱智能体、按需选择游戏并描述目标；智能体会展示实际调用的工具和结果，高影响操作、外部文件读取与脚本执行会等待你确认。

核心能力

• 一键接入翻译框架：自动检测 Unity 游戏，安装 BepInEx 与 XUnity.AutoTranslator，并回写 AI 端点配置。
• 本机连接自愈：首选端口被占用时自动回退，游戏插件通过运行时发现文件重新连接；工具箱重启或实际端口变化后无需手工改 INI。
• Windows 原生窗口：桌面端使用 WinUI 3 + WebView2 原生壳，以 32 epx 空白原生拖动区隐藏重复的窗口标题与图标，同时保留系统窗口按钮、右键系统菜单、Win+Z、Windows 11 分屏布局与贴靠组；业务网页和浏览器访问方式保持一致。
• 云端 AI 翻译：支持 OpenAI、Claude、Gemini、DeepSeek、Qwen、GLM、Kimi 与自定义 OpenAI 兼容接口；OpenAI、DeepSeek、Qwen 及兼容服务可选 Responses API，并可按端点关闭或调整思考强度。
• 本地 AI 模式：内置 llama.cpp，支持 HuggingFace / ModelScope 下载模型，也支持导入自有 GGUF。
• 统一术语与翻译记忆：支持术语约束、精确/模糊翻译记忆与分阶段术语审查。
• 字体与插件工具链：支持 TMP + Legacy Font 替换、SDF 字体生成、AI 驱动的 BepInEx 插件智能诊断、插件包导入导出与在线更新。
• 可操作的工具箱智能体（测试版）：在不离开当前页面的悬浮对话窗中，用自然语言检查或操作游戏库、安装、配置、术语、译文、字体、插件、日志、更新与本地模型；也可读取环境信息、经确认运行诊断脚本，并在可信目录内管理文件。提供商在 AI 设置中统一配置。
• 插件全自动修复：诊断后不再只给建议；工具箱会让云端 AI 生成受限修复计划，先备份目标文件，再修复工具箱组件/路由、补丁式修改 INI/CFG 或禁用有明确证据的问题插件，最后重新诊断。

智能体功能

项目现在统一使用一个 工具箱智能体。左侧悬浮窗提供通用对话与实际操作；游戏详情页和 BepInEx 日志页保留“智能诊断 / 自动修复”快捷入口，但它们复用同一个提供商设置、端点解析、证据诊断与工具执行体系，不再是另一套独立智能体。

工具箱智能体（测试版）

工具箱智能体不是单纯的问答窗口。可拖动、最小化的悬浮窗会先理解目标，再通过白名单内的本机工具和现有 API 读取状态、执行操作，并把每次工具调用的成功、失败、跳过或待确认状态显示在对话中。操作完成后，游戏库与界面偏好会主动刷新。

使用时先在 AI 翻译 页面配置并启用至少一个有效的云端端点，然后：

1. 在 AI 翻译 → AI 提供商 下方，把智能体提供商设为“自动”（选择最高优先级的有效云端端点），或固定到某个端点；固定端点失效时会停止并要求重新配置，不会回退。
2. 从左侧导航打开 工具箱智能体。悬浮窗不再单独选择提供商。
3. 按需选择当前游戏，输入希望得到的最终结果；字体、插件包、配置或图片等任务可先上传附件。
4. 查看智能体实际执行的工具记录。高影响操作会暂停；同一目的的可信目录文件变更会合并为一个批次确认，外部目录 / 文件 / 分块读取和每个脚本则逐次确认。
5. 后续可从历史抽屉继续原对话，或删除单条 / 全部历史。

可以直接尝试这些指令：

• 检查当前游戏的插件状态，有明确问题就自动修复。
• 把 Captain 加到当前游戏的术语表，固定翻译为“船长”。
• 上传 TTF / OTF 后说：把这个字体作为运行时 TMP 回退字体。（会要求确认，不会自动改写游戏资源。）
• 上传 ZIP 后说：把这个插件包导入当前游戏。
• 检查本地模型服务；如果没有启动就帮我启动。
• 读取显卡、系统代理和工具箱日志，分析为什么插件无法连接；不要修改系统。

插件智能诊断与自动修复

• 打开游戏详情或 BepInEx 日志页只会刷新本地客观检查，不会自动请求模型，也不会产生隐藏的 AI 费用。
• 手动点击 智能诊断 后，第一阶段先让工具箱智能体从候选资料清单中选择必要证据，第二阶段才分析可信游戏目录中选定的带行号原始日志、配置与元数据；报告会区分客观检查和 AI 判断，证据变化后旧报告会标记为过期。
• 启动并智能诊断 会先短暂启动游戏，等待新的 BepInEx 日志与工具箱 ping，再进入同一诊断流程。
• AI 全自动修复 只有在后端检测到确定性修复项，或本次 AI 报告存在中 / 高置信度且有有效证据的警告 / 错误时才显示；它只执行受限计划，写入前创建备份，完成后重新检查。这里的专用备份规则不受通用文件工具“默认不备份”影响。
• 若云端 AI 不可用或诊断失败，界面只保留可验证的本地事实，不会用旧规则或预制建议冒充 AI 结论。

云端、数据与安全边界

• 工具箱对话、插件诊断和修复规划统一使用设置页选定的云端端点，且独立于实时翻译总开关和本地 / 云端模式；因此普通翻译使用本地 llama.cpp 或暂时关闭时仍可显式运行智能体。智能体不会改用本地模型，多阶段调用可能产生 API 费用。
• 工具箱智能体最多保留最近 100 个本地对话，每个对话最多展示最近 200 条消息；历史记录可恢复和删除，但待确认操作不会跨重启保留。
• 附件支持字体、TMP Bundle、DLL / ZIP、常见文本配置和 PNG / JPEG / WebP 图片；一次最多 8 个，单个不超过 50 MB，每个会话合计不超过 150 MB。临时附件约保留 6 小时，历史中只长期保存附件信息，过期后需要重新上传。
• 附件二进制不会直接发送给模型，图片附件用于本地图标 / 封面 / 背景工具。二进制读取只提供哈希、签名、PE / 程序集引用、ZIP 清单等被动元数据或有限十六进制块，不会在工具箱进程中加载用户程序集。
• 所有已添加游戏目录和完整工具箱数据目录属于可信根：模型可直接取得其中的原始内容与绝对路径；通用文件变更必须经批次确认，可操作任意扩展名且默认不备份。可信根以外只能读取，每次目录、文件或分块读取都要确认，确认后原文和路径会发送到所选提供商。
• PowerShell / CMD 脚本必须展示具体用途、完整命令、超时与风险并逐次确认，只以当前用户权限运行、不提权。脚本“只能读取和诊断”由系统提示词约束，后端无法技术性保证脚本绝对只读；因此不要确认不理解的命令。智能体只能给出系统 / 外部环境修复方案，最终由用户自行执行。
• API Key / Token 与完整设置仍不交给模型。清空全部工具箱数据使用专用退出后助手，不创建备份并自动重启；它只删除工具箱数据根，不删除已添加游戏目录。

完整教程（点击展开）

1. 添加游戏与安装翻译插件

• 游戏库支持单个添加，也支持批量扫描目录中的 Unity 游戏。
• 游戏详情页会展示 Unity 版本、脚本后端、架构、插件状态和快捷操作。
• 一键安装 会按顺序处理翻译框架部署、AI 端点写入、推荐配置应用与本地验证；安装流程只检查文件、新启动日志和工具箱 ping，不会调用模型或产生隐藏的 AI 费用。

2. 配置 AI 翻译

• 云端模式：在 AI 翻译 页面添加端点，支持 API 格式、思考模式/强度、优先级、启停、模型名和连通性测试。
• Responses API：OpenAI、DeepSeek 与 Qwen 新端点默认使用 Responses；旧端点继续保留 Chat Completions，避免升级后静默改变请求格式。
• 关闭思考：DeepSeek V4、OpenAI GPT-5.6、Qwen、GLM、Claude Sonnet 5 与 Kimi K2.6 会发送各自真实的关闭参数。Gemini 3 目前只能降到 minimal，Kimi K3 属于强制思考模型。
• 本地模式：切换到本地 AI 后，可根据显卡情况选择模型、下载运行时、启动 llama.cpp 服务。
• 如果你只想用自建兼容接口，可以直接使用 Custom（OpenAI 兼容）。

3. 字体替换与字体生成

• 新安装默认部署 XUnityToolkit.RuntimeFontLoader：优先直接从思源黑体 TTF 创建动态 TMP 字体，并作为全局回退保留原游戏字体风格；也可切换为“全部 TMP 文本替换”。
• 如果游戏的 TMP 不提供文件路径创建 API，内置思源黑体会自动使用匹配 Unity 版本的兼容 TMP AssetBundle；自定义字体不会静默换成内置字体，而会显示错误并提供“生成兼容 TMP 资产”入口。
• 字体替换支持 TMP 与 Legacy Font 两类资源。
• 可直接使用内置替换源，也可以上传自定义 TMP / TTF / OTF 资源。
• 字体生成页可基于 TTF / OTF 生成 TMP SDF 字体，并按字符集输出结果。

4. 术语、翻译编辑与插件包

• 术语编辑器：管理翻译术语、禁翻词、分类、优先级与正则匹配。
• 翻译编辑器：对 AI 输出做人工校对，并支持导入 / 导出。
• 插件包导入导出：打包当前游戏的翻译插件、缓存与配置，便于分发给其他玩家。
• 智能体辅助：可直接让工具箱智能体管理术语、译文或插件包，也可从游戏详情 / 日志页启动专项诊断；完整能力与安全边界见上方的 智能体功能。

常见问题

dotnet build XUnityToolkit-WebUI/XUnityToolkit-WebUI.csproj
dotnet build XUnityToolkit-WebUI/XUnityToolkit-WebUI.csproj -p:SkipFrontendBuild=true
dotnet run --project XUnityToolkit-WebUI/XUnityToolkit-WebUI.csproj

cd XUnityToolkit-Vue
npm run dev
npm run build
npx vue-tsc --build

cd ..
.\build.ps1
.\build.ps1 -SkipDownload

许可证

本项目基于 MIT License 开源。