Fps Tune

# FPS 帧律 · 使用者操作流程

本文件面向通过 `FpsTune.exe` 帮用户调校的 AI 助手。开发项目使用本地开发规则。
使用确定性的 C# 引擎执行检测、应用与还原，并向用户汇报实际结果。

## 前置条件

- Windows 10/11 x64，满足 .NET 10 运行条件。安装包自带运行时；便携包需要 .NET 10 Windows Desktop Runtime。
- 从 [官方 Releases](https://github.com/jidekaixin2dian/fps-tune/releases/latest) 取得程序并核对校验值。当前源码候选为 0.2.4-beta，公开版为 0.2.3-beta；使用前读取 `-Version`。
- `<root>` 是程序目录，本地构建通常位于 `FpsTune.Wpf\bin\Release\net10.0-windows`。
- 带参数进入无头模式，结果输出到 stdout，退出码 0/1。CLI Apply / Restore 执行即生效。
- 项目清单、副作用、权限和预设以引擎 `-Detect -Json` 及 `catalog/catalog.json` 为准，不根据旧文章猜测。

## 检测与审阅

```powershell
& "<root>\FpsTune.exe" -Version
& "<root>\FpsTune.exe" -Detect -Json
& "<root>\FpsTune.exe" -Detect -Game "C:\Games\Game.exe" -Json
```

检测返回 `hardware`、`gamePath`、`items` 与 `checks`。游戏查找使用卸载记录和有界目录扫描；没有识别时使用用户提供的 EXE。
先说明硬件、当前状态、拟改项目及副作用，再按用户已有授权执行。未授权的系统修改需要明确同意；同一范围已获同意后不重复确认。

- 需要管理员时说明并使用用户认可的提权终端，不扩大到整个使用过程。
- `fso-off` / `gpu-pref` / `game-priority` 依赖游戏路径，缺失时跳过。
- `wsearch-off` 影响搜索索引；`hibernate-off` 关闭休眠与快速启动，删除的休眠内容不能恢复。
- 接电 CPU 项、关闭节能项可能增加温度、功耗和风扇噪声；默认未选项不替用户自动勾选。
- 体检中的驱动、内存频率等建议是诊断，不代为安装驱动、改 BIOS 或关闭安全功能。

## 应用与汇报

```powershell
& "<root>\FpsTune.exe" -Apply -Preset balanced -Game "C:\Games\Game.exe" -Json
& "<root>\FpsTune.exe" -Apply -Items game-mode,gpu-pref -Game "C:\Games\Game.exe" -Json
```

`balanced` 为 16 项，`safe-only` 为 4 项无需管理员的设置，`full` 包含全部 40 项；full 包含副作用不同的手动项目，不作为默认推荐。
说明实际选择后执行。结果包含 `operationId`、`backupFile`、逐项 `ok/changed/skipped/stateUncertain` 及重启要求。