用户可将 Minecraft Mod、资源包或光影包拖入工具，自动识别并提取文本，调用大模型批量翻译、审校并安全导出汉化包。项目基于 Electron 和 React，支持多语言、术语管理、质量检查及人工审核，全程不覆盖原文件。

文件	最后提交记录	最后更新时间
.github	ci: 修复 release 工作流（electron-builder 需显式 --publish never；版本改从 package.json 读取以便手动重跑）	1 天前
SVG	Bump to v1.7.6: settings icon buttons use SVG icons (API key show/hide states + refresh model list)	19 天前
build	Add full Translator MC source: v1.1.0 (drag-drop webUtils fix, new logos, .tmhelp help, security-hardened deps)	1 个月前
help	help: 同步帮助页与图片；同步脚本不再覆盖「使用说明.md」 - help/index.html 与 help/images 与源目录对齐（删除 9 张已废弃图片） - scripts/sync-to-copy.mjs：把「使用说明.md」移出同步清单（它由用户在副本维护，曾被静默覆盖两次）	1 天前
screenshots	更新图片	2 天前
scripts	help: 同步帮助页与图片；同步脚本不再覆盖「使用说明.md」 - help/index.html 与 help/images 与源目录对齐（删除 9 张已废弃图片） - scripts/sync-to-copy.mjs：把「使用说明.md」移出同步清单（它由用户在副本维护，曾被静默覆盖两次）	1 天前
src	v2.1.0：新增「更新」功能（双源检查 / 断点续传下载 / 配置导入导出） - 新增 src/main/update/：双源 Release 检查、Electron net 网络层、断点续传下载器、配置导出导入、偏好 - 新增更新界面：详情弹窗、选源弹窗、进度窗口、侧边栏更新卡片、设置入口 - 网络层改用 Electron net（继承系统代理 / PAC / 企业证书），公司或校园网环境同样可用 - 检查更新不再被单边网络拖慢（单源总时限 10 秒）；同等版本优先上次用过的来源；下载过慢或失败自动换源 - 打开安装包后直接退出应用，把后续交给安装程序 - 新增 .github/workflows/release.yml：打 tag 后自动构建并发布 Release - 版本号 2.0.0 → 2.1.0	1 天前
test-files	Add full Translator MC source: v1.1.0 (drag-drop webUtils fix, new logos, .tmhelp help, security-hardened deps)	1 个月前
.gitattributes	修复 .gitignore 配置，重新上传界面截图	2 天前
.gitignore	修复 .gitignore 配置，重新上传界面截图	2 天前
LICENSE	Initial commit	1 个月前
README.EN.md	Update README and README.EN	2 天前
README.md	Update README and README.EN	2 天前
electron.vite.config.ts	Add full Translator MC source: v1.1.0 (drag-drop webUtils fix, new logos, .tmhelp help, security-hardened deps)	1 个月前
package-lock.json	Bump to v1.7.5: fix known issues (import target language dropped in preload; review cancel/pause now aborts in-flight requests; restore flat-map LLM response tolerance lost in v1.7.1; per-entry clear-translation action; project-scoped history/memory cleanup; stale version strings)	19 天前
package.json	v2.1.0：新增「更新」功能（双源检查 / 断点续传下载 / 配置导入导出） - 新增 src/main/update/：双源 Release 检查、Electron net 网络层、断点续传下载器、配置导出导入、偏好 - 新增更新界面：详情弹窗、选源弹窗、进度窗口、侧边栏更新卡片、设置入口 - 网络层改用 Electron net（继承系统代理 / PAC / 企业证书），公司或校园网环境同样可用 - 检查更新不再被单边网络拖慢（单源总时限 10 秒）；同等版本优先上次用过的来源；下载过慢或失败自动换源 - 打开安装包后直接退出应用，把后续交给安装程序 - 新增 .github/workflows/release.yml：打 tag 后自动构建并发布 Release - 版本号 2.0.0 → 2.1.0	1 天前
postcss.config.js	Add full Translator MC source: v1.1.0 (drag-drop webUtils fix, new logos, .tmhelp help, security-hardened deps)	1 个月前
tailwind.config.js	v2.1.0：新增「更新」功能（双源检查 / 断点续传下载 / 配置导入导出） - 新增 src/main/update/：双源 Release 检查、Electron net 网络层、断点续传下载器、配置导出导入、偏好 - 新增更新界面：详情弹窗、选源弹窗、进度窗口、侧边栏更新卡片、设置入口 - 网络层改用 Electron net（继承系统代理 / PAC / 企业证书），公司或校园网环境同样可用 - 检查更新不再被单边网络拖慢（单源总时限 10 秒）；同等版本优先上次用过的来源；下载过慢或失败自动换源 - 打开安装包后直接退出应用，把后续交给安装程序 - 新增 .github/workflows/release.yml：打 tag 后自动构建并发布 Release - 版本号 2.0.0 → 2.1.0	1 天前
tsconfig.json	Add full Translator MC source: v1.1.0 (drag-drop webUtils fix, new logos, .tmhelp help, security-hardened deps)	1 个月前
tsconfig.node.json	Add full Translator MC source: v1.1.0 (drag-drop webUtils fix, new logos, .tmhelp help, security-hardened deps)	1 个月前
tsconfig.web.json	Add full Translator MC source: v1.1.0 (drag-drop webUtils fix, new logos, .tmhelp help, security-hardened deps)	1 个月前
updatelog.md	v2.1.0：新增「更新」功能（双源检查 / 断点续传下载 / 配置导入导出） - 新增 src/main/update/：双源 Release 检查、Electron net 网络层、断点续传下载器、配置导出导入、偏好 - 新增更新界面：详情弹窗、选源弹窗、进度窗口、侧边栏更新卡片、设置入口 - 网络层改用 Electron net（继承系统代理 / PAC / 企业证书），公司或校园网环境同样可用 - 检查更新不再被单边网络拖慢（单源总时限 10 秒）；同等版本优先上次用过的来源；下载过慢或失败自动换源 - 打开安装包后直接退出应用，把后续交给安装程序 - 新增 .github/workflows/release.yml：打 tag 后自动构建并发布 Release - 版本号 2.0.0 → 2.1.0	1 天前
使用说明.md	更新了源码文件	3 天前

