一个本地运行的 Blockbench 机械零件与传动组合生成器，包含齿轮、蜗杆蜗轮、皮带、空间传动和三轴转台的参数化建模与 .bbmodel 导出。
需要 Python 3.9 或更新版本。Windows 运行 blockbench_mechanical_parts_generator/start_server.bat；Linux/macOS 运行 sh blockbench_mechanical_parts_generator/start_server.sh。启动器会打开本地页面。零件库和齿形预设保存在 blockbench_mechanical_parts_generator/data/libraries.sqlite3，该运行数据库及备份不进入 Git。
页面中的“刷新生成器”会重新加载磁盘上的前端文件并尝试恢复当前工作区；修改 server.py 后仍需重启本地服务。详细操作说明见 生成器说明。
生成器源码位于 blockbench_mechanical_parts_generator/js/，本地服务位于 server.py，示例导出位于 examples/。test/ 包含 Node、Python 和浏览器回归检查；浏览器检查另需 Playwright。可先在生成器目录运行 node scripts/run-node-tests.cjs 和 python -m unittest discover -s test -p test_library_server.py -v。专用 Node 入口只运行 *.test.js，不会把 test/ 下用于生成样件的辅助脚本当作测试执行。
workspace/ 中只纳入少量经用户提供、测试或文档引用的 Blockbench 参考工程。其他工作工程、CAD 源文件、内部协作计划、原始验证截图和运行日志保留在本地，不属于本次公开源码。部分历史回归脚本仍引用未随仓库发布的工作区文件，不能把完整测试套件视为已通过；运行具体脚本前请核对其夹具路径。
模型用于低多边形设计与传动预览。Blockbench 动画并非加工级接触认证，也不代替游戏运行时的参数化旋转或独立图形客户端验收。