S.T.A.L.K.E.R. 2 优化器 AND ReShade 管理器

ZoneTune — STALKER 2 智能优化器

[GitHub 仓库](https://github.com/Hurricane190/S.T.A.L.K.E.R.-2-Smart-Optimizer-ReShade-Installer) · [最新版本](https://github.com/Hurricane190/S.T.A.L.K.E.R.-2-Smart-Optimizer-ReShade-Installer/releases/latest)

一款仅本地运行的 Windows 桌面工具，适用于 **S.T.A.L.K.E.R. 2: Heart of Chornobyl**，可检测电脑与游戏、诊断性能问题、生成可逆的配置包，并通过备份管理 ReShade 预设。

自动扫描硬件并推荐合适的设置。包含 ReShade 管理器，提供推荐构建以及 Potato / Medium / High 模式。

> **诚实为先：** ZoneTune 不承诺提升 FPS。在您使用 PresentMon 完成前后对比测量之前，每项效果都标注为估算值。“结构验证”意味着预设已成功解析且其着色器文件存在——**并不**表示它已通过视觉测试。


## 功能

| 领域 | 能力 |
|---|---|
| **仪表板** | 硬件/游戏/ReShade 概览、可选的问题卡片、基于证据的发现、一键推荐配置 |
| **优化** | 为 Loud PC / Low FPS / Stuttering 构建方案，显示当前 → 建议值及证据，仅应用勾选的更改（备份后），导出 ZIP 包 |
| **推荐游戏内设置** | 根据 GPU 等级、VRAM 和分辨率推导平衡配置，预览所有更改，并可通过一个 **Apply** 按钮应用到 `GameUserSettings.ini` |
| **ReShade 管理器** | 检测 GPU/分辨率/HDR/ReShade 状态，列出内置 + 第三方 + 公共 GitHub 预设，验证着色器存在性，预览并比较，安装 ReShade 6.8 + 仅所需着色器 + 预设，卸载/恢复 |
| **预设工作室** | 构建您自己的 **Potato / Medium / High** 预设，切换每个效果和强度，前后预览，保存/导出，一键安装和撤销 |
| **已安装模组** | 清点 pak 模组、UE4SS Lua 模组、ASI 插件、配置覆盖、Vortex/加载顺序元数据和冲突日志；启用/禁用是可逆的移动操作 |
| **设置与备份** | 手动游戏路径、备份根目录、保留策略、网络策略、日志访问、恢复/删除更改集 |
| **诊断报告** | HTML/Markdown/JSON 报告、PresentMon CSV 导入、前后对比、帧时间统计 |

## 安全模型

- **从不删除模组。** 禁用会将文件移动到 `~mods.disabled`；启用会将其移回。
- **每次写入前备份。** 每次应用/安装都会创建一个带时间戳的更改集，包含原始字节和 SHA-256 哈希。恢复操作也会快照当前状态，因此恢复本身也是可逆的。
- **无备份绝不覆盖。** 预设、`ReShade.ini`、代理 DLL、`GameUserSettings.ini` 和 `Engine.ini` 都会先记录。
- **应用/安装前必须关闭游戏**（游戏退出时会重写 `GameUserSettings.ini` 并锁定 DLL）。
- **无遥测、无云同步、无账户。** 数据保留在 `%LOCALAPPDATA%\ZoneTune`。
- **网络使用白名单。** 仅 HTTPS；主机限于 `reshade.me` 和 GitHub。ReShade 安装程序在执行前会同时校验公布的 SHA-256 **和**官方证书指纹。
- **第三方预设仅链接，不重新打包。** Nexus Mods 预设会打开作者页面；自动安装仅针对 ZoneTune 编写的预设、本地导入或具有明确宽松许可证的 GitHub 仓库提供。

## 如何撤销（设置、预设、ReShade）

每次写入都会在触碰文件前创建一个带时间戳的更改集。要切换回来：

- **仪表板 → Undo last change** — 恢复最近一个未恢复的更改集（设置应用或 ReShade 安装）。
- **设置与备份 → Restore latest change** — 相同操作，下方附有完整更改集列表。
- **设置与备份 → 特定行上的 Restore** — 恢复到该确切时间点。
- **ReShade 管理器 → Uninstall & restore** — 回滚此应用的上次预设/ReShade 安装。
- **ReShade 管理器 → Remove ReShade** — 运行官方卸载程序（保留备份；之后可恢复模块）。
- **预设工作室 → Undo last preset install** — 恢复 Studio 安装前处于活动状态的预设和 `ReShade.ini`。

恢复操作会先快照当前状态，因此撤销本身也可撤销。游戏必须关闭。恢复的配置文件与原始文件字节完全相同（通过 SHA-256 验证）。

## 推荐游戏内设置（扫描 → 建议 → 应用）

扫描后，ZoneTune 会根据以下内容推导配置：

- GPU 等级和 VRAM（例如 RTX 4070 Ti SUPER，16 GB）
- 原生分辨率和刷新率（例如 2560×1440 @ 165 Hz）
- 当前可扩展性组、VSync、动态分辨率、帧率上限
- 当前纹理/流式加载状态

它会为所有 `sg.*` 可扩展性组建议值、低于刷新率的帧率上限、VSync/动态分辨率更改，以及感知 VRAM 的流式加载池。**Apply recommended** 会先打开一个审核表，列出每个当前 → 建议值，并为每个设置提供复选框；只有确认的设置才会写入：

```
%LOCALAPPDATA%\Stalker2\Saved\Config\Windows\GameUserSettings.ini
%LOCALAPPDATA%\Stalker2\Saved\Config\Windows\Engine.ini
```

写入前，它会创建一个更改集；写入后，它会重新读取文件并验证每个值。如果验证失败，它会自动回滚。升频器（DLSS/FSR/XeSS）作为手动游戏内建议呈现，因为 STALKER 2 的菜单选择无法通过配置安全写入。

该配置是**平衡的起点**，而非经过测量的保证。可根据喜好降低上限或调整单个组；使用设置与备份进行恢复。


## ReShade 管理器详情

- **检测：** 活动代理 DLL、来自文件/日志的 ReShade 版本、附加组件构建、预设路径、技术、缺失的着色器、重复的着色器名称、效果错误/警告、其他代理 DLL、HDR 冲突。
- **硬件：** GPU、VRAM、主分辨率/刷新率、HDR 支持/启用状态、每颜色通道位数（Windows DisplayConfig）。
- **目录筛选：** *所有性能等级*、**高性能 · 低细节**、**平衡**、**超高细节 · 高开销**、内置、作者页面、直接下载。
- **预设：** 三个 ZoneTune 编写的预设（Performance / Atmosphere / Cinematic）、十个带有真实源链接的精选 Nexus Mods 条目、实时 GitHub 搜索（仅限宽松许可的仓库）以及本地导入。
- **预览：** 合成的、清晰标注的颜色预览（非游戏截图）、前后对比、与其他预设的比较、技术/着色器验证、要求、许可证、开销估算。
- **安装：** 官方签名的 ReShade 安装程序（无头 DXGI）、仅从官方 crosire/reshade-shaders 仓库获取所需的 `.fx`/`.fxh` 文件、预设写入 `Stalker2-Win64-Shipping.exe` 旁边、更新 `ReShade.ini`，然后进行结构验证。
- **移除：** 官方无头卸载程序，并备份代理/配置/预设。**Uninstall & restore** 会恢复确切先前状态，包括 ZoneTune 创建的文件。


### 预设工作室（构建您自己的）

**预设工作室**基于三个硬件感知基线创建预设：

| 模式 | 适用于 | 效果栈 | 估算 |
|---|---|---|---|
| **Potato** | 低端 GPU / 1080p | 色阶、饱和度、去色带、轻度锐化 | 1440p 下 < 0.5% |
| **Medium** | 中端 GPU / 1440p | 增加胶片曲线 | 1440p 下 1–2% |
| **High** | 有余量较好的 GPU | 增加泛光 | 1440p 下 2–4% |

每个效果均可切换，颜色/锐化/胶片/泛光强度均可调整。应用会根据 GPU 等级、VRAM 和分辨率推荐模式；超出所选预算的效果会被标记。预览是合成的前后对比；保存/导出写入标准 `.ini`，安装使用相同的签名 ReShade + 官方着色器管线，**Undo last preset install** 会恢复之前的预设和 `ReShade.ini`。


### 兼容性说明

| 徽章 | 含义 |
|---|---|
| **着色器存在** | 预设已成功解析，且所有引用的着色器在本机存在。这是语法层面，而非视觉结果。 |
| **着色器缺失** | 至少一个引用的着色器文件缺失；预设可能部分加载。 |
| **未验证来源** | 作者页面预设；内容未被下载或测试。 |
| **估算** | 开销/兼容性根据作者数据或硬件等级推断；并非在此测量。 |

## 测量（声明所必需）

1. 安装 [PresentMon](https://github.com/GameTechDev/PresentMon) 或 CapFrameX。
2. 在着色器预热后，对同一存档/路线捕获 60+ 秒。
3. 更改一项内容（配置、预设、升频器）。
4. 在相同设置下再次捕获。
5. 在**诊断报告**中导入两个 CSV。

ZoneTune 报告平均 FPS、1% / 0.1% 低帧、中位/p95/p99 帧时间、卡顿指数（`p99/median − 1`）和帧时间图表。它从不添加“已验证 FPS 提升”徽章。

## 要求

- Windows 10/11 x64
- STALKER 2（Steam 或 Xbox/MSIX 布局；支持手动选择文件夹）
- 自包含构建：无需安装 .NET
- 可选：ReShade/着色器/公共搜索的网络访问；预设功能需要 ReShade 5.0+

## 快速开始

1. 运行 `ZoneTune.exe`。
2. 它会自动扫描。如果检测失败，打开 **设置与备份 → 游戏文件夹 → 浏览**。
3. 在仪表板上使用 **Apply recommended settings**，或打开 **优化** 选择特定问题并查看详细方案。
4. 应用前关闭游戏。当 `Stalker2-Win64-Shipping.exe` 正在运行时，应用会拒绝写入。
5. 如需后处理，打开 **ReShade 管理器**，预览预设，然后安装。
6. 如果感觉任何不妥，从 **设置与备份** 恢复相关更改集。

## 安装 / 构建

用户请参阅 [INSTALL.md](INSTALL.md)，开发者请参阅 [BUILD.md](BUILD.md)。

```powershell
# Release build
.\build.ps1
# -> dist\ZoneTune.exe, dist\zonetune-cli.exe and documentation
```

## 测试证据

发布的构建在以下环境中开发和测试：

- AMD Ryzen 5 7600X、32 GB RAM、NVIDIA RTX 4070 Ti SUPER 16 GB、Windows 11 26H2、2560×1440 @ 165 Hz
- 真实的 STALKER 2 Steam 安装，包含 147 个模组组件、ReShade 6.8、UE4SS、ASI 插件和 Vortex 元数据
- 42/42 核心自测（`zonetune-cli --selftest`）
- 沙盒中的 ReShade 端到端：下载 → 哈希/签名验证 → 无头安装 → 着色器提取 → 预设安装 → 结构验证 → 官方卸载 → 恢复 → 回滚（通过）
- UI 冒烟测试：所有七个标签页加载、预览窗口渲染、无未处理的调度器异常

自测覆盖包括：INI 往返、硬件/游戏/配置/模组/ReShade 检测、预设解析/验证、方案生成、沙盒中的推荐配置应用 + 回滚、可逆模组禁用/启用、预设工作室模式/回退生成、包结构和合并值、备份哈希精确恢复、PresentMon 统计、报告导出，以及官方着色器/ReShade 验证。单独的实机应用测试会将推荐配置写入活动配置，验证每个值，恢复它，并确认原始文件字节完全相同。

详细证据：[docs/TEST_RESULTS.md](docs/TEST_RESULTS.md)。

## 已知限制

- **无视觉验证。** 工具不会在游戏内启动 ReShade 预设；“验证”仅为结构性。
- **有意不提供 Nexus Mods 自动化。** 其 API/分发条款要求作者控制；应用会打开作者页面并接受本地导入。
- **游戏内升频器选择器** 不会通过配置写入；配置改为推荐它。
- **HDR + ReShade** 会被标记，而非自动更改。
- **效果为估算值。** GPU 等级分类是启发式的；帧时间收益取决于场景、驱动和 CPU。
- **Xbox/MSIX 路径** 通过验证/手动选择支持，但主要测试环境是 Steam。
- **无厂商功耗限制自动化。** 降压/功耗限制建议为手动且因 GPU 而异。
- **公共 GitHub 搜索** 只能看到具有宽松许可证的仓库，且可能受到速率限制。

## 隐私

ZoneTune 读取本地硬件、游戏配置、模组名称和日志。报告包含本地路径和硬件详情；分享前请审阅。不会上传任何数据。参见 [ERROR_LOGGING.md](ERROR_LOGGING.md)。

## 许可证 / 致谢

ZoneTune 源代码采用 MIT 许可。ZoneTune 编写的预设采用 CC0-1.0。ReShade 归 © crosire 及贡献者所有（BSD-3-Clause）；着色器文件从官方仓库下载并保留其各自许可证。STALKER 2 和 GSC Game World 是其所有者的商标。本项目与 GSC Game World、crosire、Nexus Mods 或 Intel 无关联。

参见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。