4. 完整源代码与使用的工具

本文的目的

公开三阶魔方应用使用的源代码。只有在展开文件时才会加载代码。

使用的工具

• Qt6（Core、Gui、Widgets、OpenGL、Network）和 OpenGL：3D 魔方、照片导入界面
• Kociemba 两阶段搜索：原样放入了 muodov/kociemba 的 C 代码。许可证是 GPL-2.0。
• Qwen3-VL-8B-Instruct（transformers，Mac MPS）：VLM 扫描服务器。通过 TCP 与应用连接。

文件夹结构

• src/CubeModel：魔方状态、旋转、颜色分类
• src/CubeWidget、MainWindow：OpenGL 画面与鼠标旋转，打乱、上一步、下一步、预言机按钮
• src/CubePhotoReconstructor：从两张照片读取 54 格、规则检查、自动校正
• src/PhotoImportDialog：照片导入、普通扫描与 VLM 扫描、点击格子时弹出的六色环
• src/KociembaSolver、Oracle、BeginnerSolver、MoveSolver：求解。按 Kociemba → 短搜索 → 初学者逐层的顺序使用。
• src/TcpCubeVlmClient、vlm_server：VLM 扫描客户端和服务器
• tools/face_scan_cli.py：逐个面确认颜色的命令行工具
• third_party/ckociemba：Kociemba C 代码

按照 README 用 cmake 构建。构建产物、虚拟环境、Kociemba 表文件（cache）和测试照片均未附上。82 个测试程序因为代码中写死了测试照片的路径，所以也去掉了。

完整源代码