mayflyMods设置全解析：自定义存储路径、主题、开机自启与应用自更新10项实用详解

mayflyMods 是一款基于 Electron + Vue 3 的桌面端 Mod 管理器。本文带你逐项看懂它的设置页：从自定义 Mod 存储路径、深浅主题、开机自启，到应用自更新、aria2 下载引擎等 10 个实用选项，帮你把这款 Mod 管理工具调到最顺手的状态。

打开主界面后进入「系统设置」页，所有选项分为三组：存储与数据、应用偏好、高级选项（见 src/App.vue）。下面按使用频率从高到低逐个拆解。

1️⃣ 自定义 Mod 存储路径

这是设置页第一项，也是最重要的选项之一。

• 作用：你导入的 Mod 会被复制到该目录下的 mods/<gameId>/<modId> 子目录中（设置页说明文案见 src/App.vue）。
• 怎么用：点击「选择」按钮用系统对话框挑一个目录，旁边的文件夹图标可直接打开所在位置。
• 建议：把存储路径放在非系统盘或空间充足的磁盘，Mod 数量多时占用空间不小；切换路径后旧 Mod 缓存不会自动搬迁，请自行迁移。

对应逻辑在 src/stores/library.ts：选择目录后写入 settings.storagePath 并立即持久化。

2️⃣ 数据导入 / 导出：一键迁移全部配置

同样位于「存储与数据」分组（src/App.vue）。

• 导出数据：把游戏库、Mod 清单、配置档案、下载记录、标签等全部应用配置备份成文件。
• 导入数据：在新电脑恢复整套配置，实现「搬家」不丢档。

所有数据统一存放在本地数据文件 mayfly-library.json 中（定义见 src/stores/library.ts），文件位于 Electron 的 userData/data 目录，适合换机前手动备份一次。

3️⃣ 开机自启：让 Mod 管理器随系统启动

「应用偏好」分组中的开关（src/App.vue）。

• 打开后，系统启动时会自动拉起 mayflyMods，适合习惯「开机即进管理器检查更新」的用户。
• 底层调用 Electron 的 setLoginItemSettings 注册登录项，关闭开关即自动注销（实现见 electron/main.ts）。
• 建议：笔记本用户可关闭，避免后台常驻占用内存。

4️⃣ 主题：深色 / 浅色外观切换

mayflyMods 默认采用 Steam 风格的深色主题，同时也支持浅色主题。

• 主题由设置项 theme 控制，取值为 dark（默认）或 light（类型定义见 src/types/domain.ts）。
• 主界面根节点会动态挂载 theme-dark / theme-light 类名（src/App.vue），浅色主题的配色规则写在 src/style.css。
• 主题偏好会随数据文件一起保存，导出数据再导入即可把主题同步到新电脑。

5️⃣ 应用自更新：版本检查、强制更新与默认更新地址

mayflyMods 内置了完整的应用自更新机制，共涉及 3 个层面：

• 默认更新地址：出厂即配置了官方版本清单 JSON 地址（默认值见 src/stores/library.ts），无需手动填写。
• 启动时静默检查：应用初始化 1.5 秒后自动执行一次静默检查，不打扰操作（src/stores/library.ts）。
• 更新弹窗：发现新版本时弹出「发现应用更新」对话框，展示当前版本、新版本号与更新日志；支持「稍后」跳过，若是强制更新版本则必须下载新版后继续使用（弹窗 UI 见 src/App.vue）。

版本比较逻辑按语义化版本号逐段比对，核心实现在 src/stores/library.ts 与 electron/main.ts；代理开启时，更新检查也会走代理（见下文第 10 项）。

6️⃣ 下载引擎：内置下载 vs aria2

在「下载设置」弹窗中可切换下载引擎（src/App.vue）：

引擎	特点	适用场景
内置下载	开箱即用，支持暂停/继续	日常小文件下载
aria2	多线程分片下载，可配置最大连接数（1~16，默认 4）	大文件、高速网络

• 选择 aria2 后需指定 aria2c.exe 路径，留空则自动查找项目资源目录或系统 PATH。
• aria2 由主进程按需拉起独立 RPC 实例，每次随机分配本地端口并带 secret 鉴权（实现见 electron/main.ts、electron/main.ts）。
• 注意：切换引擎只影响新启动的下载任务，进行中的任务继续用原引擎。

7️⃣ 使用软链安装文件

「高级选项」中的第一个开关（src/App.vue）。

• 开启（默认）：把游戏目录中的目标文件创建为指向 Mod 存储目录的软链接，不实际复制文件，省空间且更新 Mod 时无需重新部署。
• 关闭：改为真实复制文件，适合软链权限不足或软链导致游戏报错的情况。

8️⃣ 优先通过目录选择游戏

添加游戏时的交互偏好（src/App.vue）。

• 关闭（默认）：直接选择游戏主程序 exe 文件，适合熟悉游戏目录的用户。
• 开启：改为选择整个游戏目录，应用会自动在目录内（最多 5 层深度）搜索预期主程序文件（逻辑见 src/stores/library.ts），对新手更友好。

9️⃣ 下载完成后自动导入

开关项，默认开启（src/App.vue）。

• 开启后，从 NexusMods 或自定义 URL 下载完成的文件会自动进入 Mod 库，省去手动拖拽导入的步骤。
• 关闭后每次下载结束需手动导入，适合想先甄别文件的用户。

🔟 联网请求使用代理

解决 NexusMods 访问慢或连不上的关键选项（src/App.vue）。

• 开启后，Nexus 浏览、API Key 校验、下载直链、普通下载和应用更新检查全部走代理。
• 代理地址支持 http://、socks5:// 等协议，例如 http://127.0.0.1:7890；只填 127.0.0.1:7890 也会自动补全为 http 协议（见 electron/main.ts）。

其他值得了解的高级选项

选项	说明	位置
开发者工具 (DevTools)	打开 Chrome 调试面板，排查网络与界面问题	src/App.vue
Nexus 内容翻译	支持 Google 免费接口、百度、有道、腾讯云、火山引擎、Ollama 本地模型，译文本地缓存不覆盖原文	src/App.vue
允许游戏运行时修改 Mod	开启后可在游戏未关闭时安装/卸载	src/App.vue
调试模式 / 显示调试信息	输出更详细的运行日志	src/App.vue

所有设置项的默认值集中在 src/stores/library.ts，任何修改都会即时写回本地数据文件，无需重启应用。

常见问题速查

Q：设置会跟随 Mod 一起迁移吗？ 不会单独迁移。用「导出数据 / 导入数据」整体备份，主题、代理、存储路径等设置都会包含在内。

Q：开机自启没生效？ 确认安装版应用（便携版路径变动会影响登录项），或到 Windows「任务管理器 → 启动」中确认 mayflyMods 是否被启用。

Q：提示「请先在设置里填写应用更新地址」？ 说明更新地址为空，检查数据导入是否覆盖了默认值，或手动恢复默认地址（见 src/stores/library.ts）。

总结

mayflyMods 的设置体系围绕「数据、外观、启动、网络、下载」五条线设计：存储路径与数据导入导出管数据，主题管外观，开机自启管启动，代理管网络，下载引擎与自动导入管下载，应用自更新则贯穿始终。按本文 10 项逐一过一遍，你就能把这款 Mod 管理器配置成最适合自己的形态。更多功能细节可参考 docs/feature-checklist.md 与 docs/architecture.md。