Wine no macOS com agente de IA: skill de diagnóstico para app Windows

TL;DR

• O repositório é base de conhecimento e skill para agente de IA diagnosticar e resolver problema de app, jogo ou software Windows no macOS — em qualquer camada de compatibilidade baseada em Wine.
• Cobre CrossOver, Wine puro, Whisky, Kegworks e Wineskin, Bottles e o Game Porting Toolkit da Apple, com o que cada um faz melhor e como o agente alcança cada um.
• Quase todo diagnóstico se reduz a quatro perguntas: qual prefixo o app usa, qual versão do Windows ele emula, quais DLLs e runtimes estão instalados, e se a falha é na instalação, no lançamento ou na execução.
• Traz fluxo, comparação de ferramenta, local de prefixo por ferramenta, depuração com WINEDEBUG, correção por winetricks e base de problema comum.

O que é e para quem

O Wine macOS AI Runner é skill e conjunto de referência para agente de IA — Cursor, Claude Code, Codex, GitHub Copilot, Windsurf e os demais — mais documentação para pessoa.

É para quem tem programa Windows que "deveria funcionar" no Mac e não funciona, e para o agente que precisa ajudar essa pessoa. O enquadramento do README é a parte útil: não é só Wine. O cenário no macOS são seis ferramentas que se sobrepõem, e o trabalho da skill é identificar qual delas a pessoa tem antes de diagnosticar qualquer coisa.

As ferramentas que ele cobre

As quatro perguntas

O README reduz quase todo diagnóstico a quatro:

1. Qual prefixo ou bottle o app está instalado?
2. Qual versão do Windows aquele prefixo emula — 7, 10 ou 11?
3. Quais DLLs e runtimes estão instalados — DirectX, .NET, VCRedist, DXVK?
4. A falha é na instalação, no lançamento ou na execução?

Essa redução é o motivo de a skill ser útil para agente: a primeira pergunta não é "qual flag eu passo para o Wine", é "onde está o prefixo", e agente que chuta sem localizar o prefixo muda configuração no bottle errado.

O README também lista onde ficam os prefixos: bottle do CrossOver em ~/Library/Application Support/CrossOver/Bottles/<BottleName>/, Wine puro em ~/.wine/ ou no padrão novo do Homebrew, Whisky em Bottles/<uuid>/, e wrapper de Kegworks ou Wineskin dentro de /Applications/YourApp.app/Contents/Resources/.

Apple Silicon e Intel

O número de overhead é nota de desempenho, não medição que você assume para um jogo específico.

O que o agente consegue fazer

O README lista as capacidades: identificar qual ferramenta a pessoa tem, localizar o bottle ou prefixo certo, checar receita conhecida no WineHQ AppDB ou na compatibilidade do CrossOver, aplicar a versão do Windows com override de DLL e DXVK ou vkd3d, ler e interpretar log WINEDEBUG com +loaddll,+seh,+module, corrigir DLL ausente por winetricks com d3dx9, vcrun2019, dotnet48 e dxvk, diagnosticar tela preta, crash, áudio e controle, e identificar bloqueio duro como anti-cheat de kernel, DRM não suportado e lacuna de DirectX 12.

A última categoria é a honesta. Anti-cheat de kernel que se recusa a rodar não é problema de DLL, e agente que continua instalando runtime perde a tarde.

O conjunto de documentação

Como usar

O agente carrega o SKILL.md e segue o fluxo: identifica a ferramenta, acha o bottle, checa compatibilidade, lê o log e aplica a correção do common-fixes.md. A pessoa segue a mesma ordem como checklist no README: visão geral das ferramentas, local do prefixo, compatibilidade no WineHQ AppDB ou na lista do CrossOver, guia de depuração e correção comum.

Quando usar, quando não usar

Use quando um app Windows falha no Mac e você quer o diagnóstico na ordem certa, quando não sabe qual das seis ferramentas a máquina tem, ou quando a falha precisa de leitura de log em vez de flag chutada.

Não use esperando garantia: o README é base de conhecimento e fluxo, e a compatibilidade muda a cada versão do Wine, driver de GPU e atualização do macOS. E não use em caso de anti-cheat de kernel como se fosse problema de runtime — o README nomeia anti-cheat como bloqueio duro, não como coisa corrigível.

Sources

1. Wine macOS AI Runner — repositório — propósito, tabela de ferramenta, as quatro perguntas, local de prefixo, notas de Apple Silicon, capacidades e conjunto de documentação citados acima.
2. README.md — entrada da skill, início rápido, conceito central, comandos de depuração.

Página do projeto: Wine macOS AI Runner

O README indica o WineHQ AppDB e a lista de compatibilidade do CrossOver como lugares para checar receita conhecida. O repositório tem licença MIT.

FAQ

A skill substitui o Wine? Não. É base de conhecimento e fluxo para diagnosticar software Windows no macOS em camada de compatibilidade baseada em Wine.

Quais ferramentas ela cobre? CrossOver, Wine puro, Whisky, Kegworks e Wineskin, Bottles, e o Game Porting Toolkit.

Onde ficam os prefixos? Cada ferramenta tem local próprio, documentado no README: bottle do CrossOver e do Whisky em Application Support, Wine puro na pasta home, e wrapper dentro do bundle .app.

O que é bloqueio duro? Anti-cheat de kernel, DRM não suportado e lacuna de DirectX 12, que o README lista como bloqueio e não como problema de DLL corrigível.