convez.ai
SkillDevOps & InfraestruturaAvançado
icoe44

Game Doctor

icoe44/game-doctor

Diagnóstico científico de travamentos de jogo, não gambiarra genérica

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta 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-doctor

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
0

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.ps1PresentMon 逐帧 → 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+":

  1. 监控:CPU 总占用 8%、GPU 7%、网络 0 丢包——资源全有富余,排除"算力不够"。
  2. 逐核:sguard64(腾讯 ACE 反作弊)独占一个核心 72%——疑似元凶。
  3. 但提了游戏优先级后团战照样掉到 27fps——用数据排除了反作弊是主因(不是瞎调)。
  4. 逐帧:每个最差帧 GPU 只画了 1ms、帧却 30+ms,100% CPU-bound——锁定 CPU 单线程瓶颈。
  5. 降 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 单独下载。

Ver o original no GitHub

Bom para

Relacionados