fps-tune git:20260913.5f7b787A

Immutable. This exact content never changes and is served at /api/v1/blob/0f4e18df18aad749.

---
name: fps-tune
description: 三角洲行动（Delta Force）Windows 系统层帧率优化。检测电脑硬件、游戏安装位置与当前系统设置，经用户逐项确认后批量应用可还原的 Windows 层优化（电源计划、HAGS、游戏模式、关闭后台录制、MMCSS、网络限流等），并为对应显卡厂商给出驱动内手动设置清单。所有改动写入前自动备份，支持一键还原。当用户提到"三角洲行动 卡顿 / 掉帧 / 帧数低 / 画面优化 / 帧率优化 / 优化设置"时使用。
---

# 三角洲行动 · 系统层帧率优化（通用 Agent 技能）

本技能与具体 AI 工具无关：任何能在用户 Windows 电脑上执行命令行的助手
（Claude Code、Codex、WorkBuddy、豆包等）按下面的流程操作即可。核心逻辑全部在
`FpsTune.exe`（C# 引擎，无头 CLI 模式）里，你只负责：**检测 → 向用户解释 → 征得确认 → 执行 → 汇报**。
所有系统改动都由确定性引擎完成并自动备份，你的角色是"理解意图、解释取舍、把关确认"，
而不是替引擎决定改什么。

## 前置条件

- Windows 10 / 11。安装包和单文件 `FpsTune.exe` 为自包含发布；便携版需要 .NET 8 Windows Desktop Runtime。
- 部分项（电源计划、HAGS、系统服务等）需要**管理员权限**的终端。
- 程序位置：`<root>\FpsTune.exe`（下文 `<root>` 指仓库/安装目录；本地构建产物在
  `FpsTune.Wpf\bin\Release\net10.0-windows\`）。
- 带命令行参数时进入无头 CLI 模式：不弹 GUI 窗口、结果输出到 stdout、退出码 0/1。
- 不要在未获得程序的机器上凭空执行；用户没有程序时，引导其从 Releases 下载或先构建。

## 流程

### 第 1 步：检测（只读，安全）

```
& "<root>\FpsTune.exe" -Detect -Json
```

返回 JSON：
- `hardware`：CPU / 内存 / 显卡（含厂商）/ 系统版本 / 是否笔记本 / 是否管理员
- `gamePath`：自动找到的游戏主程序（卸载注册表 → 常见盘符兜底；不读取运行中进程路径；找不到为 null）
- `items`：每个优化项的 id、说明、副作用、是否需要管理员、当前是否已达标
- `checks`：只读体检结果（VC++ 运行库、内存频率、PCIe 链路、显示器刷新率、颜色配置、DirectStorage、音频独占模式），只报告不修改

### 第 2 步：向用户汇报并确认

用平实的语言告诉用户：检测到什么硬件、游戏装在哪、哪些项已达标、哪些项建议优化、
每项干什么、有什么副作用。**必须先获得用户明确同意才能进入第 3 步**——这是改系统设置。

需要如实告知的注意点：

- 需要管理员的项，当前会话不是管理员时会失败并明确报错——此时请用户用管理员身份重开终端。
- `fso-off` / `gpu-pref` / `game-priority` 依赖找到游戏主程序；找不到时这三项自动跳过，
  可让用户提供游戏安装位置后用 `-Game "主程序完整路径"` 补上。
- `wsearch-off`（禁用搜索索引）会让系统搜索明显变慢；`hibernate-off`（关休眠）会顺带
  关掉快速启动，笔记本合盖只剩睡眠——这两项默认不勾选，勾选前务必说明。
- `power-tuning` 会改电源隐藏参数（关闭 USB3 链路省电、处理器性能提升模式设为激进），
  个别主板/笔记本厂商策略下可能引起异常（极少见）；出现异常用还原命令恢复即可。
- 纯检测项（`checks`）查出问题时是"体检立功"而不是工具失败，转述时区分开：
  - VC++ 缺失：只报"哪个架构缺失"，给微软官方链接（aka.ms/vs/18/release/vc_redist.x64.exe
    与 .x86.exe）。x64 与 x86 是两套独立运行库，**版本不同步通常无害**，不要引导用户
    卸载重装其他年份的 VC++；缺失时覆盖安装即可，装完重启再检测。
  - 内存频率：当前运行频率与 BIOS 配置频率不一致时，提示进 BIOS 查 XMP/A-XMP/EXPO/DOCP
    （菜单名因主板品牌和 CPU 平台而异）；菜单不存在说明厂商未开放，不强求。
  - PCIe 链路：仅 NVIDIA 卡自动读取；当前 Gen 低于上限时提示检查插槽/延长线。
- **不要建议关闭引导虚拟化**：ACE 反作弊会检查虚拟化状态，关掉会导致游戏报错进不去。

### 第 3 步：应用（必须已获用户同意）

```
& "<root>\FpsTune.exe" -Apply -Preset balanced -Json
```

- 默认套用预设：`-Preset balanced`（27 项，副作用小；不含会改变键鼠手感的
  keyboard-latency / keyboard-repeat，鼠标加速关闭除外）通常最合适；`full` 含全部
  33 项；`safe-only` 只有 5 项当前用户级设置、不需要管理员。
- 也可以逐项：`-Apply -Items power-ultimate,hags,dvr-off -Json`。
- 预设/清单念给用户听，让用户选，不要替用户决定勾哪些。
- **CLI 没有"-Force"之类的同意开关：执行即生效**。征得用户同意的责任完全在你——
  这也是红线第 2 条，没有例外。
- 结果里每项带 `ok` / `changed` / `skipped`，末尾有 `summary`（x 成功、y 失败、z 跳过）。
  `reboot` 数组列出需要重启才完全生效的项，汇报时按它提醒用户重启，别自己猜。
- 每次 Apply 会先把所有原值写入 `%LocalAppData%\FpsTune\backup\backup-<时间戳>.json`，
  结果里有 `backupFile` 路径；转述给用户，告诉他还原就靠这份备份。

### 第 4 步：显卡驱动内设置（手动，念给用户听）

驱动内的 3D 设置无法安全脚本化。根据用户显卡厂商给出手动设置建议，
指导其在 NVIDIA 控制面板 / AMD Adrenalin / Intel Arc 控制面板中手动设置（约 2 分钟）。
清单已按检测到的显卡厂商生成（先确认 `hardware.gpuVendor` 再给对应内容）。

### 自动寻找最佳配置（A/B 调优）

同一台设备、固定场景下，用数据决定哪些优化组合值得保留
（A/B 实验编排由 `FpsTune.exe -Experiment` 进程内完成；应用/还原同样走引擎并自动备份）：

```
# 1) 先采集基线（3 次采样，需游戏在运行、场景固定）
FpsTune.exe -Experiment -Baseline -Json

