[SPT 4.1.2] MemoryGuard 内存优化包

> 适用：SPT 4.1.2（4.1.3 目录通用）

> 纯底层资源管理，**不修改任何游戏数值**。

 ■ 它解决什么问题

SPT/EFT 客户端存在官方确认的内存泄漏：长战局内存持续上涨，官方只在”打开仓库界面”时做 25ms 增量 GC，战局中与场景切换时从不清理；AssetBundle 只在回主菜单时才卸载，藏身处/战局间全程常驻。

本包接管了内存治理调度，并按场景分级清理。

 ■ 包含两个版本（按需选择）

### 标准版（推荐，6 项优化，不改任何画质）

1. 回藏身处/主菜单主动卸载 AssetBundle（官方只在回主菜单才卸载）

2. 战局内每 5 分钟定时增量 GC（25ms 预算，不卡顿）

3. 内存增长监控：10 秒采样，异常增长 >250MB 自动提前清理

4. 定期卸载未用资源（每 15 分钟）

5. 退出战局全面清理（残留 bundle 卸载 + 全量 GC）

6. 服务端存档间隔 60s→120s（降低序列化 CPU 尖峰）

### 超级版（8 项优化，显存优先）

在标准版基础上额外开启：

– MipStreaming 纹理流送（显存 -30%~50%，按显存预算动态调度 mip）

– 流送缓冲 32→128MB

※ 注意：超级版会极大的降低贴图观感，更在意画质的请用标准版。

■ 分级清理设计（标准版/超级版均有）

| 场景 | 行为 |

|—|—|

| 进入藏身处 | 不清理（藏身处加载密集，清理会加重卡顿） |

| 进入主菜单 | 大清理（卸载 AssetBundle + 全量 GC） |

| 仓库界面 | 中清理（增量 GC 100ms + 卸载未用资源，无感） |

| 战局内打开背包 | 交由官方 25ms 增量 GC，不重复 |

| 战局结束（GameWorld 销毁） | 大清理（加载界面，卡顿可接受） |

 ■ 明确不碰的东西

AI 数量 / AI 逻辑 / 战利品数量 / 游戏内画质档位 / 图形滤镜 / 分辨率 —— 全部保持原样。

■ 安装（1 分钟）

1. 解压对应版本的压缩包，得到 `BepInEx` 和 `SPT_Runtime` 两个文件夹

2. 整体拖进 SPT 4.1.2 游戏根目录覆盖合并（只新增/覆盖对应文件，不影响其他 mod）

3. 先启动 `SPT_Runtime\SPT.Server.exe`，再启动 `SPT_Runtime\SPT.Launcher.exe` 进游戏

 ■ 验证生效

游戏目录 `BepInEx\LogOutput.log` 搜 “MemoryGuard”：
“`

Loading: SPT.MemoryGuard

All MemoryGuard patches enabled

MemoryGuardRuntime scheduler attached

进入战局 5 分钟后 → [MemoryGuard] Incremental GC executed (reason: scheduled)

退出战局 → [MemoryGuard] Full cleanup (raid-end) completed

“`

■ 配置（可选）

游戏启动一次后自动生成 `BepInEx\config\com.spt.memoryguard.cfg`：

| 配置项 | 默认 | 说明 |

|—|—|—|

| GcIntervalMinutes | 5 | 战局内定时 GC 间隔（分钟），0=关闭 |

| GrowthThresholdMb | 250 | 内存增长触发阈值（MB），0=关闭 |

| UnloadIntervalMinutes | 15 | 定期卸载间隔（分钟），0=关闭 |

| CleanupOnRaidEnd | true | 退出战局全面清理 |

| Enabled | true | 总开关 |

■ 卸载

删除 `BepInEx\plugins\MemoryGuard\` 即可；被覆盖的 2 个配置可手动还原（详见包内说明）。

 ■ 实测数据（R9 + RTX 4060 8G + 16G 内存）

– 战局内内存增长明显趋缓（监控 + 定时 GC 生效，13 分钟战局增长后半段近乎平台）

– 退出战局内存回落约 2.6GB（峰值 4.9GB → 稳定 2.3GB）

– 显存峰值 4.9GB / 8GB（60%），余量充足

■ 安全说明

– 客户端为 BepInEx 插件（netstandard2.1），服务端仅改一个配置文件，均可随时删除

– 源码开源：https://github.com/jeanlannce/SPT-MemoryGuard