💬 QQ 群：1045239747（加群验证答案 jing_hy）—— 不方便用 GitHub、或者想直接问，都可以在群里发诊断包；发的时候记得附上现象（什么时候出的、你点了什么、屏幕上看到什么）。
《明日方舟：终末地》的一站式 Mod 管理器：把 DLSS5 神经渲染 + 第一人称视角 + 服装 Mod（EFMI）+ 乳摇物理 + 摆姿 / MMD 播放 统一到一次「一键启动」里；运行环境从零自动装好，零配置启动即用。
Windows 桌面程序（Python + Pywebview），单文件 exe。当前版本 0.9.5 —— 下载最新版
📖 安装细节、目录结构、逐项故障排查、开发与发布流程 → 详细文档
| 能力 | 说明 |
|---|---|
| 从零装好环境 | 首次启动自动下载安装 XXMI Launcher、XXMI Libraries、EFMI 三个组件（带校验），装完写好配置 |
| Mod 库管理 | 把压缩包（.zip / .7z / .rar）拖到页面任意处即可导入；自动解压并尝试识别角色（中文名、社区昵称、英文代号、拼音都认），认不出就弹窗让你选（下拉已按"最可能的角色"预选）；卡片「⋯」里可随时更换 Mod 归属 |
| 自动备份你的 Mod | 程序旁边会有一个 Mod 备份文件夹：只要库里出现新导入的 Mod，就自动把它整份复制进去（不压缩）。这个文件夹只增不减 —— 程序从不删除、不覆盖里面的任何文件（想清就自己去删）。设置页能看到备份数量与占用，也能一键打开它 |
| 同角色互斥 | 同一个角色只保留一个 Mod —— 同时加载两个同角色 Mod 会把游戏搞崩（确认不冲突的组合，可以在 Mod 库页用「强行关闭角色 Mod 互斥」拨钮放行） |
| 一键启动 | 维护注入库、补齐缺失组件、跑完整初始化自检，然后拉起 XXMI |
| 插件开关 | DLSS5、第一人称、服装 Mod、乳摇都能单独开关（靠移动文件实现，可逆） |
| Mod 下载 | Mod 库页点「下载 Mod」，粘贴直链（一行一个）→ 并行下载（每个任务内部还会按需并发分块、自动换线路）→ 能解压的（zip / 7z / rar）自动解压进库并识别角色；不能解压的留在临时目录并告诉你路径（附「打开下载目录」），你手动解压后拖进库即可。香蕉网（GameBanana）链接直接支持：粘页面地址就自动换成真实文件直链、带出封面图和作者版本信息；访问不上（需要代理的常见情况）会弹窗提示检查 VPN |
| Mod 快捷键锁定 | 默认开启。把 Mod 的自带按键统一收归游戏内的面板（进游戏按 Home → ModeController 页）：按角色 / Mod 分栏，每一项就是一个按钮 —— 点一下 = 切到下一档。为什么要锁：Mod 之间常常抢同一个键（好几个都用 →/←/↓），上锁后从面板调整就不会撞键；面板走内部通道，不碰游戏自己的按键。关掉开关 = 一个键都不改写（可随时还原） |
| 启动前风险确认 | 在拉起游戏之前先查"这套 Mod 会不会崩"（资源冲突 + 过去崩过的组合），有风险就说清是什么冲突，由你决定要不要继续 |
| 崩溃归因 | 崩了会区分"Mod 资源冲突"与其它原因：是皮肤冲突的话，弹窗里能一组一个下拉框选要保留的 Mod、一键关掉其余的（只改勾选，不动你的文件）；同时生成一份带完整现场的诊断包，直接发 issue 或 QQ 群即可 |
| Mod 修复 / 回滚（实验性） | 游戏版本更新后老 Mod 常需适配，在 Mod 卡片上就能一键修；改前自动整份备份、可一键回滚 |
| 游戏目录净化 / 还原 | 把第三方注入物先备份再移走，随时一键还原；被移走的系统模块会自动补回 |
| 更新 | 程序本体与各组件都能检查、更新 |
| 文件被反复删除会提醒你 | 关键组件被安全软件（Windows Defender / 360 / 火绒）隔离时，启动时会告诉你是哪个文件、该把哪个目录加入白名单 |
| 摆姿 / MMD 播放（可选） | 集成 Endfield Poser，用它自带的页面摆姿势、放 MMD |
一次「一键启动」做四件事：补齐运行环境 → 维护注入库 → 跑初始化自检 → 拉起 XXMI；你只需要在 XXMI 界面点 Start。
游戏进程里同时存在这些东西，全部由注入库决定：
唯一的一个 ReShade 底座
├─ DLSS5 神经渲染
├─ 第一人称 / 相机
├─ 面板汉化
├─ 喂帧组件（给 DLSS5 提供颜色 / 运动矢量 / 深度）
└─ 后处理 shader
服装 Mod 引擎（EFMI）
乳摇注入代理
摆姿 / MMD 注入代理（可选）
三条关键设计：
- 一个游戏进程只能有一个 ReShade 底座 —— 所以本程序把 DLSS5 与第一人称合到同一个底座上，不会塞两份；这也是"两个整合包混着用必崩"的原因。
- 不改游戏本体 —— 写进游戏目录的都是注入类文件，改动前一律先备份、随时一键还原；游戏本体、资源、存档一律不碰。
- 不内置 Mod —— Mod 都是你自己放进去的；程序负责解压、识别角色、同角色互斥，以及在启动前把可能崩的组合拦下来。
- 到 Release 下载
EndfieldModController.exe（同页还有一个assets-bundle.zip，首次启动会自动下载）； - 放到你有写权限的普通目录再双击 —— 别放
Program Files这类只读目录，也别放临时目录（程序的数据与你的 Mod 库就在 exe 旁边）； - 点「一键启动」。第一次可能提示"请再点一次"（那是让 XXMI 先生成它自己的配置），照提示来即可。
之后进游戏就行：DLSS5 不需要任何手动配置，看 ReShade 面板里的「成功NR帧」涨起来就是生效了。
- Mod 库页：把压缩包（
.zip/.7z/.rar）拖进来即导入；勾选（同角色自动互斥）后点「生成控制器」。每个 Mod 卡片右下角有「⋯」，鼠标移上去即可修复 / 回滚 / 打开所在文件夹 / 移出库。 - 启动页：一个大号「一键启动」+ 几个插件开关（DLSS5 / 第一人称 / 服装 Mod / 乳摇 / 摆姿 / 游戏内 Mod 面板）+ 日志窗。
- 设置页：自检、组件更新、诊断包、游戏目录还原、路径与外观等都在这里。
- 摆姿 / MMD（可选）：游戏运行时可以用它自带的页面摆姿势、放 MMD。
Mod 自带的按键各不相同（←、Ctrl+5、Alt 0…），装多了不仅容易记混，还常常互相抢同一个键——好几个 Mod 都用 →/←/↓，手按时谁被触发说不清。启动页的「Mod 快捷键锁定」默认就是开的，打开时：
- 下次「一键启动」把 Mod 的自带按键锁定（原始的
key =行可一键还原），并把统一面板放进 ReShade； - 进游戏按
Home打开 ReShade 面板，切到 ModeController 页 —— 按角色 / Mod 分栏，每一项就是一个按钮：点一下 = 切到下一档，从面板调整就不会撞键。面板不假装知道当前档位（那个状态活在游戏里），所以这里没有开关、也没有滑块；每项旁边写着它控制的变量、这一项原本的键（已锁定）和生效条件； - 想连切几档就连点几下；点完面板不会自己关掉。
面板走的是内部通道（F13–F24，键盘上不存在的键 + 把切档逻辑注入到 Mod 自己的 ini 里），所以不碰游戏自己的按键，也不会误触发别的东西。把开关关掉就完全放手：一个键都不改写，手按原键照常（panel_info.txt 里的 takeover 会变成 0）。面板装不上时它会说明原因，并且不会锁键（不允许出现"锁了键却没面板"）。
Q：DLSS5 面板显示开着，但「成功NR帧」不动？ 先看启动日志里自检有没有报错；再确认游戏内超分选的是 DLSS（选 FSR / XeSS 时神经渲染不会绑定）。更细的排查顺序见详细文档。
Q：DLSS5 的开关默认是关的 / 想打开被拒绝了？ 说明你的显卡是 RTX 40 系（或更早）。DLSS5 神经渲染首发只支持 RTX 50 系（英伟达已表示后续会扩展到 40 系，但目前驱动/运行库还没放开），40 系机器上它一帧也出不来 —— 所以程序默认帮你关掉、也不让你打开，免得你以为装坏了去折腾（分辨率、驱动、重装都是白费）。等官方放开之后更新一下版本就能用了。
Q：游戏崩了 / 加载中闪退？ 程序会生成崩溃包并给出归因：如果是 Mod 资源冲突，弹窗会直接列出是哪两个 Mod，去 Mod 库取消勾选其中一个再启动即可；其它原因也会带上完整现场，把崩溃包发到 Issues 就能定位。
Q：第一次点「一键启动」被提示"再点一次"？ 正常 —— XXMI 的配置要它自己跑一次才会生成，程序先替你拉起来生成，再点一次就好。
Q：Mod 装了很多，进游戏没生效？ 先确认对应开关是开的（服装 Mod / 乳摇 / DLSS5 各自独立），再看自检结果；同一角色只会保留一个 Mod，勾选后记得点「生成控制器」。
Q：游戏版本更新后老 Mod 失效？ 用 Mod 卡片「⋯」里的「修复」（实验性）——它会适配资源槽位号，改前自动备份、可一键回滚。
Q：自检或「修复」老是说某几个文件缺失，补上以后又缺？ 多半是安全软件把它们隔离了（最常见的是 DLSS5 的 NR 运行库那种大文件）。程序每次启动都会记一次"这些关键文件在不在"，连续几次发现同一个文件不见了时，你点「一键启动」就会先弹窗告诉你具体是哪个文件、并把该加入白名单的目录列出来；加完白名单再点一次「一键启动」，缺的文件会自动补回来。
Q：我本来就有另一份装好 Mod 的 XXMI，想继续用它？ 可以。在设置里把 XXMI 指到你那份、把 Mod 的中转目录也指到那份，并关掉"用内置运行环境"这一项 —— 之后程序既不会下载/更新自带那份，也不会改你填的路径。想换回来就反向操作。
Q：启动时弹的「公告」，或者点一键启动前的红色预警是什么？ 那是作者通过项目仓库下发的通知。公告用于发布重大信息，看完关掉就行；异常状态预警（例如出现大规模封号）会在你点「一键启动」时先强制停留几秒，再请你三选一：还原配置（关掉全部注入并清理游戏目录，随时可撤销）、保持配置但不启动、仍然启动。它只在联网时检查，拉不到就静默跳过，不影响使用。
本程序只做分发与编排，不修改任何组件的源码，版权归各自作者：
| 组件 | 用途 | 许可 |
|---|---|---|
| XXMI Launcher / XXMI Libraries / EFMI | 注入器与服装 Mod 引擎 | MIT |
| 3DMigoto | EFMI 的底座 | MIT |
| ReShade | 后处理底座（Addon 版） | BSD-3 |
| RenoDX / Endfield Enhancer | DLSS5 神经渲染 / 第一人称（英文原版） | MIT |
| 第一人称中文补丁 —— B站 up 主 Hirahido | 第一人称面板的中文版 | 版权归原作者 |
| iMMERSE（Marty's Mods） | ReShade 后处理链 | MIT |
| DLSS 5 Feed | 给 DLSS5 喂颜色 / 运动矢量 / 深度 | 见其说明（无公开仓库） |
| SecondaryMotion（乳摇） | 物理效果 | 见上游仓库 |
| Endfield Poser | 摆姿 / MMD 播放（可选） | AGPL-3.0 —— 不随包分发，只从官方 Release 下载并调用它自己的安装向导 |
| Endfield PS-T DrawSection Fix（实验性） | 修老 Mod | B站 up 主 可可HXL《终末地Mod修复工具包》v1.5；版权归原作者，随包分发 |
| NVIDIA NGX 运行库 | DLSS 与神经渲染 | NVIDIA 版权，随包仅为免去手动下载 |
特别声明：随包分发的第一人称中文补丁由 B站 up 主 Hirahido 制作，版权归其所有；Mod 修复工具由 B站 up 主 可可HXL 制作，版权归其所有。本程序只做分发与安装编排、不修改其内容 —— 两位作者若不希望被随包分发，请在 issue 里说明，我们会立即移除。
本项目自身为 MIT 许可。
- 本程序不是官方工具，与鹰角网络 / Hypergryph 无关。
- 使用 Mod 可能违反游戏用户协议，风险由使用者自负；请自行确认你所在环境的规则。
- 程序会读写游戏目录中的注入类文件，但一律先备份、并提供一键还原；不会修改游戏本体、资源与存档。
- 第三方组件由其原作者维护，相关问题请先到对应仓库反馈；本程序的集成问题欢迎开 issue。
出问题时，程序里（设置页最上方「一键导出诊断包」、崩溃弹窗、日志窗的「导出诊断包」）都能一键把日志与设备信息打包，导出后会告诉你怎么发。两条路都可以：
| 方式 | 怎么用 |
|---|---|
| GitHub issue | 到 Issues 发帖，把诊断包 zip 拖进正文 |
| QQ 群 | 群号 1045239747，加群验证答案 jing_hy；不方便用 GitHub 就在群里发 |
两种方式都请附上「现象」：什么时候出现的、你点了什么、屏幕上看到什么（报错原文或截图）。诊断包里只有日志与设备信息，没有"你做了什么"这一层，缺了现象往往要把几轮问答才能定位。
需要安装细节、目录结构、逐项故障排查、开发与发布流程 → 详细文档