《完整开源魔方项目分类清单（按用途/语言划分，含GitHub地址、核心能力、适用场景）》

完整开源魔方项目分类清单（按用途/语言划分，含GitHub地址、核心能力、适用场景）

一、Web前端3D魔方模拟器（Three.js/TS/JS，在线可玩、可视化）

1. cubing/cubing.js（行业标准魔方库）

• 地址：https://github.com/cubing/cubing.js
• 语言：TypeScript
• 核心：全能扭体谜题底层库，Twizzle、alg.cubing.net底层依赖；支持2~N阶、公式渲染、WCA打乱、求解回放、计时器、自定义谜题（金字塔、五魔方）
• 适用：魔方教学网站、测速平台、公式可视化工具开发
• 协议：GPLv3

2. jingguanzhang/EasyCube 易魔方（国产多阶在线求解）

• 地址：https://github.com/jingguanzhang/EasyCube
• 能力：2~50阶魔方、图片/摄像头识别上色、一键求解、步骤动画、移动端适配
• 演示：https://jingguanzhang.github.io/EasyCube/
• 特点：轻量化，可直接嵌入网页，国内访问流畅

3. bsehovac/the-cube（轻量Three.js 3x3魔方）

• 地址：https://github.com/bsehovac/the-cube
• 技术：Three.js + JS
• 功能：拖拽旋转、随机打乱、基础求解、撤销操作，极简demo适合前端入门

4. cuberverse（专业速拧教学平台）

• 地址：https://github.com/sivab193/cuberverse
• 栈：NextJS + React Three Fiber
• 亮点：60+魔方教学公式可视化、摄像头扫实物魔方、WCA标准测速、最短路径求解

5. rubik（Svelte5轻量化魔方）

• 地址：https://github.com/tiennm99/rubik
• 特性：拖拽交互、计时器、撤销、流畅动画，打包体积极小

二、魔方求解算法核心库（Kociemba二阶段算法，纯逻辑无界面）

Java

1. cs0x7f/min2phase（工业级高速求解）
   • 地址：https://github.com/cs0x7f/min2phase
   • 优势：优化Kociemba，预计算剪枝表，毫秒级出解，嵌入式/后端通用
2. hkociemba/CubeExplorer（Kociemba官方原版）
   • 地址：https://github.com/hkociemba/CubeExplorer
   • Pascal原版移植，算法原始参考实现，适合研究群论原理

Python

1. RubiksCube-TwophaseSolver（纯Python无依赖求解）
   • 轻量二阶段实现，平均19步最优解，支持批量状态求解、服务器部署
2. forestagostinelli/DeepCubeA（AI强化学习求解）
   • 地址：https://github.com/forestagostinelli/DeepCubeA
   • PyTorch深度学习方案，不靠预计算表，适合AI算法研究
3. Nikola-Petrov/magiccube（N阶魔方逻辑模型）
   • 地址：https://github.com/Nikola-Petrov/magiccube
   • 支持任意N阶魔方状态模拟、旋转、状态序列化

C/C++/嵌入式（ESP32/Arduino/机器人首选）

1. Csoki-007/zz-optimal-core
   • 高性能求解内核，支持ZZ/FMC最优解，可移植ESP32、单片机、桌面程序
2. rockcarry/cube（极简C语言3x3求解）
   • 千行以内代码，无第三方依赖，适合MCU嵌入式开发

Rust

V-Wong/CubeSimRS

• 地址：https://github.com/V-Wong/CubeSimRS
• 安全高性能魔方模拟+求解库，跨平台编译，无内存泄漏

三、视觉识别+实物魔方求解（OpenCV摄像头扫魔方）

1. kkoomen/qbr（Python OpenCV摄像头求解）
   • 地址：https://github.com/kkoomen/qbr
   • 功能：单摄像头识别6面颜色、自动生成魔方状态、调用二阶段算法还原，桌面实物工具
2. CubeSolver（Swift iOS AR视觉魔方）
   • 地址：https://github.com/markcoleman/CubeSolver
   • iOS原生，CoreML视觉扫描、SceneKit 3D可视化、AR实时魔方识别

四、硬件魔方机器人开源（舵机机械复原）

1. efrantar/rob-twophase（机器人专用高速求解内核）
   • 地址：https://github.com/efrantar/rob-twophase
   • 针对机械机器人优化，输出最简转动序列，适配舵机动作时序
2. Rubiks_Cube_Solver（树莓派+Arduino机器人全套）
   • Python OpenCV图像识别 + Kociemba求解 + 串口控制舵机，完整硬件教程

五、AI强化学习魔方环境（训练智能体）

1. mgroling/GymRubiksCube
   • OpenAI Gym标准魔方环境，可用于DQN、A*、强化学习训练魔方智能体
2. CubeAI
   • Python魔方训练仿真环境，自定义打乱难度、奖励函数，AI入门实验

六、后端/图片API魔方工具（生成魔方图片）

Cride5/visualcube（PHP魔方图像生成API）

• 地址：https://github.com/Cride5/visualcube
• 能力：URL传参生成1~9阶魔方PNG/GIF，自定义配色、视角，论坛/网站贴图专用API

七、测速/速拧训练工具（WCA标准计时器）

1. cubing/timer（官方测速组件）
   • cubing组织配套测速库，含平均、单次、DNF记录、打乱生成
2. cube-master
   • Web速拧训练工具：打乱生成、计时、成绩统计、公式库

八、跨平台桌面客户端

matyalatte/libui-rubiks-demo

• 轻量libui跨平台桌面魔方，Windows/macOS/Linux单文件可执行，无浏览器依赖

项目选型速查表