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 日 初始公开版本发布。