SMAPI模组更新器

SMAPI模组更新器

一个独立的(在SV之外运行)模组更新器,它会读取最新的SMAPI日志以查找有哪些模组有可用更新,打开Nexus页面以下载该/那些模组,并在你点击“下载”后将它们安装到你的模组文件夹中。使用手动(慢速)下载,不需要高级账户。

SMAPI Mod Updater



一个跨平台工具,可简化从 [Nexus Mods](https://www.nexusmods.com/stardewvalley) 更新 [Stardew Valley](https://www.stardewvalley.net/) 模组的流程。它会解析 SMAPI 的更新日志,打开下载页面,并自动将下载的更新安装到你的 Mods 文件夹中。注意:对于 Linux 和 Mac OS,请从“Optional Files”部分下载相应的 zip。主文件是 Windows 版本。

## 问题所在

SMAPI 会告诉你哪些模组有可用更新,但实际更新它们意味着要手动访问 Nexus 上每个模组页面、下载文件、解压,并将其复制到正确的文件夹中——而且每个模组都要这样操作。当有 20 多个模组时,这既繁琐又容易出错。

## 这个工具做什么

1. **解析 SMAPI 的日志**,找出哪些模组需要更新
2. **在浏览器中打开所有 Nexus 下载页面**(Files 标签页,已准备好点击“Download”)
3. **监视你的 Downloads 文件夹**,等待新的模组压缩包到达
4. **匹配每个下载文件**,通过读取 zip 内的 `manifest.json` 将其对应到正确的模组
5. **在安装前备份旧版本**(仅保留上一个版本,存储在 `Mods/.backups/` 中)
6. **将新版本解压**到正确的文件夹中,并保留你现有的文件夹结构


你仍然需要在每个 Nexus 页面上点击“Slow Download”(不需要 Nexus Premium),但其他所有事情都已自动化。

## 功能

- **跨平台** — 适用于 Windows、macOS 和 Linux
- **自动检测**你的 Stardew Valley 安装、SMAPI 日志、Mods 文件夹和 Downloads 文件夹
- **多个游戏实例** — 通过下拉菜单在不同的 Stardew 安装之间切换
- **多模组压缩包** — 处理包含多个模组文件夹的 zip(例如,一个 SMAPI 模组 + 一个 Content Patcher 包)
- **现有下载扫描** — 查找你 Downloads 文件夹中已经存在的匹配模组,这样你就不必重新下载
- **版本验证** — 只安装预期版本,跳过你文件夹中的旧下载文件
- **容忍注释的 manifest 解析** — 处理 manifest.json 中 SMAPI 风格的 `/* */` 和 `//` 注释
- **一键备份** — 在安装前自动备份上一个版本
- **会话日志** — 记录所执行的操作,便于排查问题

注意:模组列表下方的“Select”和“Deselect”按钮是全局的。你可以点击每个已列出模组旁的复选框来选择或取消选择该模组。

## 要求

- **SMAPI** — 已安装并至少运行过一次,以便日志文件存在。可从 [smapi.io](https://smapi.io/) 获取。