简体中文|English

Translator MC

Minecraft AI 翻译工具 —— 支持对 Minecraft Mod / Resource Pack / Shader Pack 进行AI翻译，Agent 自动分析文件结构、提取文本、调用大模型批量翻译、术语管理、质量检查、人工审核，最后安全导出。

软件特色

界面简洁，新手友好
Mod、资源包、光影包支持
AI精翻
支持自定义翻译模型
完全免费开源

软件截图

图片使用的是jsdelivr+GitHub仓库的图床，加载有时可能较慢，请耐心等待。

主界面：

翻译界面：

翻译记忆：

翻译历史：

运行方法

方式一：直接运行打包好的程序（推荐）

在“发行版”下载最新版本二进制文件，

文件名	文件类型
`Translator-MC-mobile-win-当前版本的版本号.zip`	免安装版
`Translator-MC-Setup-win-当前版本的版本号.exe`	exe安装包

为保证使用体验，请下载使用最新版本应用

方式二：开发模式运行（需要 Node.js 20+）

npm install        # 首次安装依赖
npm run dev        # 启动开发模式（热更新）

方式三：自己重新打包

npm run build:win  # 构建 + 打包 Windows 安装程序（输出到 release/）

核心功能

导入与识别

拖拽导入：支持 .jar / .zip / 目录，可多文件导入。
类型识别：识别 Mod、资源包、光影包。
- Mod：fabric.mod.json / quilt / mods.toml / mcmod.info
- 资源包：pack.mcmeta
- 光影包：shaders/
语言文件解析：适配 JSON / JSON5 / .lang / .properties / YAML / TOML 多种解析器。

翻译与 AI

源语言适配：自动识别日语、韩语、德语、法语、俄语等非英语源语言。
目标语言选择：支持 12 种目标语言，包括简中、繁中、日、韩、英、法、德、俄、西、葡、意等。
AI 批量翻译：多条一批，支持 OpenAI 兼容 API。
多 Provider：内置 OpenAl、DeepSeek、智谱GLM、Moonshot (Kimi)、本地Ollama、LM Studio 的提供商预设。
专用 Prompt：Mod / Shader / Resource Pack 三套独立系统提示词。
上下文翻译：注入包名、分类、术语表、翻译记忆。
翻译记忆：完全相同的原文自动复用。

质量控制

术语表：支持增删改查，注入 Prompt，并进行术语一致性校验。
翻译历史：每次 AI 或人工修改都会记录版本。
占位符校验：校验 %s / %1$s / %d / ${name} / <player> 等占位符。
格式代码保护：保护 §a / §b / §r 等格式代码。
JSON Schema 校验：对 LLM 输出 JSON 进行修复与解析。
AI 质量审校：提供评分、问题、建议。
问题中心：汇总占位符、术语、格式、缺失等问题。

导出

支持导出汉化资源包 zip，以及修改后的 Jar 文件。

界面与效率

支持搜索、筛选、批量选择。
支持主题切换、快捷键、日志查看。

测试

npm run typecheck                 # TypeScript 类型检查
node scripts/selftest.cjs         # 核心逻辑自测（需先 npx esbuild 打包）
npx electron . --selftest         # 全流程端到端自测（导入→识别→提取→入库→导出）