AI 自动翻译

《星露谷物语》MOD 全自动翻译工具 MOD 使用指南
【核心介绍】
使用本地 AI 模型（Ollama + Qwen2.5）自动翻译 MOD 的「i18n」语言文件，支持星露谷物语全部 12 种官方语言，无需联网、无 API 限制，5 次点击即可完成完整翻译流程。
【安装指南】
1. 必须先安装前置依赖：在使用本工具前，需同步安装并运行「Ollama」服务；
2. 下载适配模型：打开命令提示符，执行以下任一命令（根据电脑配置选择）：
▸ 推荐配置：`ollama pull qwen2.5:7b`
▸ 低配电脑：`ollama pull qwen2.5:3b`
▸ 高配电脑：`ollama pull qwen2.5:14b`
3. 验证安装：运行 `ollama list` 确认模型已加载，并执行 `ollama run qwen2.5:7b “Hello”` 测试响应；
4. 将本工具程序放入任意目录，无需注册表或系统级安装；
5. 启动工具后，首次运行将自动检测「Ollama」是否在默认端口 11434 正常运行——缺一不可。
【功能详情】
✅ 已优化：
– 自动解压/重新打包「.zip」格式 MOD 包；
– 智能识别并提取 MOD 内所有「i18n」文件（含多语言子目录）；
– 批量翻译并实时显示进度；
– 内置现代化 GUI，支持简体中文、English 等界面语言切换；
– 翻译过程自动保存断点，意外中断后可续译。
❌ 未修改：
– 不修改 MOD 的代码逻辑、游戏机制或资产文件（如「.xnb」「.png」）；
– 不处理未被作者写入「i18n」目录的硬编码文本（如直接写在「Content.json」中的字符串）。
✨ 额外调整：
– 提供翻译速度档位设置（慢/中/快），适配不同硬件性能；
– 所有操作日志本地记录，便于排查问题。
【使用要求】
– 操作系统：Windows 10 / 11（64 位）；
– 内存：最低 4GB RAM（推荐 8GB 及以上，尤其使用 `qwen2.5:7b` 或更高版本时）；
– 必备组件：已安装并正在运行的「Ollama」服务（v0.3.0+），监听端口为 11434；
– 模型：已通过 `ollama pull` 下载至少一个「qwen2.5」系列模型（如 `qwen2.5:3b`）。
【兼容性说明】
– 兼容范围：所有遵循星露谷物语标准结构、将多语言文本存放于「i18n」文件夹内的 MOD（含 SMAPI 1.6+ 格式）；
– 不兼容模组：不兼容将语言文本硬编码在「Content.json」或 C 代码中、且未提供「i18n」目录的 MOD；
– 兼容补丁：暂未推出针对硬编码文本的提取补丁。
【注意事项】
– 翻译质量取决于原始「i18n」文件结构完整性，若作者遗漏键值或格式错误，可能导致部分条目缺失；
– 使用 `qwen2.5:14b` 模型需确保剩余磁盘空间 ≥20GB，且显存/内存充足，否则可能触发 Ollama 崩溃；
– 工具默认连接本地 ` 网址链接如修改过 Ollama 端口，需在工具设置中手动更新；
– 首次运行时若提示“连接失败”，请先确认「Ollama」服务进程（`ollama.exe`）正在后台运行。
【更新日志】
– 2024 年 6 月 15 日新增对 SMAPI 4.0+ 多语言路径规范的支持；
– 2024 年 5 月 22 日增加翻译速度档位控制与实时内存占用提示；
– 2024 年 4 月 8 日修复 ZIP 打包时中文路径乱码问题；
– 2024 年 3 月 30 日初始公开版本发布。