4. Mapa de código e ferramentas do experimento de pôquer MariaGO

Este último texto é um mapa para revisão e reprodução. O experimento inclui um aplicativo desktop C++/Qt e uma implementação no navegador. Eles expõem o mesmo problema em ambientes diferentes, mas nomes parecidos não garantem caminhos ou comportamento numérico idênticos.

No C++/Qt, comece por `model`: features de estado, scores de ação, atualização e persistência formam a política. `game` controla streets, apostas, liquidação do pote e encerramentos como `finishHand`. `card` contém representação do baralho e cálculo de força. `mainwindow` liga interface, entrada e simulação, essencial para saber qual estado uma linha de log representa.

O navegador possui web engine separado. Ele facilita repetições e visualização, mas recompensa, features e aleatoriedade devem ser comparadas diretamente com o nativo. Uma constante alterada de um lado não deve ser presumida no outro.

Snapshots ligam código e observação. Cheolsu, younghee e minsu mostram que ações parecidas podem nascer de preferências diferentes. Cada snapshot é uma amostra de um ponto do treino: preserve arquivo, commit, configuração e semente. Um peso isolado não define a estratégia; acompanhe vetor de features e função de seleção.

A ordem prática é localizar o chip delta no fim da mão, conferir a transformação em `finishHand`, seguir o valor até as atualizações, carregar pesos e comparar scores. Por fim, reproduza condições equivalentes no Qt e no web engine e registre diferenças como variáveis experimentais.

O escopo é importante: a fonte publicada é um diagnostic snapshot da investigação. Ela não afirma que o redesenho de recompensa, treino com oponentes mistos ou crédito melhorado já foram implementados ou corrigiram o comportamento. A proteção anterior é containment, não reparo da causa. Mudanças futuras exigem commit próprio e o mesmo protocolo com sementes.

O mapa permite reavaliar a observação sem exagero. Código, modelos, configuração de reprodução e falhas formam juntos a linha de base.