4. 全ソースコードと使用したツール

この記事の目的

3×3 キューブアプリに使ったソースコードを公開します。ファイルを開いたときだけコードを読み込みます。

使用したツール

• Qt6(Core、Gui、Widgets、OpenGL、Network)と OpenGL: 3Dキューブ、写真の読み込み画面
• Kociemba の2段階探索: muodov/kociemba の C コードをそのまま入れました。GPL-2.0 です。
• Qwen3-VL-8B-Instruct(transformers、Mac の MPS): VLM スキャンサーバー。アプリと TCP でつながります。

フォルダ構成

• src/CubeModel: キューブの状態、回転、色の分類
• src/CubeWidget、MainWindow: OpenGL の画面とマウスでの回転、シャッフル・前へ・次へ・オラクルのボタン
• src/CubePhotoReconstructor: 写真2枚から54マスの読み取り、ルールの検査、自動補正
• src/PhotoImportDialog: 写真の読み込み、通常・VLM スキャン、マスを押すと出る6色のリング
• 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個は、テスト写真のパスがコードに入っているため除きました。

全ソース