# 2) 依次测试候选组（每个组约 3 × 90 秒）
FpsTune.exe -Experiment -Test -Group group-1 -Json
FpsTune.exe -Experiment -Test -Group group-2 -Json
FpsTune.exe -Experiment -Test -Group group-3 -Json

# 3) 查看实验结果与 CSV 导出
FpsTune.exe -Experiment -Report -Json
```

规则版决策（非统计推断）：按平均帧率 / 1% low / P99 帧时间 / 卡顿次数对比基线，
有收益保留、无收益**自动还原**。样本不足、游戏退出、失去前台或基线不稳定时不形成结论。

Agent 的职责与红线：

- 向用户解释：采样期间必须**保持同一地图、画质、分辨率与路线**，不要切窗口、改设置、
  开其他占资源的程序；每轮采样脚本会阻塞约 90 秒，不要打断。
- 采样器依赖官方 PresentMon。本机没有时**引导用户自行安装**
  （`winget install Intel.PresentMon.Console` 或官网下载），不要代替用户安装。
- 不要替实验挑选候选组之外的项，**绝不要把显卡伪装等高风险/需重启项加入候选**。
- 基线不稳定（CV > 0.05）时让用户重采，不要强行继续。

### 还原（用户后悔时）

```
# 查看可精确还原的项
& "<root>\FpsTune.exe" -ListRestore -Json

# 还原全部
& "<root>\FpsTune.exe" -Restore -Json

