完整开源魔方项目分类清单（按用途/语言划分，含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
- cs0x7f/min2phase（工业级高速求解）
- 地址：https://github.com/cs0x7f/min2phase
- 优势：优化Kociemba，预计算剪枝表，毫秒级出解，嵌入式/后端通用
- hkociemba/CubeExplorer（Kociemba官方原版）
- 地址：https://github.com/hkociemba/CubeExplorer
- Pascal原版移植，算法原始参考实现，适合研究群论原理
Python
- RubiksCube-TwophaseSolver（纯Python无依赖求解）
- 轻量二阶段实现，平均19步最优解，支持批量状态求解、服务器部署
- forestagostinelli/DeepCubeA（AI强化学习求解）
- 地址：https://github.com/forestagostinelli/DeepCubeA
- PyTorch深度学习方案，不靠预计算表，适合AI算法研究
- Nikola-Petrov/magiccube（N阶魔方逻辑模型）
- 地址：https://github.com/Nikola-Petrov/magiccube
- 支持任意N阶魔方状态模拟、旋转、状态序列化
C/C++/嵌入式（ESP32/Arduino/机器人首选）
- Csoki-007/zz-optimal-core
- 高性能求解内核，支持ZZ/FMC最优解，可移植ESP32、单片机、桌面程序
- rockcarry/cube（极简C语言3x3求解）
- 千行以内代码，无第三方依赖，适合MCU嵌入式开发
Rust
V-Wong/CubeSimRS
- 地址：https://github.com/V-Wong/CubeSimRS
- 安全高性能魔方模拟+求解库，跨平台编译，无内存泄漏
三、视觉识别+实物魔方求解（OpenCV摄像头扫魔方）
- kkoomen/qbr（Python OpenCV摄像头求解）
- 地址：https://github.com/kkoomen/qbr
- 功能：单摄像头识别6面颜色、自动生成魔方状态、调用二阶段算法还原，桌面实物工具
- CubeSolver（Swift iOS AR视觉魔方）
- 地址：https://github.com/markcoleman/CubeSolver
- iOS原生，CoreML视觉扫描、SceneKit 3D可视化、AR实时魔方识别
四、硬件魔方机器人开源（舵机机械复原）
- efrantar/rob-twophase（机器人专用高速求解内核）
- 地址：https://github.com/efrantar/rob-twophase
- 针对机械机器人优化，输出最简转动序列，适配舵机动作时序
- Rubiks_Cube_Solver（树莓派+Arduino机器人全套）
- Python OpenCV图像识别 + Kociemba求解 + 串口控制舵机，完整硬件教程
五、AI强化学习魔方环境（训练智能体）
- mgroling/GymRubiksCube
- OpenAI Gym标准魔方环境，可用于DQN、A*、强化学习训练魔方智能体
- CubeAI
- Python魔方训练仿真环境，自定义打乱难度、奖励函数，AI入门实验
六、后端/图片API魔方工具（生成魔方图片）
Cride5/visualcube（PHP魔方图像生成API）
- 地址：https://github.com/Cride5/visualcube
- 能力：URL传参生成1~9阶魔方PNG/GIF，自定义配色、视角，论坛/网站贴图专用API
七、测速/速拧训练工具（WCA标准计时器）
- cubing/timer（官方测速组件）
- cubing组织配套测速库，含平均、单次、DNF记录、打乱生成
- cube-master
- Web速拧训练工具：打乱生成、计时、成绩统计、公式库
八、跨平台桌面客户端
matyalatte/libui-rubiks-demo
- 轻量libui跨平台桌面魔方，Windows/macOS/Linux单文件可执行，无浏览器依赖
项目选型速查表
| 需求场景 | 推荐项目 | 语言 |
|---|---|---|
| 做魔方教学网站/在线3D | cubing.js / EasyCube | TS/JS |
| 后端服务批量求解魔方 | min2phase(Java) / twophase(Python) | Java/Python |
| 单片机/ESP32嵌入式魔方 | zz-optimal-core(C++) | C/C++ |
| 摄像头识别实物魔方 | qbr(Python) | Python+OpenCV |
| 机械魔方机器人 | rob-twophase | C |
| AI深度学习魔方算法 | DeepCubeA / GymRubiksCube | Python(PyTorch) |
| 生成魔方静态图片 | visualcube | PHP |
| iOS手机魔方APP | CubeSolver | Swift |