常见问题

Steam 库中右键《星露谷物语》，选择 管理 → 浏览本地文件。打开的文件夹中应直接存在 Stardew Valley.exe；设置中要选这个文件夹，不要选它的上级目录或 Mods。

管理器发现游戏根目录中有 StardewModdingAPI.exe 时启动 SMAPI，否则启动原版 Stardew Valley.exe。检查：

先安装 SMAPI，然后进入 模组管理 → SMAPI管理 → 小贴士，点击 复制 获取针对当前游戏路径生成的启动命令。在 Steam 中右键 Stardew Valley，打开 属性 → 常规 → 启动选项，粘贴命令。命令的结构类似：

游戏移动位置或重新安装 SMAPI 后，应重新复制，不要沿用包含旧路径的命令。

手动选择包含 Stardew Valley.exe 的目录。如果电脑中有 Steam、Xbox 或测试版等多份游戏，自动扫描可能找到的不是你正在使用的那一份；用 打开文件夹 人工核对。

SMAPI 不会直接加载 .zip、.7z 或 .rar。使用 模组管理 → 添加模组 安装，或手动解压，使最终结构类似：

你选择的可能是源码、XNB 替换包、只有汉化文件的补丁，或压缩包外面又套了一层不正确的打包。先查看作者说明。不要随便新建一个假的 manifest.json，那不能把非 SMAPI 内容变成可用模组。

离线安装会在目标已存在时停止，避免把新旧文件混在一起。更新优先使用 检查模组更新 / 一键更新模组；手动更新时先备份旧目录，再按作者说明完整替换。

依次检查：

用管理器的一键更新或自动化流程时，应保留“继承更新前备注 / 标签 / 组合 / 文件夹名称”阶段。手动删除后重新安装不一定能继承这些管理数据，所以更新前也要备份管理器配置数据。

先停止批量重装。依次确认游戏版本、SMAPI 兼容版本和每个核心前置是否已有适配更新。游戏大版本发布后，SMAPI 或模组作者尚未适配是常见情况，重复安装同一旧版本不会解决兼容性问题。

尝试搜索 Nexus Mods 的数字 ID。仍无结果时可以提交收录请求，但在收录完成前要使用离线安装。XNB 模组和单独汉化条目不能作为普通一键安装项加入。

部分下载站或作者文件不允许自动下载，或者需要登录、选择文件和接受协议。按自动化流程显示的网页、文件 ID 和文件名下载；不要随便换成名字相近的旧版本或可选文件。

API KEY 用于授权 API 请求，网页登录用于浏览器下载流程；某个阶段需要哪一种以管理器提示为准。API KEY 属于敏感凭据，不要放进截图、日志或模板。下载慢时先判断是站点限速、线路、浏览器登录还是 API 授权问题，再决定是否重试。

通常不需要。先看失败阶段，用 下载监视 和下载文件夹核对状态，修正问题后点 失败重试。从头重复运行可能造成重复下载、重复备份或再次执行已经完成的删除阶段。

不可以。缓存应位于游戏根目录之外的独立可写文件夹。否则下载、备份和清理缓存可能与真实游戏文件混在一起，管理器也会拒绝部分此类路径。

当前设置页的 清理缓存 会在确认后清理缓存中的 SMAPI 临时目录和下载目录，不等同于重置整个管理器。每次仍要阅读确认框中的实际路径；重要备份不要只放在缓存中。

退出游戏和管理器，通过 常用文件夹及网页 → 模组备份文件夹 找到合适备份。先把当前异常 Mods 改名留存，再恢复一份已知可用的完整备份。启动 SMAPI 验证成功后，再决定是否删除异常副本。

使用 常用文件夹及网页 → 游戏存档目录，不用手工猜路径。自动化引擎入口也提供存档备份与还原。还原存档会影响游戏进度，操作前先复制当前存档。

普通 一键备注 只写管理器备注。只有点击 应用到通用模组配置菜单 时，才会写入 GMCMModNameI18n 的 i18n 文件；它也不会翻译 GMCM 中的配置正文。

第一次使用优先选择 只翻译缺失内容。重新翻译全部内容 可能覆盖作者或汉化组已有表达。开启保存前自动备份，先处理一个模组并进游戏验证，再批量保存。

不能把扫描结果等同于无风险修复。自动修复可能安装、替换、移动或删除文件。先展开每项阅读问题描述和修复方法，取消不理解的项目，备份后逐项修复；确认结果明确时再考虑一键修复。

它只搜索当前 Mods 中可读取的文本文件。文本可能来自游戏本体、XNB、图片、动态拼接，或者管理器指向了另一份游戏。尝试搜索更长且原样的片段，并核对游戏根路径。

至少提供：

日志可从 常用文件夹及网页 → 日志文件夹 打开。发送前移除用户名、私人路径、IP、API KEY、账号令牌和其他秘密。仍无法解决时，使用管理器左下方 问题反馈。

旧版论坛文档（在新窗口打开）包含早期版本的按钮和流程。遇到冲突时，以当前管理器提示和本网站标注版本的文档为准，并在反馈中说明你使用的具体版本。