4. O código-fonte completo e as ferramentas usadas

Objetivo deste post

Publicamos o código-fonte usado no app de cubo 3×3. O código só é carregado quando você abre um arquivo.

Ferramentas usadas

• Qt6 (Core, Gui, Widgets, OpenGL, Network) e OpenGL: o cubo 3D e a tela de importação de fotos
• Busca em duas fases de Kociemba: o código em C do muodov/kociemba incluído do jeito que está. É GPL-2.0.
• Qwen3-VL-8B-Instruct (transformers, MPS no Mac): o servidor de leitura por VLM. Ele se conecta ao app por TCP.

Estrutura de pastas

• src/CubeModel: estado do cubo, giros, classificação de cores
• src/CubeWidget, MainWindow: tela OpenGL e giro com o mouse, botões de embaralhar/anterior/próximo/oráculo
• src/CubePhotoReconstructor: leitura das 54 casas a partir de duas fotos, verificação de regras, correção automática
• src/PhotoImportDialog: importação de fotos, leitura comum e por VLM, o anel de seis cores que aparece ao clicar em uma casa
• src/KociembaSolver, Oracle, BeginnerSolver, MoveSolver: resolução. Usados na ordem Kociemba → busca curta → camada por camada para iniciantes.
• src/TcpCubeVlmClient, vlm_server: cliente e servidor da leitura por VLM
• tools/face_scan_cli.py: ferramenta de linha de comando para conferir as cores uma face por vez
• third_party/ckociemba: código em C do Kociemba

O build é feito com cmake, como descrito no README. Os resultados de build, os ambientes virtuais, os arquivos de tabela do Kociemba (cache) e as fotos de teste não foram incluídos. Os 82 programas de teste ficaram de fora porque os caminhos das fotos de teste estão fixos no código.

Código-fonte completo