常见问题

常见问题

下面的回答按 FireSVM V0.2.89.0 的代码和界面整理。排查问题时先确认三项：管理器版本、当前游戏根路径、实际启动的是 StardewModdingAPI.exe 还是 Stardew Valley.exe。

安装与启动

怎么找到游戏根目录？

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

点击一键启动，为什么没有加载模组？

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

1. 设置中的游戏根路径是否正确；
2. 该目录中是否真的有 StardewModdingAPI.exe；
3. 模组管理 → SMAPI管理 是否显示已安装；
4. 模组是否位于这份游戏的 Mods 中且处于启用状态。

怎么从 Steam 启动 SMAPI？

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

"<游戏根目录>\StardewModdingAPI.exe" %command%

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

管理器找不到游戏或提示路径无效？

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

模组安装与更新

把压缩包放进 Mods 为什么没用？

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

Mods\某个模组\manifest.json

为什么提示找不到 manifest.json？

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

为什么已有同名文件夹时不直接覆盖？

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

模组安装成功但列表里没有？

依次检查：

1. 回到模组管理点击 刷新；
2. 设置中的游戏根路径是否与安装目标相同；
3. 实际目录是否包含 manifest.json；
4. 是否误把模组解压成 Mods\模组名\另一个模组名\manifest.json；
5. 是否安装的是不能由管理器识别的 XNB 内容。

更新后备注、标签或组合丢了怎么办？

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

游戏刚更新，所有模组都报错怎么办？

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

下载与一键安装

一键安装找不到模组？

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

为什么流程要求手动下载？

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

Nexus API KEY 和网页登录有什么区别？

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

自动化流程失败后要从头再运行吗？

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

缓存、备份与恢复

缓存可以放在 Mods 里吗？

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

清理缓存会删除哪些东西？

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

模组坏了怎么恢复？

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

存档在哪里？

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

翻译、备注与红字

一键备注会改文件夹名或模组内容吗？

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

一键翻译应该选“缺失”还是“全部”？

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

自动修复可以放心一键执行吗？

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

翻译缺失分析搜不到游戏中的英文？

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

红字终结者和红字自动修复有什么区别？

• 红字终结者：解释你粘贴的 SMAPI 输出，不直接改本地模组。
• 红字自动修复：扫描当前 Mods 并可执行文件修改，使用前必须备份。

反馈问题

求助时要提供什么？

至少提供：

• 管理器、游戏和 SMAPI 版本；
• 设置中的游戏根路径是否指向当前游戏；
• 从什么操作开始、每一步做了什么、预期和实际结果；
• 管理器日志和完整 SMAPI 控制台日志；
• 必要截图，但不要只截半行报错。

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

旧教程和当前界面不一致怎么办？

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