Fps Tune

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

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

前置条件

• Windows 10 / 11。安装包为自包含发布（自带 .NET 运行时）；便携版需要 .NET 10 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 使用）

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

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

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