# 只还原某些项
& "<root>\FpsTune.exe" -Restore -Items hags,dvr-off -Json
```

- 还原按备份记录逐项恢复原值（包括"原本不存在"的值会删除而不是写默认值）。
- 已消费的备份会重命名为 `.restored` 保留供审计，不会误删。
- 还原失败会如实报错并指出哪一项，不要假装成功。

## 优化项一览（id 供 -Items 使用）

| id | 作用 | 管理员 | 默认勾选 | 需重启 |
|---|---|---|---|---|
| mouse-accel-off | 关闭鼠标加速 | 否 | 否 | 否 |
| keyboard-latency | 键盘缓冲区扩容 | 是 | 否 | 是 |
| keyboard-repeat | 键盘重复提速 | 否 | 否 | 否 |
| sticky-keys-off | 关闭粘滞键/切换键弹窗 | 否 | 否 | 否 |
| hags | 开启硬件加速 GPU 计划（HAGS） | 是 | 是 | 是 |
| transparency-off | 关闭窗口透明特效 | 否 | 是 | 否 |
| fso-off | 禁用游戏全屏优化 | 否 | 是 | 否 |
| gpu-pref | 游戏强制使用高性能 GPU | 否 | 是 | 否 |
| mpo-off | 禁用 MPO 多平面叠加 | 是 | 是 | 是 |
| gpu-pstate-lock | 禁止显卡动态降频 | 是 | 否 | 是 |
| net-throttling-off | 解除多媒体网络限流 | 是 | 是 | 否 |
| net-nagle-off | 关闭 Nagle 算法(TcpAckFrequency) | 是 | 否 | 是 |
| power-ultimate | 电源计划 → 卓越性能 | 是 | 是 | 否 |
| power-tuning | 电源计划隐藏项调优 | 是 | 是 | 是 |
| usb-power-save-off | 禁用 USB 选择性暂停 | 是 | 否 | 是 |
| game-mode | 开启 Windows 游戏模式 | 否 | 是 | 否 |
| dvr-off | 关闭 Xbox 后台录制 | 否 | 是 | 否 |
| prio-separation | 前台进程调度权重提升 | 是 | 是 | 否 |
| wer-off | 关闭 Windows 错误报告 | 是 | 是 | 否 |
| sys-responsiveness | 系统后台响应保留设为最低 | 是 | 是 | 否 |
| mmcss-games | MMCSS 游戏任务档位拉满 | 是 | 是 | 否 |
| sysmain-off | 禁用 SysMain（预取）服务 | 是 | 否 | 是 |
| wsearch-off | 禁用 Windows Search 索引 | 是 | 否 | 是 |
| hibernate-off | 关闭休眠与快速启动 | 是 | 否 | 是 |
| game-priority | 游戏进程 CPU 优先级提到高 | 是 | 是 | 否 |
| paging-exec | 内核代码常驻内存 | 是 | 是 | 是 |
| mem-compress-off | 关闭内存压缩 | 是 | 否 | 是 |
| dyntick-off | 禁用动态计时器 | 是 | 否 | 是 |
| menu-delay-off | 菜单弹出零延迟 | 否 | 否 | 否 |
| visual-fx-perf | 视觉效果最佳性能 | 否 | 否 | 否 |
| delivery-opt-off | 关闭传递优化 P2P 上传 | 是 | 否 | 否 |
| bg-apps-off | 关闭桌面应用后台运行 | 否 | 否 | 否 |
| telemetry-off | 关闭诊断遥测 | 是 | 否 | 否 |

本工具**没有**以下高风险项，也永远不做：显卡型号伪装、修改游戏目录文件、
注入游戏进程、关闭引导虚拟化、任何与反作弊的交互。

## 红线（任何 agent 都必须遵守）

1. **agent 驱动 CLI 不代表用户同意任何声明。** 免责声明、副作用说明必须由用户
   本人阅读并同意；不得代替用户确认，也不得通过任何方式绕过确认。
2. 未经用户明确同意，不得执行 `-Apply` / `-Restore`。CLI 没有 `-Force` 之类的
   防呆开关，同意与否完全由你把关。
3. 不要绕过程序自己改注册表/电源设置——引擎的备份机制是唯一的还原保障。
4. 不修改游戏安装目录内的任何文件，不注入进程，不与反作弊交互。
5. 执行后如实汇报每项成功/失败/跳过，并告知备份文件位置与还原方法。
6. 不要代替用户下载或运行任何安装包；需要装 VC++ 运行库时只给官方链接让用户自己装。
7. 不承诺固定帧数提升；收益因机器而异，让用户实测对比。