这是什么#
根据公开仓库 README 整理：面向初学者和儿童的魔方教学工具，可通过摄像头识别贴纸并分步引导还原，支持浏览器和 macOS、Windows、Linux 原生应用。
- 代码仓库：https://github.com/xiaolai/cubus
- 3 人收藏 · 主要用 JavaScript 写成
最新版本#
v0.5.2 · 发布于 2026-09-17
最近的改动#
新增功能
- walk：让魔方页面接收并处理停止驱动的通知
- walk：统一由一个生成工具把已确认的行走流程转换成脚本
- script-drive：补齐此前阻碍 6.5 推进的三项能力，并加入第四阶段的标准对照样例
- renderer：让标记不依赖颜色也能辨认，给字母加上底板，并让每个转动层单独显示一条线
- renderer：playTo — 支持将演示推进到任意指定指令，并解决此前三项尚未彻底处理的问题
修复问题
- test：点击骰子的整套测试会等待求解程序完成，不再凭估计决定等待多久
- ci：最后一层的全面检查改为使用所有处理器核心，不再只用一个
- gan-driver：连接魔方的过程中显示提示信息
- gan-driver：名称中带有 GAN 的蓝牙设备只是候选，不能直接认定为目标魔方
- test：图片中的文字由系统绘制时，不应把这张图片固定为测试比对的标准
- ci：完整检查中的浏览器任务和后台并行任务分阶段运行
- 修复点击操作结束后加载仍可能报错、且错误无人处理的问题，并合并四处重复规则
- 再修复十项问题，包括同一次查找可能给出两种结果、遍历可能一个对象也没检查，以及读取过的所有数据包一直占用内存
- 处理检查清单中尚未解决的十六项问题，包括操作完成后才检查是否合规，以及四张表的结构被重复定义
- script：修复第三轮复查发现的问题，包括停止时检查了错误的条件，以及视图只能显示下一步转动
- 再修复七项问题，包括演示跳过讲解、未设置时长的步骤同时转动，以及演示失败后上一个魔方仍留在屏幕上
- lessons：让每段教学的重点在对应提示出现时才确定，并合并三处重复内容
- 修复第二轮复查发现的问题及另外两项问题，包括一次点击误进入下一段演示、一组关联对象导致场景无法释放，以及时间安排前后矛盾
- script：再修复第二轮检查发现的七项问题，包括检查时丢失当前位置、计时方式有误、演示动作突然跳变，以及三处未清理的残留内容
- renderer：修复第二轮检查发现的五项问题，包括过早确定突出显示的对象、同一段演示有两个起点、魔方移除后收尾动画仍在继续，以及两处内存未释放
- rounds：修复复查发现的问题，让沿用的参数仍被正确识别，并让揭示步骤保留所有指明位置的提示
- 修复首轮检查发现的十二项问题，并为每项问题加入测试，确保遗漏修复时能被发现
内部调整
其他改动
改动标题译自作者提交代码时写的英文原文，点击可查看原文。