Game Doctor
icoe44/game-doctor
Diagnóstico científico de travamentos de jogo, não gambiarra genérica
Ver no GitHubFerramenta de diagnóstico data-driven para gargalos e quedas de FPS em jogos Windows. Monitora métricas em tempo real (CPU por núcleo, GPU, rede, WHEA), localiza a raiz do problema com base em assinatura de sintomas, aplica correções reversíveis e conformes (sem tocar em arquivos de anti-cheat), e valida resultados com dados antes/depois.
Instalação
npx convez-ai icoe44/game-doctor1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Investigar quedas de FPS em jogos específicos com dados objetivos
- Diferenciar entre gargalos de CPU, GPU, rede ou hardware (WHEA)
- Aplicar ajustes seguros de prioridade de processo e afinidade de CPU
- Validar efetividade de otimizações com métricas pré/pós-ajuste
Veredito

Skill robusto e bem-arquitetado para quem precisa diagnosticar performance de jogo sem gambiarras. A abordagem cientifica (medir → localizar → ajustar → verificar) é rara e valiosa. Recomendado para usuários técnicos dispostos a investigar profundamente; requer PowerShell e conhecimento de Windows.
README
A tradução para o português deste README ainda está na fila.
game-doctor 🎮🩺
游戏卡顿/掉帧诊断"医生"——先测量、再判断这台机器到底哪出问题、再对症下药、最后用数据验证。 不是"一键优化大礼包",也不是让你"全调低就完事"。
A data-driven game-stutter diagnostician (Windows). It measures, locates the real root cause for your machine, applies compliant & reversible fixes, then verifies with before/after numbers — instead of spraying generic tweaks. Ships as a Claude Code skill; the PowerShell scripts also run standalone.
为什么做这个
满网的"提升 FPS 教程"和闲鱼上的远程调参,卖的都是信息差:一堆通用清单("关后台、更新驱动、全调低"), 碰对了算你走运,碰不对你白忙一场——甚至为错的方向花冤枉钱换硬件。
- "全调低"在 CPU 瓶颈的机器上,降分辨率/纹理纯属白干(GPU 根本没满),画质牺牲了帧一点没涨。
- 如果你其实是 WiFi/网络卡(被误当掉帧),再怎么调画质都没用。
- 如果是反作弊单核争用或 PCIe/WHEA 硬件问题,通用清单根本指不到点子上。
game-doctor 的价值不在"找到一个能用的修法",而在找到对的那个、并排除掉贵的错的,而且用数据证明它真有效。
核心理念
监控(真实指标) → 分析(诊断签名) → 匹配知识库定位根因 → 合规可回滚修复 → 再监控验证 → 自迭代回写知识库
- 看逐核,不只看 CPU 总占用——单核争用是最常被漏掉的元凶。
- 网络分本地 vs 外网——区分"真掉帧"和"网络卡被误判"。
- CPU/GPU 都不饱和还卡 → 上逐帧(PresentMon)——"掉帧"是亚秒级帧时间事件,3 秒平均看不见。
- 绝不碰反作弊文件/内存——只做 Windows 原生的 OS 调度/配置调整,不封号(见
reference/safety.md)。
快速开始
# 1) 安装逐帧工具(可选,但强烈建议)
.\tools\get-presentmon.ps1
# 2) 开打前启动按需会话(自动检测对战、维持反作弊低/游戏高优先级、每局自动抓指标+逐帧)
.\lib\session.ps1 -Start
# 3) 正常游玩……打完后:
.\lib\session.ps1 -Stop # 停掉一切,打印本局报告路径
# 也可以手动单步:
.\lib\monitor.ps1 -DurationSec 120 -Label test # 采集
.\lib\analyze.ps1 -RunDir <上面的目录> # 出诊断签名
.\lib\frametime.ps1 -DurationSec 120 # 团战期间逐帧捕获
.\lib\apply-fix.ps1 -Action Priority -Process sguard64 -Priority BelowNormal -DryRun
作为 Claude Code 技能用时,直接说"打游戏卡/帮我盯着/打完了",由 AI 编排上面的流程并解读数据。
各部件
| 文件 | 作用 |
|---|---|
SKILL.md | 诊断闭环编排(Claude Code 技能入口) |
lib/monitor.ps1 | 通用采集:逐核 CPU、GPU、内存、磁盘、WHEA、网络、进程 |
lib/analyze.ps1 | 原始数据 → signature.json(带可匹配知识库的 findings) |
lib/frametime.ps1 | PresentMon 逐帧 → 1%/0.1% low、卡顿帧、每帧 CPU/GPU 归因 |
lib/apply-fix.ps1 | 合规可回滚修复(优先级/亲和性/电源,-DryRun/-Restore) |
lib/watch.ps1 | 守护:检测对战 + 维持优先级 + 每局自动采集 |
lib/session.ps1 | 按需启停守护(推荐;不常驻) |
lib/install-watch.ps1 | 可选:注册开机自启计划任务 |
knowledge/ | 护城河:症状→根因→合规修复 问题库(通用 + 各游戏) |
profiles/ | 游戏画像(进程名/引擎特性/反作弊/健康基线) |
实战案例(本仓库的第一个病例)
i5-12400F + RTX 5070 + Win11,玩家报"团战掉到 39,平时 100+,这配置该跑 280+":
- 监控:CPU 总占用 8%、GPU 7%、网络 0 丢包——资源全有富余,排除"算力不够"。
- 逐核:
sguard64(腾讯 ACE 反作弊)独占一个核心 72%——疑似元凶。 - 但提了游戏优先级后团战照样掉到 27fps——用数据排除了反作弊是主因(不是瞎调)。
- 逐帧:每个最差帧 GPU 只画了 1ms、帧却 30+ms,100% CPU-bound——锁定 CPU 单线程瓶颈。
- 降 CPU 向画质(阴影/特效/角色品质)后:平均帧 124 → 244,团战掉帧(<40fps)发生率降到 约 1/3。
全程没碰任何游戏/反作弊文件。详见 knowledge/general/cpu-bound-frametime-stutter.md。
安全(反作弊红线)
第一原则,优先于一切优化效果。 只做 Windows 任务管理器同性质的操作:进程优先级、CPU 亲和性、
电源计划、关闭你自己的后台软件、网卡/驱动/游戏内官方设置。绝不修改/读写/注入游戏或反作弊的文件与内存。
为什么这样不封号、红线在哪——见 reference/safety.md。
⚠️ 使用风险自负。本工具不保证适用所有机器/游戏/反作弊;它只做合规系统调整,但请自行判断。
现状与路线
- 已覆盖:通用诊断框架 + 英雄联盟(LOL)首个游戏画像。
- 路线:多游戏通用框架(可插拔画像)、更多游戏画像、知识库持续扩充、
-Watch常驻自动调参打磨。 - 平台:Windows(PowerShell 5.1+)。
欢迎 PR 补充游戏画像和知识库条目。免费,慢慢迭代。
许可
MIT。逐帧依赖 Intel PresentMon(MIT),由 tools/get-presentmon.ps1 单独下载。