4. El código fuente completo y las herramientas utilizadas

Objetivo de esta entrada

Publicamos el código fuente que usamos para la app del cubo 3×3. El código solo se carga cuando abres un archivo.

Herramientas utilizadas

• Qt6 (Core, Gui, Widgets, OpenGL, Network) y OpenGL: el cubo 3D y la pantalla de importación de fotos
• Búsqueda en dos fases de Kociemba: se incluye tal cual el código en C de muodov/kociemba. Es GPL-2.0.
• Qwen3-VL-8B-Instruct (transformers, MPS de Mac): el servidor de escaneo con VLM. Se conecta a la app por TCP.

Estructura de carpetas

• src/CubeModel: estado del cubo, giros y clasificación de colores
• src/CubeWidget, MainWindow: pantalla OpenGL y giro con el ratón, botones de mezclar, anterior, siguiente y oráculo
• src/CubePhotoReconstructor: lectura de las 54 casillas a partir de dos fotos, comprobación de reglas y corrección automática
• src/PhotoImportDialog: importación de fotos, escaneo normal y con VLM, y el anillo de seis colores que aparece al pulsar una casilla
• src/KociembaSolver, Oracle, BeginnerSolver, MoveSolver: resolución. Se usan en el orden Kociemba → búsqueda corta → método por capas para principiantes.
• src/TcpCubeVlmClient, vlm_server: cliente y servidor del escaneo con VLM
• tools/face_scan_cli.py: herramienta de línea de comandos con la que se comprobaban los colores cara a cara
• third_party/ckociemba: código en C de Kociemba

La compilación se hace con cmake, como indica el README. No se incluyen los resultados de compilación, los entornos virtuales, los archivos de tablas de Kociemba (cache) ni las fotos de prueba. Los 82 programas de prueba se omitieron porque tienen las rutas de las fotos de prueba escritas en el código.

Código fuente completo